TokenLab

핵심 가이드

마이그레이션 가이드

기존 OpenAI, Anthropic, Gemini 및 미디어 클라이언트를 TokenLab으로 이전하기

애플리케이션에서 이미 사용 중인 요청 형식을 유지하세요. OpenAI 호환 클라이언트, Anthropic Messages, Gemini REST 및 미디어 엔드포인트는 각각 이에 대응하는 TokenLab API 주소를 가지고 있습니다.

API 매핑

기존 APITokenLab 베이스 URL엔드포인트참고 사항
OpenAI Chat Completionshttps://api.tokenlab.sh/v1/chat/completionsOpenAI 호환 채팅 및 함수 호출을 위한 가장 간단한 변경 방법
OpenAI Responseshttps://api.tokenlab.sh/v1/responses앱이 Responses 전용 입력, 도구 또는 출력 처리에 의존하는 경우 사용
Anthropic SDKhttps://api.tokenlab.sh/v1/messagesSDK 베이스 URL에 /v1을 추가하지 마세요
Gemini RESThttps://api.tokenlab.sh/v1beta/models/:model:generateContentGemini 경로에서는 Gemini 네이티브 필드를 유지하세요
미디어 생성https://api.tokenlab.sh/v1/images/generations, /videos/generations, /music/generations, /3d/generationsrecommended_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 경로에 유지하세요.

미디어 마이그레이션

  1. GET /v1/models?recommended_for=image|video|music|3d를 쿼리합니다.
  2. GET /v1/models에서 모델 목록을 읽고 GET /v1/models/{model}에서 전체 세부 정보를 확인합니다.
  3. 특히 이미지 엔드포인트의 경우 명시적인 model을 전송합니다.
  4. 비동기 작업을 위해 task_id, poll_url, 엔드포인트, 모델 및 자체 작업 ID를 저장합니다. GET /v1/tasks/{id}로 폴링합니다.
  5. 제공자 작업 ID가 아닌 사용 기록 및 billing_transaction_id를 통해 비용을 조정합니다.

미디어 생성은 비동기적으로 완료될 수 있으므로, 기존 통합을 교체하기 전에 task_id와 poll_url을 저장하세요. 생성 요청 타임아웃으로 인해 두 번째 사용자 작업이 생성되어서는 안 됩니다.

마이그레이션 주의사항

  • 앱이 네이티브 Anthropic, Gemini 또는 Responses 동작을 필요로 하는 경우 모든 모델을 하나의 OpenAI Chat Completions 경로 뒤에 두지 마세요.
  • 이전 이미지 기본값을 가정하지 마세요. model을 명시적으로 전송하세요.
  • 작업이 이미 생성되었는지 확인하지 않고 비동기 생성 요청을 재시도하지 마세요.
  • 제품 내에서 TokenLab 작업 ID와 사용 기록을 사용하세요. 타사 작업 ID는 결제 식별자가 아닙니다.

API 참조

주제참조
다중 형식 API다중 형식 API
OpenAI SDKOpenAI SDK
Anthropic SDKAnthropic SDK
Gemini NativeGemini Native API
이미지 생성이미지 생성
비동기 작업 및 폴링비동기 작업 및 폴링

이 페이지의 내용