Alanları resmi API ile eşleşen OpenAI uyumlu protokol. Şunlar için tasarlanmıştır:
- Resmi OpenAI SDK'ları (
openai-python/openainpm) base_urlyapı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:
| Model | En iyisi |
|---|---|
gpt-6-astra | Yeni nesil amiral gemisi; kısa bağlam giriş $1.50/M ve çıkış $7.50/M (resmi fiyatın %15'i) |
gpt-6.1-sol | Karmaşı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-terra | Gü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-sol | Karmaşı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-luna | Hı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:
| Model | En iyisi |
|---|---|
gpt-5.6-sol | Amiral gemisi model, karmaşık kodlama ve uzun süren görevler için öncelikli; max muhakeme çabasını destekler |
gpt-5.6-terra | Mükemmel fiyat/performans ile dengeli katman |
gpt-5.6-luna | Hızlı ve uygun fiyatlı; günlük kullanım için yeterli |
gpt-5.5 | Önceki nesil genel amaçlı model |
gpt-5.4 | Genel amaçlı kullanım |
gpt-5.4-mini | Hızlı ve uygun fiyatlı |
gpt-5.3-codex | Kod optimizasyonu |
Google Gemini:
| Model | En iyisi |
|---|---|
google/gemini-3.1-pro-preview | Google Gemini Pro önizleme |
google/gemini-3-flash-preview | Google Gemini Flash önizleme |
google/gemini-2.5-flash | Kararlı Google Gemini Flash modeli |
google/gemini-2.5-pro | Kararlı 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
400yanıtı döner.
Yok sayılan parametreler
Aşağıdaki parametreler kabul edilir ancak etkisi yoktur; SDK uyumluluğu için hata üretmez:
logit_biasuserfunctions(bunun yerine daha yenitoolskullanın)
Yanıt
Resmi OpenAI yanıt formatıyla eşleşir:
choices[].message.contentchoices[].finish_reasonusage(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
| HTTP | Anlamı |
|---|---|
| 400 | Geçersiz alan / model izin listesinde değil |
| 401 | Geçersiz token |
| 403 | Ekip askıya alınmış |
| 429 | Hı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 |
|---|---|---|
| Protokol | Anthropic | OpenAI |
| Kullanılabilir modeller | Tüm Claude modelleri | gpt-5* / google/gemini-* |
| Zorunlu alanlar | max_tokens | — |
| Kullanım alanları | input_tokens / output_tokens | prompt_tokens / completion_tokens |