네이티브 SDK
OpenAI SDK
공식 OpenAI SDK 및 OpenAI 호환 클라이언트를 사용하여 TokenLab 사용
개요
TokenLab는 클라이언트의 base URL을 https://api.tokenlab.sh/v1로 지정하여 공식 OpenAI SDK와 함께 작동합니다.
대부분의 새로운 프로젝트에서는 기본 OpenAI 호환 경로로 Chat Completions를 사용하는 것을 권장합니다. Responses API는 Responses 고유의 동작이 명시적으로 필요할 때만 사용하세요.
Responses 전용 필드는 선택한 모델 및 라우팅된 경로에 따라 동일하게 동작한다고 보장되지 않습니다.
Python, JavaScript, 및 Go에는 공식 OpenAI SDK가 있습니다. PHP는 OpenAI 호환 커뮤니티 클라이언트와 잘 작동하지만 공식 OpenAI SDK는 아닙니다.
설치
pip install openaiPOST /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를 이용한 Vision
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)임베딩
response = client.embeddings.create(
model="text-embedding-3-small",
input="Hello world"
)
print(response.data[0].embedding[:5])Chat Completions
Chat Completions는 TokenLab의 기본 OpenAI 호환 경로입니다:
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)