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.
| Format | Endpoint | Kullanım durumu |
|---|---|---|
| Chat Completions | /v1/chat/completions | OpenAI uyumlu bir sohbet istemcisi kullanıyorsanız veya geniş model uyumluluğu istiyorsanız |
| Responses | /v1/responses | Uygulamanız Responses etkinliklerini, arka plan yanıtlarını veya Responses araçlarını kullanıyorsa |
| Anthropic Messages | /v1/messages | Düşünme (thinking) veya Claude araç kullanımı gibi Claude Messages alanlarına ihtiyacınız varsa |
| Gemini | /v1beta/models/:model:generateContent | Halihazı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.