Sohbet Tamamlaması Oluştur

İstek Gövdesi

Desteklenen isteğe bağlı parametreler, kabul edilen değerler ve varsayılanlar seçilen modele bağlıdır. Örnekleme, akıl yürütme veya araç seçeneklerini ayarlamadan önce model ayrıntılarını kontrol edin.

modelstringzorunlu

Kullanılacak modelin ID'si. Mevcut seçenekler için Models sayfasına bakın.

messagesarrayzorunlu

Konuşmayı oluşturan mesajların listesi.

Her mesaj nesnesi şunları içerir:

role (string): system, developer, user, assistant, tool, function
content (string | array | null): Mesaj içeriği

tool_calls içeren bir assistant mesajında content atlanabilir veya null olarak ayarlanabilir.

content bir dizi olduğunda, TokenLab uyumlu modeller için yapılandırılmış multimodal blokları destekler:

text: { "type": "text", "text": "..." }
image: { "type": "image_url", "image_url": { "url": "https://..." } }
video: { "type": "video_url", "video_url": { "url": "https://..." } }
audio: { "type": "audio_url", "audio_url": { "url": "https://..." } }

Multimodal girdi için herkese açık https URL’leri kullanın. Desteklenen medya türleri seçilen modele bağlıdır.

temperaturenumber

Örnekleme sıcaklığı. Destek, izin verilen değerler ve varsayılan değer seçilen modele bağlıdır. Modelin varsayılanını kullanmak için bu alanı atlayın.

max_tokensinteger

Üretilecek maksimum token sayısı.

streambooleanvarsayılan: false

Eğer true ise, kısmi mesaj deltaları SSE etkinleri olarak gönderilir.

stream_optionsobject

Akışlama için seçenekler. Token kullanımını akış parçalarında almak için include_usage: true olarak ayarlayın.

top_pnumber

Nucleus örnekleme parametresi. Genellikle bunu veya temperature parametresini değiştirmenizi öneririz, her ikisini birden değil.

frequency_penaltynumber

-2.0 ile 2.0 arasında bir sayı. Pozitif değerler tekrarlanan tokenleri cezalandırır.

presence_penaltynumber

-2.0 ile 2.0 arasında bir sayı. Pozitif değerler metinde zaten bulunan tokenleri cezalandırır.

stopstring | array

Durdurma dizisi veya dizi listesi. Destek ve dizi sayısı sınırı seçilen modele bağlıdır.

toolsarray

Modelin çağırabileceği (function calling) araçların listesi.

tool_choicestring | object

Modelin araçları nasıl kullandığını kontrol eder. Seçenekler: auto, none, required, veya belirli bir araç nesnesi.

parallel_tool_callsboolean

Seçilen model destekliyorsa asistanın aynı turda birden fazla araç çağrısı yapmasına izin verir.

max_completion_tokensinteger

Tamamlama için maksimum token sayısı. max_tokens yerine kullanılabilecek bir alternatif, özellikle yeni akıl yürütme destekli model aileleri için faydalıdır.

reasoning_effortstring

Destekleyen modeller için akıl yürütme çabası. Kabul edilen değerler seçilen modele bağlıdır.

seedinteger

Destekleyen modeller için örnekleme tohumu. Aynı çıktının üretilmesi garanti edilmez.

ninteger

Oluşturulacak tamamlamaların sayısı (1-128).

logprobsboolean

Log olasılıklarının döndürülüp döndürülmeyeceği.

top_logprobsinteger

Döndürülecek en iyi log olasılıklarının sayısı (0-20). logprobs: true gerektirir.

top_kinteger

Destekleyen modeller için Top-K örneklemesi.

response_formatobject

Yanıt biçimi. JSON modu için {"type": "json_object"}, JSON şeması için {"type": "json_schema", "json_schema": {...}} kullanın. Destek seçilen modele bağlıdır.

logit_biasobject

Belirtilen tokenlerin ortaya çıkma olasılığını değiştirin. Token ID'lerini (string olarak) -100 ile 100 arasında bias değerlerine eşleyin.

userstring

Kötüye kullanım izleme için uç kullanıcınızı temsil eden benzersiz bir tanımlayıcı.

Yanıt

idstring

Tamamlamanın benzersiz kimliği.

objectstring

Her zaman chat.completion.

createdinteger

Tamamlamanın oluşturulduğu Unix zaman damgası.

modelstring

Tamamlama için kullanılan model.

choicesarray

Tamamlama seçeneklerinin listesi.

Her seçenek şunları içerir:

index (integer): Seçeneğin indeksi
message (object): Üretilen mesaj
finish_reason (string): Modelin durma nedeni; örneğin stop, length veya tool_calls

usageobject

Token kullanım istatistikleri.

prompt_tokens (integer): Prompta ait tokenlar
completion_tokens (integer): Tamamlamadaki tokenlar
total_tokens (integer): Kullanılan toplam token sayısı

İstek

curl -X POST "https://api.tokenlab.sh/v1/chat/completions" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-terra",
    "messages": [
      {"role": "system", "content": "You are a helpful assistant."},
      {"role": "user", "content": "Hello!"}
    ],
    "max_tokens": 1000
  }'

Multimodal Örneği

{
  "model": "gemini-2.5-pro",
  "messages": [
    {
      "role": "user",
      "content": [
        { "type": "text", "text": "Describe this video briefly." },
        { "type": "video_url", "video_url": { "url": "https://example.com/demo.mp4" } }
      ]
    }
  ],
  "max_tokens": 64
}

Yanıt

Response

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "created": 1706000000,
  "model": "gpt-5.6-terra",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Hello! How can I help you today?"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 20,
    "completion_tokens": 9,
    "total_tokens": 29
  }
}

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"

İstek gövdesi

application/json

model*string

Kullanılacak modelin kimliği (ör. gpt-5.4, claude-sonnet-4-6)

messages*array<>

Konuşmayı oluşturan mesajlar listesi

Öğeler1 <= items

temperature?number

Örnekleme sıcaklığı (0-2)

Aralık0 <= value <= 2

varsayılan1

top_p?number

Çekirdek (nucleus) örnekleme olasılığı

Aralık0 <= value <= 1

varsayılan1

n?integer

Oluşturulacak tamamlanma sayısı

Aralık1 <= value <= 128

varsayılan1

stream?boolean

true ise, bir olay akışı (stream) döndürür

varsayılanfalse

stop?|array<string>

Durdurma dizileri

max_tokens?integer

Oluşturulacak maksimum token sayısı

Aralık1 <= value

max_completion_tokens?integer

Daha yeni akıl yürütme özellikli model aileleri için maksimum tamamlanma token'ı

Aralık1 <= value

presence_penalty?number

Varlık cezası (-2 ila 2)

Aralık-2 <= value <= 2

varsayılan0

frequency_penalty?number

Frekans cezası (-2 ila 2)

Aralık-2 <= value <= 2

varsayılan0

tools?array<>

Modelin çağırabileceği araçlar listesi

functions?array<>

Resmi Chat Completions sözleşmesi tarafından tutulan kullanımdan kaldırılmış işlev tanımları.

function_call?|

Resmi Chat Completions sözleşmesi tarafından tutulan kullanımdan kaldırılmış işlev çağrısı seçimi.

tool_choice?|

Hangi işlevin çağrılacağını kontrol eder

response_format?

Yanıt biçimi belirtimi

seed?integer

Belirleyici üretim için tohum (seed)

user?string

Kötüye kullanım tespiti için son kullanıcı tanımlayıcısı

stream_options?

Kullanım parçası dahil etme gibi akış (streaming) seçenekleri.

parallel_tool_calls?boolean

Modelin paralel araç çağrıları yapıp yapamayacağı.

reasoning_effort?string

Uyumlu model aileleri için akıl yürütme çabası ipucu.

logprobs?boolean

Çıktı token'ları için günlük olasılıkların (logprobs) döndürülüp döndürülmeyeceği.

top_logprobs?integer

logprobs etkinleştirildiğinde her konumda döndürülecek en olası token sayısı.

Aralık0 <= value <= 20

logit_bias?

Token başına logit yanlılık haritası.

modalities?array<string>

Metin veya ses gibi istenen çıktı modaliteleri.

audio?

Ses modalitesi istendiğinde ses çıktısı yapılandırması.

translation_options?

Chat Completions aracılığıyla ses veya video çeviren modeller için dil ayarları.

prediction?

Draft veya spekülatif kod çözmeyi destekleyen modeller için tahmin ipuçları.

service_tier?|

Model tarafından desteklendiği durumlarda hizmet katmanı ipucu.

[key: string]?any

Sohbet Tamamlaması Oluştur

İstek Gövdesi

Yanıt

Multimodal Örneği

Yetkilendirme

Başlıklar

İstek gövdesi

Yanıt

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

Sohbet Tamamlaması Oluştur

İstek GövdesiCopy Anchor Link

YanıtCopy Anchor Link

Multimodal ÖrneğiCopy Anchor Link

YetkilendirmeCopy Anchor Link

BaşlıklarCopy Anchor Link

İstek gövdesiCopy Anchor Link

YanıtCopy Anchor Link

200application/json

400application/json

401application/json

402application/json

429application/json

500application/json

502application/json

503application/json

İstek Gövdesi

Yanıt

Multimodal Örneği

Yetkilendirme

Başlıklar

İstek gövdesi

Yanıt

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`