# Example index

Examples below are the documented API contracts validated by SOL-47 (`lib/docs/truth-bound/api-examples.ts`).

## Gateway discovery

| Example | Page | Contract |
|---|---|---|
| GET models | [Gateway overview](/docs/gateway/overview), [Gateway quickstart](/docs/gateway/quickstart) | Public 200 JSON |
| GET providers | [Gateway overview](/docs/gateway/overview) | Public 200 JSON, no secrets |

## Gateway invoke

| Example | Page | Contract |
|---|---|---|
| POST chat completions | [Gateway quickstart](/docs/gateway/quickstart), [Quickstart](/docs/get-started/quickstart) | API key required; unauthenticated → JSON 401/403 |
| POST chat completions (stream) | [Gateway quickstart](/docs/gateway/quickstart) | Same fail-closed auth |

## Notes

- Placeholders use `***` for secrets.
- Model id `openai/gpt-4o-mini` is used because it has a current price record in the versioned registry.
- Live upstream success requires configured provider credentials and may incur external provider cost.
- **Payment collection is implemented in code but is not live-certified or production-ready** on Ethen in this release.