Responses API

OpenAI Responses API uyumlu /v1/responses ucu

POST /v1/responses, OpenAI Responses API biçimini kabul eder. OpenAI SDK'sında client.responses.create ile çağrılır; Codex CLI da bu ucu kullanır (bkz. Codex CLI). İstek, Chat Completions ile aynı model kataloğu, faturalama ve sınırlardan geçer.

POST /v1/responses

Bir yanıt oluşturur (akışlı ya da akışsız).

Örnek İstek

                Python
                
            

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["ONYSOFT_API_KEY"],
    base_url="https://api.onysoft.com/v1"
)

response = client.responses.create(
    model="openai/gpt-5.3-codex",
    input="Merhaba! Kendini bir cümleyle tanıt.",
    max_output_tokens=2048,
)
print(response.output_text)
            

                cURL
                
curl https://api.onysoft.com/v1/responses \
  -H "Authorization: Bearer $ONYSOFT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "openai/gpt-5.3-codex", "input": "Merhaba!", "max_output_tokens": 2048}'

Desteklenen Özellikler

Alanlar: input (metin ya da öğe dizisi), instructions, max_output_tokens, temperature, top_p, tools, tool_choice, parallel_tool_calls, reasoning.effort, text.format (json_schema ve json_object) ve stream.
Araçlar: function, serbest metin girdili custom araçlar (ör. Codex'in apply_patch aracı) ve namespace grupları.
Barındırılan araçlar (web_search, file_search, code_interpreter, image_generation, computer, mcp, tool_search) hata vermez: istekten çıkarılır, yanıtta X-Onysoft-Warning: ignored_tools=… başlığı döner ve bu araçları hedefleyen tool_choice auto olur.
Yok sayılan alanlar: store, metadata, include, truncation, service_tier, user, prompt_cache_key ve benzerleri.
Model alanı tam katalog kimliğini ya da katalogda tek bir modele uyan öneksiz adı kabul eder; birden çok modele uyan adda hata iletisi adayları listeler. Görsel ya da ses üreten modeller için /v1/chat/completions kullanın.

Yanıtlar Kimlikle Geri Çağrılamaz

Yanıt nesneleri API üzerinden kimlikle geri çağrılamaz (store/retrieve yoktur): GET ve DELETE /v1/responses/{id}, /input_items ve /cancel 404 döner. İsteğin kullanım kaydını GET /v1/usage/{request_id} ile okuyabilirsiniz (resp_<kimlik> yanıtının kaydı req_<kimlik>). previous_response_id, conversation, prompt ve background desteklenmez (400 unsupported_parameter): konuşma geçmişini her istekte input içinde gönderin. Aynı hesabın (proje anahtarlarında aynı anahtarın) önceki yanıtlarındaki öğelere item_reference ile yapılan atıflar, bu isteklerin kullanım kaydından çözülür.

Akış

stream: true ile Responses SSE olayları gelir (response.created, response.output_text.delta, response.function_call_arguments.delta, response.completed …). data: [DONE] satırı yazılmaz; akış response.completed, response.incomplete ya da response.failed olayıyla biter.

Hata Biçimi

Hatalar OpenAI biçimindedir: {"error": {"message", "type", "param", "code"}}; success alanı yoktur. Bakiye ön kontrolü Chat Completions ile aynıdır; max_output_tokens göndermezseniz modelin azami çıktısı esas alınır (bkz. Bakiye ön kontrolü).