Liides
API
Üks OpenAI-ga ühilduv API vorming, mida serveerib /v1 all juhttasand ja mille taga on Sovereign AI. Vorming ühildub, et teie klienditeegid töötaksid muutmata; mudelid, masinad ja operaator kuuluvad Media Holdingule. OpenAI teenuseid ei kasutata.
Otspunktid
Inferentsilüüs nende otspunktide taga on olemas ja mõõdetud (vt Sovereign AI). Avalik, võtmega autenditud kiht on juhttasand: loodud ja testitud isoleeritult, märgitud LOODUD, veel avaldamata.
POST /v1/chat/completions
MõõdetudChat completions OpenAI-ga ühilduvas vormingus; stream: true Server-Sent Events jaoks, stream_options.include_usage kasutuse jaoks viimases tükis; tools ja response_format lähevad läbi. Inferentsilüüsil: mõõdetud 12.10.2026.
POST /v1/completions
EhitatudVananenud tekstigenereerimine klientidele, kes kasutavad veel completions-vormingut.
GET /v1/models
EhitatudTeie projektile saadaolevad mudelid koos vaikimisi aliasega.
GET /v1/models/{id}
EhitatudÜks mudel id või aliase järgi.
GET /v1/usage
EhitatudTeie enda kasutus perioodi kohta — päringud ja tokenite arv mudelite kaupa. Ainult metaandmed; mitte kunagi sisu.
GET /health
EhitatudJuhttasandi elusolek ja inferentsi tausta olek; ilma autentimiseta; ei paljasta kunagi teid ega sisemisi versioone.
Olekusildid — MÕÕDETUD — on olemas ja mõõdeti nimetatud kuupäeval nimetatud meetodiga. EHITATUD — on olemas ja töötab, koormuse all veel mõõtmata. PLAANITUD — kavandatud, veel ehitamata. Sildita rida ei ole selle platvormi väide.
OpenAI-ga ühilduv API vorming. OpenAI teenuseid ei kasutata.
Leping
Autentimine
EhitatudAuthorization: Bearer sk-sov-<prefix>-<secret>. Saladust näidatakse üks kord ja hoitakse ainult võtmega ühesuunalise räsina (HMAC-SHA-256); prefiks identifitseerib võtme kabinetis ja mitte kunagi saladust.
Päringu identifikaatorid
EhitatudIga vastus kannab X-Request-Id; iga vea keha kannab sama id väljas error.request_id. Viidake sellele toepäringutes. Inferentsilüüs kirjutab päringu id juba oma auditireale.
Voogedastus
MõõdetudServer-Sent Events; voog lõpeb data: [DONE]-ga; include_usage korral kannab viimane tükk tokenite arvu. Mõõdetud inferentsilüüsil.
Kasutuse arvestus
Ehitatudprompt_tokens, completion_tokens ja total_tokens loeb kokku taust ja kirjutab mõõtmisregistrisse enne vastuse lõpetamist, nii et arve ei loe kunagi seda, mida te ei saanud.
Sageduslimiidid ja eelarved
Ehitatud429 koos Retry-After-iga, kui sageduslimiit või projekti eelarve on saavutatud. Sageduslimiidi päised (X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset) on plaanitud; nende lõplikud nimed avaldatakse genereeritud spetsifikatsioonis.
Versioonimine
EhitatudBaastee /v1. Muudatus, mis ei ühildu varasemaga, teatatakse vähemalt 30 päeva ette (Teenusetingimused, §5).
Mida ei pakuta
EhitatudEmbeddinguid, pilte, heli, peenhäälestust, assistente, lõimesid ja pakettotspunkte ei pakuta; tundmatu tee vastab 404 masinloetava koodiga.
Vead
Iga viga on üks JSON-kuju koos HTTP-olekuga, mis nimetab selle klassi. Sõnum ei sisalda kunagi URL-e, tokeneid, teid ega ülesvoolu erandite teksti.
| HTTP | error.type | Millal | Retry-After |
|---|---|---|---|
400 | invalid_request_error | Päringu keha või parameetrid on vigased. | ei |
401 | authentication_error | Puuduv, vigase vorminguga, tühistatud või tundmatu API-võti. | ei |
403 | permission_error | Võti kehtib, kuid ei tohi kasutada seda mudelit, projekti ega teed. | ei |
404 | invalid_request_error | Tundmatu mudel või tee; code nimetab selle. | ei |
429 | rate_limit_error · budget_exceeded | Sageduslimiit või projekti eelarve on saavutatud; oodake antud sekundid. | jah |
500 | server_error | Ootamatu tõrge meie poolel; viidake päringu id-le. | ei |
503 | backend_busy · upstream_unavailable | GPU-d hoiab teine töö või inferentsipakkuja on maas. Varuvarianti välise tarnijaga ei eksisteeri. | jah |
{
"error": {
"type": "rate_limit_error",
"code": "requests_per_minute",
"message": "Too many requests for this project. Retry after the number of seconds in Retry-After.",
"request_id": "5b8e2b2e-4a2f-4b7c-9d2e-1f3a4b5c6d7e"
}
}