Embeddings și audio

Embeddings vectoriale, speech-to-text, text-to-speech și tokenurile efemere cerute de WebSocket-ul realtime.

Embeddings și audio urmează formele OpenAI. POST /v1/tokens emite tokenul de scurtă durată pe care un browser trebuie să-l trimită ca ?key= când deschide wss://ai.codai.ro/v1/realtime — o cheie codai_ brută în query string e refuzată (cod de închidere 4401). Vezi ghidul embeddings & audio pentru exemple complete.

Autorizare

bearerAuth

AutorizareBearer <token>

O cheie API codai (prefix codai_). Tokenurile efemere de la POST /v1/tokens sunt acceptate doar de /v1/realtime.

În: header

Parametri header

x-request-id?string

Id de corelare ales de client; e returnat ca x-codai-trace-id și persistat pe rândul de usage.

Lungimelength <= 128

x-codai-session-id?string

Grupează cererile unei conversații pentru chitanțe, stickiness și prompt caching.

Lungimelength <= 128

Corpul cererii

application/json

Definiții TypeScript

Folosește tipul request body în TypeScript.

Body de embeddings compatibil OpenAI. Câmpurile necunoscute sunt acceptate și ignorate.

model?string

Alias sau id concret de model de embedding. Implicit codai-embed (modelul implicit al platformei voyage-code-3).

Implicit"codai-embed"

input*|array<string>

Un string sau un array nevid de string-uri. Array-urile de id-uri de tokeni nu sunt suportate.

dimensions?integer

Limită opțională a dimensionalității de ieșire. Respectată de upstream-urile OpenAI-style, ignorată de celelalte.

Interval1 <= value

user?string

Câmp de tracking OpenAI; logat, niciodată trimis upstream.

encoding_format?"float"

Doar float e suportat; base64 e respins cu 400.

Valoare în

"float"

[key: string]?any

Corpul răspunsului

`application/json`

curl -X POST "https://example.com/v1/embeddings" \  -H "Content-Type: application/json" \  -d '{    "input": "function add(a, b) { return a + b }"  }'

{  "object": "list",  "data": [    {      "object": "embedding",      "index": 0,      "embedding": [        0      ]    }  ],  "model": "voyage-code-3",  "usage": {    "prompt_tokens": 0,    "total_tokens": 0  }}

Autorizare

bearerAuth

AutorizareBearer <token>

O cheie API codai (prefix codai_). Tokenurile efemere de la POST /v1/tokens sunt acceptate doar de /v1/realtime.

În: header

Parametri header

x-request-id?string

Id de corelare ales de client; e returnat ca x-codai-trace-id și persistat pe rândul de usage.

Lungimelength <= 128

x-codai-session-id?string

Grupează cererile unei conversații pentru chitanțe, stickiness și prompt caching.

Lungimelength <= 128

Corpul cererii

multipart/form-data

Definiții TypeScript

Folosește tipul request body în TypeScript.

Câmpuri de formular multipart. Doar câmpurile listate sunt trimise mai departe; orice altceva e ignorat.

file*file

Fișier audio, max 25 MB. Numele original al fișierului e trimis mai departe (audio.webm când lipsește).

Formatbinary

model?string

codai-transcribe, whisper-1 și whisper merg la deployment-ul Whisper; gpt-4o-mini-transcribe la al lui propriu.

Implicit"codai-transcribe"

Valoare în

"codai-transcribe"
"whisper-1"
"whisper"
"gpt-4o-mini-transcribe"

language?string

Indiciu de limbă ISO-639-1, trimis mai departe neschimbat.

prompt?string

Text opțional care ghidează stilul sau ortografia, trimis mai departe neschimbat.

response_format?string

Trimis mai departe neschimbat. Folosește un format JSON (json, verbose_json); text/srt/vtt stric parsarea JSON a gateway-ului.

Implicit"json"

temperature?string

Temperatura de eșantionare ca câmp de formular string (0–1), trimisă mai departe neschimbată.

Corpul răspunsului

`application/json`

curl -X POST "https://example.com/v1/audio/transcriptions" \  -F file="string"

{  "text": "Bună, vreau să programez o întâlnire mâine la zece."}

Autorizare

bearerAuth

AutorizareBearer <token>

O cheie API codai (prefix codai_). Tokenurile efemere de la POST /v1/tokens sunt acceptate doar de /v1/realtime.

În: header

Parametri header

x-request-id?string

Id de corelare ales de client; e returnat ca x-codai-trace-id și persistat pe rândul de usage.

Lungimelength <= 128

x-codai-session-id?string

Grupează cererile unei conversații pentru chitanțe, stickiness și prompt caching.

Lungimelength <= 128

Corpul cererii

application/json

Definiții TypeScript

Folosește tipul request body în TypeScript.

model?string

codai-tts/tts-1/tts = voce neutră; codai-tts-expressive/gpt-4o-mini-tts = familia expresivă care respectă instructions.

Implicit"codai-tts"

Valoare în

"codai-tts"
"tts-1"
"tts"
"codai-tts-expressive"
"gpt-4o-mini-tts"

input*string

Textul de sintetizat. Peste 4096 de caractere e respins cu 400.

Lungime1 <= length <= 4096

voice?string

Numele vocii upstream, nevalidat. Implicit alloy (neutră) sau marin (expresivă). Familia expresivă acceptă și ash, ballad, coral, echo, fable, onyx, nova, sage, shimmer, verse, cedar.

response_format?string

Containerul audio, trimis mai departe fără validare.

Implicit"mp3"

speed?number

Multiplicator de viteză de redare, trimis mai departe când e truthy (deci 0 e ignorat).

instructions?string

Indiciu de stil de rostire (ex. „calm, cald, română scurtă”). Respectat doar de familia expresivă; trunchiat la 1000 de caractere.

Lungimelength <= 1000

Corpul răspunsului

`application/json`

curl -X POST "https://example.com/v1/audio/speech" \  -H "Content-Type: application/json" \  -d '{    "input": "Bună ziua! Cu ce te pot ajuta astăzi?"  }'

"string"

Autorizare

bearerAuth

AutorizareBearer <token>

O cheie API codai (prefix codai_). Tokenurile efemere de la POST /v1/tokens sunt acceptate doar de /v1/realtime.

În: header

Parametri header

x-request-id?string

Id de corelare ales de client; e returnat ca x-codai-trace-id și persistat pe rândul de usage.

Lungimelength <= 128

Corpul cererii

application/json

Definiții TypeScript

Folosește tipul request body în TypeScript.

scope*string

Suprafața la care poate ajunge tokenul. Doar realtime, audio și embeddings sunt acceptate; orice altceva e 400.

Lungime1 <= length <= 32

ttl_seconds?integer

Durata de viață în secunde. Valorile din afara 60–3600 pică validarea.

Interval60 <= value <= 3600

Implicit600

Corpul răspunsului

`application/json`

curl -X POST "https://example.com/v1/tokens" \  -H "Content-Type: application/json" \  -d '{    "scope": "realtime"  }'

{  "token": "codai_eph_v1.eyJraWQiOiIuLi4ifQ.c2lnbmF0dXJl",  "expires_at": "2026-09-23T10:15:00.000Z",  "scope": "realtime"}

200application/json

400application/json

401application/json

402application/json

403application/json

413application/json

429application/json

502application/json

200application/json

400application/json

401application/json

402application/json

403application/json

429application/json

502application/json

200audio/mpeg

400application/json

401application/json

402application/json

403application/json

429application/json

502application/json

200application/json

400application/json

401application/json

402application/json

403application/json

429application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`