Metin

Yanıt Oluştur

OpenAI Responses API biçimini kullanarak bir yanıt oluşturur

POST
/v1/responses

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

modelstringzorunlu

Kullanılacak modelin kimliği. Mevcut seçenekler için Modeller sayfasına bakın.

inputstring | array

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ği
  • function_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,..." }
instructionsstring

Model için sistem talimatları (sistem mesajına eşdeğerdir).

max_output_tokensinteger

Oluşturulacak maksimum token sayısı.

temperaturenumber

Örnekleme sıcaklığı (sampling temperature). Desteklenen değerler ve varsayılanlar seçilen modele bağlıdır.

toolsarray

Modelin çağırabileceği araçlar. Desteklenen türler ve kombinasyonlar seçilen modele bağlıdır.

streambooleanvarsayılan: false

True ise, bir olay akışı döndürür. Bkz. Akış.

previous_response_idstring

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.

storebooleanvarsayılan: true

Yanı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.

backgroundbooleanvarsayılan: false

Asenkron 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.

tool_choicestring | object

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.

includearray

Seçilen model desteklediğinde döndürülecek ek çıktı bölümleri.

stream_optionsobject

Akış seçenekleri. Seçilen modelin desteklediği durumlarda include_obfuscation iletilir.

truncationstring

Seçilen model desteklediğinde, uzun konuşmalar için kısaltma (truncation) stratejisi.

service_tierstring

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.

promptobject

Yeniden kullanılabilir bir prompt şablonuna ve değişkenlerine referans.

metadataobject

Yanıtla birlikte saklanan özel meta veriler.

textobject

Metin çıktısı ayarları. text.format desteği seçilen modele bağlıdır.

parallel_tool_callsboolean

Seçilen model tarafından desteklendiğinde, paralel olarak birden fazla araç çağrısına izin verilip verilmeyeceği.

top_pnumber

Nucleus örnekleme parametresi (0-1).

reasoningobject

effort dahil akıl yürütme seçenekleri seçilen modele bağlıdır.

Yanıt

idstring

Yanıt için benzersiz tanımlayıcı.

objectstring

Her zaman response.

created_atinteger

Yanıtın oluşturulduğu anın Unix zaman damgası.

statusstring

Yanıt durumu: queued, in_progress, completed, incomplete, failed veya cancelled. HTTP isteği başarılı olsa bile bu alanı kontrol edin.

outputarray

Model tarafından oluşturulan çıktı öğelerinin listesi.

usageobject

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/compact bir konuşmayı sıkıştırır ve bir response.compaction nesnesi döndürür.
  • wss://api.tokenlab.sh/v1/responses WebSocket üzerinden yanıtlar oluşturur. Bkz. Akış.
  • İptal, input-items ve input-tokens uç noktaları şu anda mevcut değildir.

İstek

cURL
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
  }'
Python
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)
JavaScript
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);
Go
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
<?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

Response
{
  "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
AuthorizationBearer <token>

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

X-TokenLab-Delivery-Policy?string

İ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"
Idempotency-Key?string

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.

Uzunluk1 <= length <= 255

İstek gövdesi

application/json

Yanıt

application/json

application/json

application/json

application/json

application/json