POST /v1/chat/completions

Pieprasīt

curl https://api.model-gate.com/v1/chat/completions \
  -H "Authorization: Bearer mg_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "ch-47",
    "messages": [
      {"role": "user", "content": "Explain this API in one sentence."}
    ],
    "stream": false
  }'

The model var būt kanoniskais ID vai iespējots aizstājvārds. Model Gate atrisina aizstājvārdus pirms cenu noteikšanas un nosūta kanonisko ID augšup.

Atbilde

{
  "id": "chatcmpl_example",
  "object": "chat.completion",
  "model": "claude-opus-4.7",
  "choices": [
    {
      "index": 0,
      "message": {"role": "assistant", "content": "Model Gate provides one compatible API for multiple AI models."},
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 14,
    "completion_tokens": 17,
    "total_tokens": 31
  }
}

Straumēšanas pieprasījums

Iestatīt "stream": true. Augšupējie servera nosūtītie notikumi tiek nodoti, nepārrakstot veiksmīgās notikumu slodzes.

Asinhronais pieprasījums

Atbalstītajiem galapunktiem pievienojiet "async": true ar "stream": false. Tūlītēja atbilde ir HTTP 202 un satur request_id un Partner API rezultāta URL.

Kļūdas

Pakalpojumu sniedzēja, kas nav 2xx, statuss, pamatteksts un satura veids tiek nodoti bez izmaiņām. Lokāli ģenerētās validācijas kļūdas izmanto modeļa vārtu kļūdu aploksni.

Statuss	Nozīme	Darbība
400	Nederīgs pieprasījums	Pārbaudiet pieprasījuma pamattekstu un modeļa ID.
401	Nederīga vai iesaldēta atslēga	Pārbaudiet vai pagrieziet API atslēgu.
429	Pārsniegts likmes vai vienlaicības ierobežojums	Cieņa Retry-After un mēģiniet vēlreiz ar atkāpšanos.
5xx	Īslaicīga augšpus vai vārtejas kļūda	Atkārtoti mēģiniet veikt idempotentus pieprasījumus ar eksponenciālu atkāpšanos.