English
Türkçe
FrançaisPOST /v1/responses
Agent ve araç kullanan istemciler için giriş biçimidir. İstek mevcut uyumlu sohbet akışına çevrilir, yanıt Responses biçiminde döner.
Parametreler
| Alan | Gerekli | Açıklama |
|---|---|---|
| model | Evet | Model ID. Eksikse 400 döner. |
| input | Evet* | Düz string veya öğe dizisi. Dönüştürülebilir mesaj yoksa 400 döner. |
| instructions | Hayır | System mesajına çevrilir. |
| stream | Hayır | true ise olay akışı döner. |
| reasoning.effort | Hayır | Destekleyen modele iletilir. Geçerli değerler modele göre değişir (ör. bazı modellerde low, medium, high, xhigh, max); desteklenmeyen değer 400 döner. |
| max_output_tokens | Hayır | Çıktı üst sınırı. |
| tools, tool_choice | Hayır | Function ve custom tool tanımları. additional_tools girdileri de toplanır. |
| temperature, top_p, parallel_tool_calls, store, user, service_tier | Hayır | Taşınır. |
| background, previous_response_id | — | Yoksayılır; istek her zaman senkron çalışır. |
input biçimleri
| Biçim | Karşılığı |
|---|---|
| string | Tek user mesajı. |
| message (role + content) | Roller user, assistant, system, developer; bilinmeyen rol user sayılır. |
| input_text / output_text | Metin parçası. |
| input_image | Görsel parçası (modelin görsel desteği gerekir). |
| function_call / custom_tool_call | Assistant araç çağrısı. |
| function_call_output / custom_tool_call_output | Araç sonucu (tool mesajı). |
curl
curl https://api.noxery.net/v1/responses \
-H "Authorization: Bearer $NOXERY_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"deepseek-v4-pro-202606","instructions":"Bir coding agent gibi davran.","input":"Değişen dosyaları listele.","max_output_tokens":1024}'Yapısal çıktı
text.format ile yanıtı JSON şemaya kilitle: {"type": "json_schema", "name": ..., "schema": ..., "strict": true}. Köprü yolunda (native olmayan modeller) şema chat karşılığına çevrilir; json_text en yakın karşılık olan json_object gibi işlenir. Bozuk şema faturalandırmadan önce 400 ile reddedilir.
Yanıt
json
{
"id": "resp_9f2c1a...",
"object": "response",
"created_at": 1758000000,
"model": "deepseek-v4-pro-202606",
"status": "completed",
"output": [
{
"type": "message",
"id": "msg_...",
"role": "assistant",
"content": [{"type": "output_text", "text": "Değişen dosyalar...", "annotations": []}]
}
],
"usage": {"input_tokens": 30, "output_tokens": 120, "total_tokens": 150}
}Araç çağrısı varsa output içinde function_call öğesi döner; akışın devamı için Tool calling sayfasına bak. Yanıt max_output_tokens nedeniyle kesildiyse status incomplete olur. Desteklenmeyen tool tipi sessizce düşürülür; kullanılabilir tool kalmaz ve tool_choice zorunluysa istek 400 ile reddedilir.