POST /v1/chat/completions

Sol·licitud

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
  }'

El model pot ser un identificador canònic o un àlies habilitat. Model Gate resol els àlies abans del preu i envia l'identificador canònic aigües amunt.

Resposta

{
  "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
  }
}

Sol·licitud de streaming

Set "stream": true. Els esdeveniments enviats pel servidor aigües amunt es transmeten sense reescriure les càrregues útils d'esdeveniments amb èxit.

Sol·licitud asíncrona

Per als punts finals compatibles, afegiu "async": true amb "stream": false. La resposta immediata és HTTP 202 i conté request_id i un URL de resultat Partner API.

Errors

L'estat, el cos i el tipus de contingut del proveïdor no 2xx es transmeten sense canvis. Els errors de validació generats localment utilitzen l'embolcall d'error Model Gate.

Estat	Significat	Acció
400	Sol·licitud no vàlida	Comproveu el cos de la sol·licitud i l'identificador del model.
401	Clau no vàlida o bloquejada	Verifiqueu o gireu la clau de l'API.
429	S'ha superat el límit de tarifa o concurrència	Respecte Retry-After i torna-ho a provar amb backoff.
5xx	Error temporal en aigües amunt o passarel·la	Torneu a provar les sol·licituds idempotents amb retrocés exponencial.