حِزم SDK الأصلية
OpenAI SDK
استخدم TokenLab مع OpenAI SDKs الرسمية والعملاء المتوافقين مع OpenAI
نظرة عامة
تعمل TokenLab مع OpenAI SDKs الرسمية عن طريق توجيه العميل إلى https://api.tokenlab.sh/v1.
لمعظم المشاريع الجديدة، يفضّل استخدام Chat Completions كمسار OpenAI المتوافق الافتراضي. استخدم Responses API فقط عندما تحتاج صراحةً إلى سلوك مخصّص لـ Responses.
لا تُضمن المطابقة التامة لسلوك الحقول الخاصة بـ Responses عبر كل نموذج ومسار موجه.
Python و JavaScript و Go لديها OpenAI SDKs رسمية. تعمل PHP بشكل جيد مع عملاء المجتمع المتوافقين مع OpenAI، لكنها ليست OpenAI SDK رسمية.
النوع: Native SDK
المسار الأساسي: متوافق مع OpenAI / Chat Completions
درجة الدعم: مسار أساسي مدعوم
التثبيت
pip install openaiاستخدم POST /v1/responses فقط عندما تحتاج صراحةً إلى سلوك مخصّص لـ Responses. بعض الحقول الخاصة بـ Responses قد تعتمد أيضًا على النموذج والمسار الموجه.
تكوين العميل
from openai import OpenAI
client = OpenAI(
api_key="sk-your-tokenlab-key",
base_url="https://api.tokenlab.sh/v1",
)موصى به: 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)متقدم: Responses API
استخدم هذا المسار فقط عندما تعتمد أداتك أو سير عملك صراحةً على دلالات OpenAI Responses.
البث مع 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="")الأدوات / استدعاء الدوال
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)الرؤية مع 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 هو مسار OpenAI المتوافق الافتراضي لـ 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)