# Gateway (/ro/docs/api/gateway)

Fiecare rută publică a ai.codai.ro, grupată așa cum le grupează codul.

URL de bază `https://ai.codai.ro`, autentificare bearer cu o cheie `codai_`, JSON la intrare și la ieșire (SSE unde e notat). Grupurile de mai jos corespund unu-la-unu fișierelor de rute ale gateway-ului; fiecare pagină montează operațiile grupului său cu un panou „încearcă” live.

| Grup | Ce acoperă |
| --- | --- |
| [Chat & Completions](./chat.mdx) | `POST /v1/chat/completions`, `/v1/messages`, `/v1/responses` — cele trei formate wire |
| [Embeddings & Audio](./embeddings-audio.mdx) | Embeddings, speech-to-text, text-to-speech, tokenuri efemere pentru realtime |
| [Modele](./models.mdx) | `GET /v1/models` |
| [Agenți](./agents.mdx) | Rulări de agent sincrone și asincrone, pași, stream SSE, anulare |
| [Unelte](./tools.mdx) | Căutare web verificată și fetch sigur de pagini |
| [Sarcini](./tasks.mdx) | Sarcini facturate pe rezultat și confirmare |
| [Sesiuni](./sessions.mdx) | Protocolul de sesiuni partajate v2: evenimente, controale, lease, dispatch, stream |
| [Dispozitive](./devices.mdx) | Dispozitivele legate de cont și inbox-ul de dispatch |
| [Host-uri](./hosts.mdx) | Relay-ul de exec telefon → desktop |
| [Organizații & Partajare](./orgs-sharing.mdx) | Share-uri de sesiune, organizații și membri |
| [Cont](./account.mdx) | Cardul contului, consimțăminte, chitanțe, feedback, catalog de modele on-device |
| [Setări](./settings.mdx) | Setări la nivel de cont, comune tuturor dispozitivelor, cu versiuni optimiste |
| [Sănătate](./health.mdx) | Probe neautentificate la rădăcină |

Nu sunt în această referință, intenționat: `/internal/**` (serviciu-la-serviciu, protejat cu secret), `/metrics` (scrape Prometheus, doar din VPC), `/vscode/**` și `/copilot/**` (discovery de configurare pentru editoare, documentat în [ghidul de clienți](../../gateway/clients.mdx)), `/mcp` și `/.well-known/oauth-protected-resource` (plumbing MCP-ca-server) și forma legacy read-only `GET /v1/sessions[/{sessionKey}]` pe care o primesc încă clienții fără header `x-codai-device`. WebSocket-ul realtime `wss://ai.codai.ro/v1/realtime` nu poate fi exprimat în OpenAPI; contractul lui e în [ghidul de streaming](../../gateway/streaming.mdx).