System One
Decizii tipizate și calibrate de la codai-s1 într-o singură trecere — întrebări de alegere, scor și da/nu.
codai-s1 răspunde la întrebări tipizate despre o state fără să genereze text, de obicei în 80–300 ms. Condiționează acțiunea pe confidence-ul returnat și păstrează-ți propria variantă de rezervă: când modelul nu e disponibil, gateway-ul răspunde 503 s1_unavailable și nu îl înlocuiește cu un model generativ decât dacă ceri asta.
- Batch — trimite
items: [{ id, state }](până la 16) în loc destateca să pui aceleașiquestionsdespre mai multe stări deodată; răspunsul eitems: [{ id, answers }]în ordinea cererii (client.systemOne.batch(...)/client.system_one.batch(...)). timeout_ms— buget de 100–5000 ms pentru acest apel (implicit 1500).fallback: "codai-fast"— accepți explicit un fallback generativ: când codai-s1 e indisponibil, codai-fast răspunde la aceleași întrebări cu aceleași forme de răspuns, iar răspunsul arefallback_used: true(plus header-ulx-codai-s1-fallback). Probabilitățile lui sunt mai puțin calibrate, așa că coboară-ți pragurile sau înregistrează flag-ul.
bearerAuthAutorizareBearer <codai_…>O cheie API codai (prefix codai_). Tokenurile efemere de la POST /v1/tokens sunt acceptate doar de suprafețele media potrivite scope-ului lor (/v1/realtime, /v1/audio/*, /v1/embeddings).
x-request-id?stringId de corelare ales de client; e returnat ca x-codai-trace-id și persistat pe rândul de usage.
length <= 128x-codai-session-id?stringGrupează cererile unei conversații pentru chitanțe, stickiness și prompt caching.
length <= 128application/json- body
Trimite exact unul dintre state (simplu) sau items (batch).
state?||array<unknown>Textul, obiectul JSON sau lista la care se referă întrebările (≤ 64 000 de caractere serializat).
items?array<>Mod batch — aceleași întrebări puse despre starea fiecărui element, în paralel. Id-urile trebuie să fie unice.
1 <= items <= 16questions*1-32 întrebări, fiecare sub un id ales de tine; răspunsurile vin sub aceleași id-uri.
timeout_ms?integerBugetul codai-s1 pentru acest apel, în milisecunde (implicit stabilit de gateway, 1500).
100 <= value <= 5000fallback?stringcodai-fast permite gateway-ului să răspundă cu codai-fast (output structurat) când codai-s1 e indisponibil; răspunsul are atunci fallback_used: true.
"none""none""codai-fast"model?stringAcceptat pentru simetrie; se servește doar codai-s1.
Câte un răspuns tipizat pentru fiecare id de întrebare (answers) sau, la batch, pentru fiecare element și id de întrebare (items).
application/json- response
answers pentru un singur state, items pentru batch.
model*stringcodai-s1, sau codai-fast când a răspuns fallback-ul cerut.
answers?items?array<>Rezultatele batch-ului, în ordinea cererii.
usage*latency_ms*integerfallback_used?booleanPrezent și true doar când codai-s1 era indisponibil și a răspuns fallback-ul codai-fast cerut.
curl -X POST 'https://ai.codai.ro/v1/systemone' \ -H 'Content-Type: application/json' \ -d '{ "questions": { "property1": { "type": "choice", "instructions": "string" }, "property2": { "type": "choice", "instructions": "string" } }}'{ "model": "string", "answers": { "property1": { "type": "choice", "choice": "string", "score": 0, "noul": 0, "confidence": 0, "probabilities": { "property1": 0, "property2": 0 }, "legend": { "property1": "string", "property2": "string" } }, "property2": { "type": "choice", "choice": "string", "score": 0, "noul": 0, "confidence": 0, "probabilities": { "property1": 0, "property2": 0 }, "legend": { "property1": "string", "property2": "string" } } }, "items": [ { "id": "string", "answers": { "property1": { "type": "choice", "choice": "string", "score": 0, "noul": 0, "confidence": 0, "probabilities": { "property1": 0, "property2": 0 }, "legend": { "property1": "string", "property2": "string" } }, "property2": { "type": "choice", "choice": "string", "score": 0, "noul": 0, "confidence": 0, "probabilities": { "property1": 0, "property2": 0 }, "legend": { "property1": "string", "property2": "string" } } } } ], "usage": { "input_tokens": 0, "output_tokens": 0 }, "latency_ms": 0, "fallback_used": true}Ultima actualizare: