API referansı

POST /v1/chat/completions

LLMs Text

POST /v1/chat/completions

Alanları resmi API ile eşleşen OpenAI uyumlu protokol. Şunlar için tasarlanmıştır:

  • Resmi OpenAI SDK'ları (openai-python / openai npm)
  • base_url yapılandırmasını destekleyen herhangi bir OpenAI uyumlu istemci
  • Cursor, Cline ve Continue gibi IDE eklentileri
  • LangChain ve LlamaIndex gibi çerçeveler

Uç nokta

POST https://relay.4aicode.com/v1/chat/completions

İstek

POST /v1/chat/completions HTTP/1.1
Host: relay.4aicode.com
Authorization: Bearer sk-4ai-xxxxxxxxxxxxxxxx
content-type: application/json

{
  "model": "gpt-5.6-terra",
  "stream": true,
  "messages": [
    { "role": "system", "content": "You are helpful." },
    { "role": "user",   "content": "Write fizzbuzz in Go." }
  ]
}

Desteklenen modeller

GPT-6:

ModelEn iyisi
gpt-6-astraYeni nesil amiral gemisi; kısa bağlam giriş $1.50/M ve çıkış $7.50/M (resmi fiyatın %15'i)
gpt-6.1-solKarmaşık kodlama ve uzun süren görevler için GPT-6.1 amiral gemisi; $0.30/M giriş ve $1.50/M çıkış (liste fiyatının %15'i)
gpt-6.1-terraGünlük kodlama ve orta karmaşıklık görevleri için GPT-6.1 dengeli katman; $0.15/M giriş ve $0.75/M çıkış (liste fiyatının %15'i)
gpt-6-solKarmaşık kodlama ve uzun süren görevler için GPT-6 amiral gemisi; $0.30/M giriş ve $1.50/M çıkış (liste fiyatının %15'i)
gpt-6-lunaHızlı günlük görevler için hafif GPT-6 modeli; $0.015/M giriş ve $0.075/M çıkış (liste fiyatının %15'i)

GPT-5 serisi:

ModelEn iyisi
gpt-5.6-solAmiral gemisi model, karmaşık kodlama ve uzun süren görevler için öncelikli; max muhakeme çabasını destekler
gpt-5.6-terraMükemmel fiyat/performans ile dengeli katman
gpt-5.6-lunaHızlı ve uygun fiyatlı; günlük kullanım için yeterli
gpt-5.5Önceki nesil genel amaçlı model
gpt-5.4Genel amaçlı kullanım
gpt-5.4-miniHızlı ve uygun fiyatlı
gpt-5.3-codexKod optimizasyonu

Google Gemini:

ModelEn iyisi
google/gemini-3.1-pro-previewGoogle Gemini Pro önizleme
google/gemini-3-flash-previewGoogle Gemini Flash önizleme
google/gemini-2.5-flashKararlı Google Gemini Flash modeli
google/gemini-2.5-proKararlı Google Gemini Pro modeli

GPT-5.2 ve daha eski modeller üst sağlayıcıda kullanımdan kaldırılmıştır. gpt-4o ve gpt-4 gibi diğer modeller, hata mesajında kullanılabilir modeller listesini içeren bir 400 yanıtıyla reddedilir.

Model kullanılabilirliği üst destek ve servis durumuna bağlıdır. Üst servis bir modelin desteklenmediğini bildirirse relay doğrudan açık bir 400 yanıtı döner.

Yok sayılan parametreler

Aşağıdaki parametreler kabul edilir ancak etkisi yoktur; SDK uyumluluğu için hata üretmez:

  • logit_bias
  • user
  • functions (bunun yerine daha yeni tools kullanın)

Yanıt

Resmi OpenAI yanıt formatıyla eşleşir:

  • choices[].message.content
  • choices[].finish_reason
  • usage (prompt_tokens / completion_tokens / total_tokens)

Akış formatı:

data: {"choices":[{"delta":{"content":"Hello"}}]}
data: {"choices":[{"delta":{"content":", world"}}]}
data: [DONE]

Tam örnekler

Python

from openai import OpenAI

client = OpenAI(
    base_url="https://relay.4aicode.com/v1",
    api_key="sk-4ai-xxxxxxxxxxxxxxxx",
)

resp = client.chat.completions.create(
    model="gpt-5.4",
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "Introduce yourself in one sentence"},
    ],
)
print(resp.choices[0].message.content)

TypeScript

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://relay.4aicode.com/v1",
  apiKey: process.env.OPENAI_API_KEY,
});

const resp = await client.chat.completions.create({
  model: "gpt-5.4-mini",
  messages: [{ role: "user", content: "hi" }],
});
console.log(resp.choices[0].message.content);

Hatalar

HTTPAnlamı
400Geçersiz alan / model izin listesinde değil
401Geçersiz token
403Ekip askıya alınmış
429Hız sınırı veya kota aşıldı
502Üst OpenAI servis kararsızlığı
503Üst servisler geçici olarak kullanılamıyor; Servis soğuma süreleri ve yeniden denemeler

/v1/messages'tan farklar

Boyut/v1/messages/v1/chat/completions
ProtokolAnthropicOpenAI
Kullanılabilir modellerTüm Claude modellerigpt-5* / google/gemini-*
Zorunlu alanlarmax_tokens—
Kullanım alanlarıinput_tokens / output_tokensprompt_tokens / completion_tokens