핵심 가이드
마이그레이션 가이드
기존 OpenAI, Anthropic, Gemini 및 미디어 클라이언트를 TokenLab으로 이전하기
애플리케이션에서 이미 사용 중인 요청 형식을 유지하세요. OpenAI 호환 클라이언트, Anthropic Messages, Gemini REST 및 미디어 엔드포인트는 각각 이에 대응하는 TokenLab API 주소를 가지고 있습니다.
API 매핑
| 기존 API | TokenLab 베이스 URL | 엔드포인트 | 참고 사항 |
|---|---|---|---|
| OpenAI Chat Completions | https://api.tokenlab.sh/v1 | /chat/completions | OpenAI 호환 채팅 및 함수 호출을 위한 가장 간단한 변경 방법 |
| OpenAI Responses | https://api.tokenlab.sh/v1 | /responses | 앱이 Responses 전용 입력, 도구 또는 출력 처리에 의존하는 경우 사용 |
| Anthropic SDK | https://api.tokenlab.sh | /v1/messages | SDK 베이스 URL에 /v1을 추가하지 마세요 |
| Gemini REST | https://api.tokenlab.sh | /v1beta/models/:model:generateContent | Gemini 경로에서는 Gemini 네이티브 필드를 유지하세요 |
| 미디어 생성 | https://api.tokenlab.sh/v1 | /images/generations, /videos/generations, /music/generations, /3d/generations | recommended_for를 통해 모델을 찾고, 문서화된 경우 비동기 폴링을 예상하세요 |
| 관리 및 결제 | https://api.tokenlab.sh/v1 | /management/... | 서버 측 호출은 모델 API 키가 아닌 관리용 토큰을 사용합니다 |
빠른 마이그레이션 레시피
OpenAI에서 TokenLab으로
SDK의 base_url / baseURL을 https://api.tokenlab.sh/v1로 변경하고, API 키를 교체한 뒤 GET /v1/models에서 모델 ID를 선택하세요.
OpenRouter에서 TokenLab으로
OpenRouter 베이스 URL을 https://api.tokenlab.sh/v1로 교체하세요. TokenLab 모델 ID에는 OpenRouter 제공자 접두사가 포함되지 않습니다. 애플리케이션이 해당 형식의 필드를 필요로 하는 경우에만 Anthropic Messages 또는 Gemini를 사용하세요.
LiteLLM에서 TokenLab으로
LiteLLM의 custom_openai/<model> 구성을 api_base: https://api.tokenlab.sh/v1과 함께 사용하세요. LiteLLM 별칭을 TokenLab 모델 ID와 별도로 유지하면 애플리케이션 프롬프트를 수정하지 않고도 둘 중 하나를 변경할 수 있습니다.
TokenLab을 통한 Claude Messages
Anthropic SDK 클라이언트를 https://api.tokenlab.sh로 지정하고 messages.create를 호출하세요. SDK 베이스 URL에 /v1을 추가하지 마세요. SDK가 /v1/messages 경로를 관리합니다.
TokenLab을 통한 Gemini Native
Gemini 페이로드를 https://api.tokenlab.sh/v1beta/models/{model}:generateContent에 유지하세요. 앱이 Gemini 동작에 의존하는 경우 Gemini 네이티브 contents, parts, 파일, 캐시된 콘텐츠, 함수 선언 및 내장 도구는 이 경로에 유지되어야 합니다.
OpenAI 호환 마이그레이션
from openai import OpenAI
client = OpenAI(
api_key="sk-your-tokenlab-key",
base_url="https://api.tokenlab.sh/v1",
)
response = client.chat.completions.create(
model="gpt-5.6-terra",
messages=[{"role": "user", "content": "Hello from TokenLab"}],
)기존의 재시도, 타임아웃 및 스트리밍 코드는 그대로 유지할 수 있습니다. GET /v1/models를 통해 모델 ID를 확인하세요. 이미지 요청에는 모델을 명시적으로 포함해야 합니다. 모델별 입력 사항은 이미지 가이드를 참조하세요.
Anthropic 마이그레이션
from anthropic import Anthropic
client = Anthropic(
api_key="sk-your-tokenlab-key",
base_url="https://api.tokenlab.sh",
)
message = client.messages.create(
model="claude-sonnet-5",
max_tokens=1024,
messages=[{"role": "user", "content": "Reply with: Connected to TokenLab."}],
)Claude 도구 호출, 사고 블록(thinking blocks) 및 Anthropic 메시지 필드에는 /v1/messages를 사용하세요. Chat Completions는 해당 필드를 보장하지 않습니다.
Gemini 마이그레이션
curl "https://api.tokenlab.sh/v1beta/models/gemini-3.6-flash:generateContent" \
-H "Authorization: Bearer sk-your-tokenlab-key" \
-H "Content-Type: application/json" \
-d '{"contents":[{"parts":[{"text":"Hello"}]}]}'앱이 Gemini 네이티브 동작에 의존하는 경우 Gemini 내장 도구, File API 참조, 캐시된 콘텐츠, 함수 선언 및 네이티브 콘텐츠 파트를 /v1beta 경로에 유지하세요.
미디어 마이그레이션
GET /v1/models?recommended_for=image|video|music|3d를 쿼리합니다.GET /v1/models에서 모델 목록을 읽고GET /v1/models/{model}에서 전체 세부 정보를 확인합니다.- 특히 이미지 엔드포인트의 경우 명시적인
model을 전송합니다. - 비동기 작업을 위해
task_id,poll_url, 엔드포인트, 모델 및 자체 작업 ID를 저장합니다.GET /v1/tasks/{id}로 폴링합니다. - 제공자 작업 ID가 아닌 사용 기록 및
billing_transaction_id를 통해 비용을 조정합니다.
미디어 생성은 비동기적으로 완료될 수 있으므로, 기존 통합을 교체하기 전에 task_id와 poll_url을 저장하세요. 생성 요청 타임아웃으로 인해 두 번째 사용자 작업이 생성되어서는 안 됩니다.
마이그레이션 주의사항
- 앱이 네이티브 Anthropic, Gemini 또는 Responses 동작을 필요로 하는 경우 모든 모델을 하나의 OpenAI Chat Completions 경로 뒤에 두지 마세요.
- 이전 이미지 기본값을 가정하지 마세요.
model을 명시적으로 전송하세요. - 작업이 이미 생성되었는지 확인하지 않고 비동기 생성 요청을 재시도하지 마세요.
- 제품 내에서 TokenLab 작업 ID와 사용 기록을 사용하세요. 타사 작업 ID는 결제 식별자가 아닙니다.
API 참조
| 주제 | 참조 |
|---|---|
| 다중 형식 API | 다중 형식 API |
| OpenAI SDK | OpenAI SDK |
| Anthropic SDK | Anthropic SDK |
| Gemini Native | Gemini Native API |
| 이미지 생성 | 이미지 생성 |
| 비동기 작업 및 폴링 | 비동기 작업 및 폴링 |