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 | POST /v1/chat/completions, /v1/messages, /v1/responses — cele trei formate wire |
| Embeddings & Audio | Embeddings, speech-to-text, text-to-speech, tokenuri efemere pentru realtime |
| Modele | GET /v1/models |
| Agenți | Rulări de agent sincrone și asincrone, pași, stream SSE, anulare |
| Tool-uri | Căutare web verificată și fetch sigur de pagini |
| Task-uri | Task-uri facturate pe rezultat și confirmare |
| Sesiuni | Protocolul de sesiuni partajate v2: evenimente, controale, lease, dispatch, stream |
| Dispozitive | Dispozitivele legate de cont și inbox-ul de dispatch |
| Host-uri | Relay-ul de exec telefon → desktop |
| Organizații & Partajare | Share-uri de sesiune, organizații și membri |
| Cont | Cardul contului, consimțăminte, chitanțe, feedback, catalog de modele on-device |
| Sănătate | 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), /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.