POST /v1/chat/completions

Rica etmek

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 standart bir kimlik veya etkin bir takma ad olabilir. Model Gate, fiyatlandırmadan önce takma adları çözer ve kanonik kimliği yukarıya gönderir.

Cevap

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

Akış isteği

Ayarlamak "stream": true. Yukarı akış Sunucusu Tarafından Gönderilen Olaylar, başarılı olay verileri yeniden yazılmadan aktarılır.

Eşzamansız istek

Desteklenen uç noktalar için şunu ekleyin: "async": true ile "stream": false. Anında yanıt HTTP'dir 202 ve içerir request_id ve Partner API sonuç URL'si.

Hatalar

Sağlayıcının 2xx olmayan durumu, gövdesi ve içerik türü değiştirilmeden aktarılır. Yerel olarak oluşturulan doğrulama hataları, Model Geçidi hata zarfını kullanır.

Durum	Anlam	Aksiyon
400	Geçersiz istek	İstek gövdesini ve model kimliğini kontrol edin.
401	Geçersiz veya donmuş anahtar	API anahtarını doğrulayın veya döndürün.
429	Hız veya eşzamanlılık sınırı aşıldı	Saygı Retry-After ve geri çekilmeyle yeniden deneyin.
5xx	Geçici yukarı akış veya ağ geçidi hatası	Üstel geri çekilmeyle aynı gücü olmayan istekleri yeniden deneyin.