Ana içeriğe atla

​
Genel Bakış

TokenLab, istemciyi https://api.tokenlab.sh/v1 adresine yönlendirerek resmi OpenAI SDK’ları ile çalışır. Çoğu yeni proje için varsayılan OpenAI-uyumlu yol olarak Chat Completions tercih edin. Responses API yalnızca açıkça Responses’a özgü davranışa ihtiyaç duyduğunuzda kullanın. Responses’a özgü alanların her model ve yönlendirilen yol arasında tamamen aynı şekilde davranacağı garanti edilmez.
Python, JavaScript ve Go’nun resmi OpenAI SDK’ları vardır. PHP, OpenAI-uyumlu topluluk istemcileri ile iyi çalışır, ancak resmi bir OpenAI SDK’sı değildir.
Tür: Yerel SDKBirincil Yol: OpenAI-uyumlu / Chat CompletionsDestek Güveni: Desteklenen temel yol

​
Kurulum

pip install openai

npm install openai

go get github.com/openai/openai-go/v3
POST /v1/responses yalnızca açıkça Responses’a özgü davranışa ihtiyaç duyduğunuzda kullanın. Bazı yalnızca Responses alanları hala seçilen modele ve yönlendirilen yola bağlı olabilir.

​
İstemciyi Yapılandırma

from openai import OpenAI

client = OpenAI(
    api_key="sk-your-tokenlab-key",
    base_url="https://api.tokenlab.sh/v1",
)

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: 'sk-your-tokenlab-key',
  baseURL: 'https://api.tokenlab.sh/v1',
});

package main

import (
    openai "github.com/openai/openai-go/v3"
    "github.com/openai/openai-go/v3/option"
)

func main() {
    client := openai.NewClient(
        option.WithAPIKey("sk-your-tokenlab-key"),
        option.WithBaseURL("https://api.tokenlab.sh/v1"),
    )

    _ = client
}

​
Önerilen: Chat Completions

response = client.chat.completions.create(
    model="gpt-5.4",
    messages=[{"role": "user", "content": "Explain what TokenLab does in one sentence."}]
)

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

const response = await client.chat.completions.create({
  model: 'gpt-5.4',
  messages: [{ role: 'user', content: 'Explain what TokenLab does in one sentence.' }],
});

console.log(response.choices[0].message.content);

curl https://api.tokenlab.sh/v1/chat/completions \
  -H "Authorization: Bearer sk-your-tokenlab-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4",
    "messages": [
      {"role": "user", "content": "Explain what TokenLab does in one sentence."}
    ]
  }'

​
Gelişmiş: Responses API

Bu yolu yalnızca aracınız veya iş akışınız açıkça OpenAI Responses anlambilimine bağımlıysa kullanın.

​
Responses ile Akış (Streaming)

stream = client.responses.create(
    model="gpt-5.4",
    input="Write a short poem about coding.",
    stream=True,
)

for event in stream:
    if event.type == "response.output_text.delta":
        print(event.delta, end="")

const stream = await client.responses.create({
  model: 'gpt-5.4',
  input: 'Write a short poem about coding.',
  stream: true,
});

for await (const event of stream) {
  if (event.type === 'response.output_text.delta') {
    process.stdout.write(event.delta);
  }
}

​
Araçlar / Fonksiyon Çağırma

response = client.responses.create(
    model="gpt-5.4",
    input="What's the weather in Tokyo?",
    tools=[{
        "type": "function",
        "name": "get_weather",
        "description": "Get weather for a location",
        "parameters": {
            "type": "object",
            "properties": {
                "location": {"type": "string"}
            },
            "required": ["location"]
        }
    }]
)

for item in response.output:
    if item.type == "function_call":
        print(item.name)
        print(item.arguments)

​
Responses ile Görüntü İşleme

response = client.responses.create(
    model="gpt-4o",
    input=[{
        "role": "user",
        "content": [
            {"type": "input_text", "text": "What's in this image?"},
            {"type": "input_image", "image_url": "https://example.com/image.jpg"}
        ]
    }]
)

print(response.output_text)

​
Embeddings

response = client.embeddings.create(
    model="text-embedding-3-small",
    input="Hello world"
)

print(response.data[0].embedding[:5])

​
Chat Completions

Chat Completions, TokenLab için varsayılan OpenAI-uyumlu yoldur: 
response = client.chat.completions.create(
    model="gpt-4o",
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "Hello!"}
    ]
)

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

​
Sorun Giderme

  • Base URL’nin tam olarak https://api.tokenlab.sh/v1 olduğunu doğrulayın
  • Proxy müdahalesi veya özel HTTP istemcisi geçersiz kılmaları olup olmadığını kontrol edin
  • Sağlayıcı davranışını hata ayıklamadan önce SDK sürümünüzün güncel olduğundan emin olun
  • API anahtarınızın sk- ile başladığını kontrol edin
  • Anahtarın TokenLab kontrol panelinde aktif olduğunu doğrulayın
  • SDK’nın Authorization: Bearer ... başlığını gönderdiğini onaylayın
  • responses.create(...) istekleri /v1/responses yoluna gönderir
  • chat.completions.create(...) istekleri /v1/chat/completions yoluna gönderir
  • Açıkça Responses’a özgü davranışa ihtiyaç duymuyorsanız varsayılan olarak Chat Completions kullanın