POST /v1/responses

OpenAI'nin yeni nesil "tek tur giriş + akışlı çıkış" API'si; Codex CLI ve daha yeni OpenAI SDK'ları tarafından kullanılır.

Yalnızca /v1/chat/completions veya /v1/messages kullanıyorsanız bu API'yi bilmeniz gerekmez.

Uç nokta

POST https://relay.4aicode.com/v1/responses

chat/completions'tan farklar

İstek

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

{
  "model": "gpt-5.6-terra",
  "input": [
    { "role": "user", "content": "Refactor main.go" }
  ],
  "stream": true
}

Desteklenen modeller

/v1/chat/completions ile aynı: gpt-6-astra, gpt-6-sol, gpt-6.1-sol, gpt-6.1-terra, gpt-6-luna, gpt-5.6-sol, gpt-5.6-terra, gpt-5.6-luna, gpt-5.5, gpt-5.4, gpt-5.4-mini ve gpt-5.3-codex. Model üst sağlayıcıda desteklenmiyorsa relay açık bir 400 yanıtı döner.

Akışlı yanıt

event: response.created
data: {"response": {"id": "resp_...", ...}}

event: response.output_text.delta
data: {"delta": "package main\n"}

event: response.output_text.done
data: {}

event: response.completed
data: {"response": {...}, "usage": {...}}

Akışsız istekler tek bir { response, usage } nesnesi döner.

Function Calling / Tools

tools alanı iletilir; davranış resmi API ile tutarlıdır:

event: response.output_item.added
data: {"item": {"type": "function_call", "name": "...", "arguments": "..."}}

Araç sonuçlarını resmi protokole göre function_call_output olarak gönderin.

Hatalar

Ne zaman kullanılır

• ✅ Codex CLI kullanıyorsanız (resmi olarak bu API'yi kullanır)
• ✅ En son OpenAI Agents SDK'yı kullanıyorsanız
• ❌ Sohbet botu oluşturuyorsanız → /v1/chat/completions kullanın