Temel kılavuzlar

API formatları

Chat Completions, Responses, Messages veya Gemini arasından seçim yapın

Tek bir TokenLab API anahtarı, dört yaygın API formatı ile çalışır. Modele özgü bir özelliğe ihtiyacınız olmadığı sürece uygulamanızın halihazırda kullandığı formatı koruyun.

FormatEndpointKullanım durumu
Chat Completions/v1/chat/completionsOpenAI uyumlu bir sohbet istemcisi kullanıyorsanız veya geniş model uyumluluğu istiyorsanız
Responses/v1/responsesUygulamanız Responses etkinliklerini, arka plan yanıtlarını veya Responses araçlarını kullanıyorsa
Anthropic Messages/v1/messagesDüşünme (thinking) veya Claude araç kullanımı gibi Claude Messages alanlarına ihtiyacınız varsa
Gemini/v1beta/models/:model:generateContentHalihazırda Gemini contents, parts, files, cache veya Gemini araçlarını kullanıyorsanız

Model sayfasındaki veya GET /v1/models/{model} içindeki tokenlab.accepted_request_formats kısmını kontrol edin. Bir model, dört formatın tamamını desteklemek zorunda değildir.

Chat Completions

Chat Completions, mevcut OpenAI uyumlu istemciler ve taşınabilir sohbet özellikleri için en kolay seçimdir.

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["TOKENLAB_API_KEY"],
    base_url="https://api.tokenlab.sh/v1",
)

response = client.chat.completions.create(
    model="gpt-5.6-luna",
    messages=[{"role": "user", "content": "Hello!"}],
)

print(response.choices[0].message.content)

Bu formatı şunlar için kullanın:

  • mevcut OpenAI uyumlu sohbet entegrasyonları
  • standart mesaj geçmişi ve streaming
  • seçilen model tarafından desteklenen fonksiyon çağırma (function calling)

Başka bir API formatına özgü alanların burada çalışacağı garanti edilmez.

Responses

Responses formatını yalnızca seçilen model accepted_request_formats içinde openai_responses listeliyorsa kullanın.

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["TOKENLAB_API_KEY"],
    base_url="https://api.tokenlab.sh/v1",
)

response = client.responses.create(
    model="gpt-5.6-terra",
    input="Explain why the sky is blue in two sentences.",
)

print(response.output_text)

Responses API; oluşturma, geri alma, sıkıştırma, silme, streaming, WebSocket oluşturma ve devam ettirme işlemlerini ve seçilen modelin desteklediği durumlarda arka plan yanıtlarını destekler. Silme işlemi depolanmış bir yanıtı kaldırır; aktif bir yanıtı iptal etmez.

Anthropic Messages

Anthropic SDK'yı, temel URL'ye /v1 eklemeden TokenLab ana bilgisayarı ile kullanın.

import os
from anthropic import Anthropic

client = Anthropic(
    api_key=os.environ["TOKENLAB_API_KEY"],
    base_url="https://api.tokenlab.sh",
)

message = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=512,
    messages=[{"role": "user", "content": "Hello!"}],
)

print(message.content[0].text)

Claude'a özgü istek ve yanıt alanları için Messages formatını seçin. Claude araç çağrılarını, düşünme bloklarını ve prompt-cache alanlarını bu formatta tutun.

Gemini

Gemini istekleri, TokenLab ana bilgisayarını ve Gemini REST yolunu kullanır.

curl "https://api.tokenlab.sh/v1beta/models/gemini-3.6-flash:generateContent" \
  -H "Authorization: Bearer $TOKENLAB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{"parts": [{"text": "Hello!"}]}]
  }'

Uygulamanız halihazırda Gemini içerik parçalarını, fonksiyon tanımlarını, dosyaları, önbelleğe alınmış içeriği veya diğer Gemini alanlarını kullanıyorsa Gemini'yi seçin. Hem lowerCamelCase ProtoJSON isimleri hem de orijinal snake_case proto isimleri kabul edilir; aynı isteğin içinde aynı alanın her iki yazımını da göndermekten kaçının.

Bir konuşmada formatları karıştırmayın

Messages, Responses, Chat Completions ve Gemini; konuşma durumunu ve araç çağrılarını farklı şekillerde temsil eder. Bir konuşma için tek bir format kullanın. Depolanmış geçmişi taşımanız gerekiyorsa, bir sonraki isteği göndermeden önce uygulamanızda dönüştürün ve doğrulayın.

Bilinmeyen alanlar

TokenLab, tanımadığı alanları iletebilir ancak bu, her modelin bunları kabul ettiği anlamına gelmez. Bir özelliğe güvenmek yalnızca seçilen model bunu belgelediğinde ve uygulamanız desteklenmeyen alan hatasını yönettiğinde güvenlidir.

İlgili referanslar

Bu sayfada