Native SDKs (nativ)

OpenAI SDK

Verwenden Sie TokenLab mit offiziellen OpenAI-SDKs und OpenAI-kompatiblen Clients

Übersicht

TokenLab funktioniert mit den offiziellen OpenAI-SDKs, indem der Client auf https://api.tokenlab.sh/v1 zeigt.

Bei den meisten neuen Projekten sollten Sie Chat Completions als standardmäßigen OpenAI-kompatiblen Pfad bevorzugen. Verwenden Sie die Responses API nur, wenn Sie explizit Responses-spezifisches Verhalten benötigen.

Responses-spezifische Felder verhalten sich nicht zwangsläufig in jedem Modell und über jeden gerouteten Pfad identisch.

Python, JavaScript und Go haben offizielle OpenAI-SDKs. PHP funktioniert gut mit OpenAI-kompatiblen Community-Clients, ist jedoch kein offizielles OpenAI-SDK.

Typ: Native SDK

Primärer Pfad: OpenAI-kompatibel / Chat Completions

Unterstützungszuverlässigkeit: Unterstützter Kernpfad

Installation

pip install openai

Verwenden Sie POST /v1/responses nur, wenn Sie explizit Responses-spezifisches Verhalten benötigen. Einige nur für Responses bestimmte Felder können weiterhin vom ausgewählten Modell und dem gerouteten Pfad abhängen.

Client konfigurieren

from openai import OpenAI

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

Empfohlen: Chat Completions

response = client.chat.completions.create(
    model="gpt-5.6-terra",
    messages=[{"role": "user", "content": "Reply with: Connected to TokenLab."}]
)

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

Erweitert: Responses API

Verwenden Sie diesen Pfad nur, wenn Ihr Tool oder Workflow ausdrücklich von den OpenAI Responses-Semantiken abhängt.

Streaming mit Responses

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

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

Tools / Funktionsaufrufe

response = client.responses.create(
    model="gpt-5.6-terra",
    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)

Vision mit Responses

response = client.responses.create(
    model="gpt-5.6-terra",
    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 ist der standardmäßige OpenAI-kompatible Pfad für TokenLab:

response = client.chat.completions.create(
    model="gpt-5.6-terra",
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "Hello!"}
    ]
)

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

Fehlerbehebung

Auf dieser Seite