Metin
Yanıt Oluştur
OpenAI Responses API biçimini kullanarak bir yanıt oluşturur
Bir modelin accepted_request_formats değeri openai_responses içerdiğinde bu uç noktayı kullanın. İstekler ve yanıtlar Responses API biçimini kullanır ve dönüştürülmez: bu biçimi desteklemeyen bir model burada 400 döndürür, bu nedenle bu modeller için Chat Completions kullanın. İsteğe bağlı alanlar ve desteklenen değerler seçilen modele bağlıdır.
İstek Gövdesi
Kullanılacak modelin kimliği. Mevcut seçenekler için Modeller sayfasına bakın.
Yanıt için girdi. İstek bunun yerine yeniden kullanılabilir bir prompt kullandığında veya previous_response_id ile saklanan bir yanıta devam ettiğinde isteğe bağlıdır.
Her öğe, bir type alanına sahip bir nesnedir. Yaygın türler şunlardır:
message: Rol ve içeriğe sahip bir konuşma mesajıfunction_call: Bir fonksiyon çağırma isteğifunction_call_output: Bir fonksiyon çağrısının çıktısıreasoning: Önceki bir yanıttan gelen düşünme öğesi. Değiştirmeden geri gönderin
Diğer öğe türleri seçilen modele bağlıdır.
Çok modlu (multimodal) girdi için message.content, düz bir dize veya içerik blokları dizisi olabilir. Görüntü destekli modeller için, URL'leri veya Base64 dizelerini doğrudan düz metne gömmek yerine görüntüleri input_image blokları olarak iletin.
Örnek içerik blokları:
{ "type": "input_text", "text": "Describe this image" }{ "type": "input_image", "image_url": "https://example.com/image.jpg" }{ "type": "input_image", "image_url": "data:image/png;base64,..." }
Model için sistem talimatları (sistem mesajına eşdeğerdir).
Oluşturulacak maksimum token sayısı.
Örnekleme sıcaklığı (sampling temperature). Desteklenen değerler ve varsayılanlar seçilen modele bağlıdır.
Modelin çağırabileceği araçlar. Desteklenen türler ve kombinasyonlar seçilen modele bağlıdır.
falseTrue ise, bir olay akışı döndürür. Bkz. Akış.
Konuşmaya devam edilecek önceki bir yanıtın kimliği. Yanıt hesabınıza ait olmalı ve hâlâ saklanıyor olmalıdır; aksi takdirde istek response_not_found koduyla 404 döndürür. Yanıtı üreten modelle devam edin. Yanıtı üreten hizmet geçici olarak kullanılamıyorsa, istek 503 döndürebilir.
trueYanıtın daha sonra alınabilmesi ve previous_response_id için saklanıp saklanmayacağı. false olduğunda TokenLab yanıtı saklamaz ve GET /v1/responses/{id} yanıtı döndüremez.
falseAsenkron yürütme isteğinde bulunun. Destek durumu seçilen modele bağlıdır. Oluşturma çağrısı genellikle queued veya in_progress olan bir status ile hemen döner. status değeri completed, incomplete, failed veya cancelled olana kadar Bir yanıtı alma uç noktasını sorgulayın. Arka plan işleme geçici olarak kullanılamadığında bir arka plan isteği 503 döndürebilir.
auto, none, required gibi araç seçim politikası veya tek bir aracı belirten bir nesne. Desteklenen değerler seçilen modele bağlıdır.
Seçilen model desteklediğinde döndürülecek ek çıktı bölümleri.
Akış seçenekleri. Seçilen modelin desteklediği durumlarda include_obfuscation iletilir.
Seçilen model desteklediğinde, uzun konuşmalar için kısaltma (truncation) stratejisi.
TokenLab, Responses isteklerini standart hizmet katmanında sunar ve faturalandırır. auto ve default kabul edilir. flex veya priority gibi diğer değerler istekten kaldırılır ve istek standart fiyattan faturalandırılır.
Yeniden kullanılabilir bir prompt şablonuna ve değişkenlerine referans.
Yanıtla birlikte saklanan özel meta veriler.
Metin çıktısı ayarları. text.format desteği seçilen modele bağlıdır.
Seçilen model tarafından desteklendiğinde, paralel olarak birden fazla araç çağrısına izin verilip verilmeyeceği.
Nucleus örnekleme parametresi (0-1).
effort dahil akıl yürütme seçenekleri seçilen modele bağlıdır.
Yanıt
Yanıt için benzersiz tanımlayıcı.
Her zaman response.
Yanıtın oluşturulduğu anın Unix zaman damgası.
Yanıt durumu: queued, in_progress, completed, incomplete, failed veya cancelled. HTTP isteği başarılı olsa bile bu alanı kontrol edin.
Model tarafından oluşturulan çıktı öğelerinin listesi.
Token kullanım istatistikleri.
İlgili Uç Noktalar
GET /v1/responses/{id}saklanan bir yanıtı alır.DELETE /v1/responses/{id}saklanan bir yanıtı siler. Oluşturma işlemini iptal etmez.POST /v1/responses/compactbir konuşmayı sıkıştırır ve birresponse.compactionnesnesi döndürür.wss://api.tokenlab.sh/v1/responsesWebSocket üzerinden yanıtlar oluşturur. Bkz. Akış.- İptal, input-items ve input-tokens uç noktaları şu anda mevcut değildir.
İstek
curl -X POST "https://api.tokenlab.sh/v1/responses" \
-H "Authorization: Bearer sk-your-api-key" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.6-terra",
"input": [
{"type": "message", "role": "user", "content": "Hello!"}
],
"max_output_tokens": 1000
}'from openai import OpenAI
client = OpenAI(
api_key="sk-your-api-key",
base_url="https://api.tokenlab.sh/v1"
)
response = client.responses.create(
model="gpt-5.6-terra",
input=[
{"type": "message", "role": "user", "content": "Hello!"}
],
max_output_tokens=1000
)
print(response.output)import OpenAI from 'openai';
const client = new OpenAI({
apiKey: 'sk-your-api-key',
baseURL: 'https://api.tokenlab.sh/v1'
});
const response = await client.responses.create({
model: 'gpt-5.6-terra',
input: [
{ type: 'message', role: 'user', content: 'Hello!' }
],
max_output_tokens: 1000
});
console.log(response.output);package main
import (
"bytes"
"encoding/json"
"fmt"
"net/http"
)
func main() {
payload := map[string]interface{}{
"model": "gpt-5.6-terra",
"input": []map[string]interface{}{
{"type": "message", "role": "user", "content": "Hello!"},
},
"max_output_tokens": 1000,
}
body, _ := json.Marshal(payload)
req, _ := http.NewRequest("POST", "https://api.tokenlab.sh/v1/responses", bytes.NewBuffer(body))
req.Header.Set("Authorization", "Bearer sk-your-api-key")
req.Header.Set("Content-Type", "application/json")
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()
var result map[string]interface{}
json.NewDecoder(resp.Body).Decode(&result)
fmt.Println(result["output"])
}<?php
$ch = curl_init('https://api.tokenlab.sh/v1/responses');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => [
'Content-Type: application/json',
'Authorization: Bearer sk-your-api-key'
],
CURLOPT_POSTFIELDS => json_encode([
'model' => 'gpt-5.6-terra',
'input' => [
['type' => 'message', 'role' => 'user', 'content' => 'Hello!']
],
'max_output_tokens' => 1000
])
]);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);
print_r($data['output']);Vision Girdi Örneği
Görüntüleri message.content içerisine input_image blokları olarak yerleştirerek görüntü destekli modelleri kullanın. image_url değeri genel bir URL ya da Base64 veri URL'si olabilir.
{
"model": "gpt-5.6-terra",
"input": [
{
"type": "message",
"role": "user",
"content": [
{
"type": "input_text",
"text": "Please describe this image."
},
{
"type": "input_image",
"image_url": "https://example.com/demo.jpg"
}
]
}
]
}{
"model": "gpt-5.6-terra",
"input": [
{
"type": "message",
"role": "user",
"content": [
{
"type": "input_text",
"text": "Please describe this image."
},
{
"type": "input_image",
"image_url": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQ..."
}
]
}
]
}Yanıt
{
"id": "resp_abc123",
"object": "response",
"created_at": 1706000000,
"status": "completed",
"model": "gpt-5.6-terra",
"output": [
{
"id": "msg_abc123",
"type": "message",
"status": "completed",
"role": "assistant",
"content": [
{"type": "output_text", "text": "Hello! How can I help you today?", "annotations": []}
]
}
],
"usage": {
"input_tokens": 10,
"output_tokens": 12,
"total_tokens": 22
}
}Hatalar
Hatalar OpenAI tarzı error nesnesini kullanır. Yaygın durumlar: geçersiz bir alan veya Responses biçimini desteklemeyen bir model için 400, geçersiz bir anahtar için 401, yetersiz bakiye için 402, bilinmeyen bir previous_response_id için 404, hız sınırı (rate limit) için 429 ve model isteğe şu anda yanıt veremediğinde 503. Bkz. API hatalarını yönetme.
Yetkilendirme
BearerAuth API Anahtarı kimlik doğrulaması. API anahtarlarını Dashboard > API > API Keys bölümünden oluşturun veya yönetin.
Konum: header
Başlıklar
İstek bazlı Teslimat politikası. API anahtarı ve Çalışma Alanı varsayılanlarını geçersiz kılar. Otomatik olarak önce TokenLab Verified dener ve çıktı, istek kabulü veya kalıcı kaynak oluşturma öncesinde bir kez Official seçeneğine geçiş yapabilir.
Geçerli değerler
- "auto"
- "verified"
- "official"
Aynı isteğin ikinci kez çalışmasını durduran isteğe bağlı anahtar. Her istek için UUID gibi yeni ve benzersiz bir değer gönderin ve zaman aşımı sonrası yeniden denemeler için saklayın. Aynı anahtarla yapılan bir yeniden deneme tekrar çalışmaz: idempotency_replay_unavailable ile 409 döndürür veya gövde değiştiyse genellikle idempotency_conflict döndürür. İstisna: İstemci bağlantısı kesildikten sonra akış olmayan (non-stream) bir sonuç tamamlanırsa, 24 saat içinde aynı anahtar ve gövde ile yapılan bir yeniden deneme, Idempotent-Replayed: true başlığıyla ve ikinci bir ücret alınmadan o sonucu (1 MB'a kadar) döndürür. 255 karakterden uzun bir anahtar yok sayılır ve istek bu durumda idempotency korumasına sahip olmaz. background: true ile, aynı anahtar ve gövdeye sahip bir yeniden deneme, orijinal yanıt nesnesini döndürür ve ikinci bir yanıt oluşturmaz veya ücretlendirmez; farklı bir gövde reddedilir ve durum kodu garanti edilmez. Bkz: Retry safely with an idempotency key.
1 <= length <= 255İstek gövdesi
application/json
Yanıt
application/json
application/json
application/json
application/json
application/json