시작하기
퀵스타트
cURL, Python, JavaScript, Go 또는 PHP를 사용하여 첫 번째 TokenLab API 요청을 수행하세요. API 키를 설정하고, 엔드포인트를 구성한 다음, Chat Completions 응답을 확인하세요.
API 키 가져오기
계정 생성
tokenlab.sh에서 이메일, Google 또는 GitHub 계정을 사용하여 가입하세요.
API 키 생성 및 저장
워크스페이스에서 API Keys를 엽니다. 키를 생성하고 전체 값을 즉시 저장하세요. 이 값은 한 번만 표시됩니다. 이미 전체 키를 저장했다면 해당 값을 사용하세요. 목록에서 표시되거나 복사된 접두사로는 요청을 인증할 수 없습니다.
워크스페이스 잔액 확인
Billing에서 잔액을 확인하세요. 새 계정은 일회성 체험 크레딧을 받을 수 있으며, 그렇지 않은 경우 잔액은 $0에서 시작하므로 첫 번째 요청 전에 충전(최소 $5)이 필요합니다. 요청은 선택한 모델의 현재 가격으로 청구됩니다.
API 키를 안전하게 보관하세요. 클라이언트 측 코드나 공개 저장소에 넣지 마세요.
터미널에 키 설정하기
아래 명령은 명령 자체에 키를 노출하지 않습니다. 현재 터미널과 해당 자식 프로세스에 대해서만 키를 설정합니다. 배포된 애플리케이션의 경우 보안 관리자(secret manager)를 사용하세요.
printf 'TokenLab API key: '
read -r -s TOKENLAB_API_KEY
printf '\n'
export TOKENLAB_API_KEY클라이언트 설치
pip install openai첫 번째 요청 보내기
대부분의 새로운 통합은 POST /v1/chat/completions의 Chat Completions로 시작하세요.
curl https://api.tokenlab.sh/v1/chat/completions \
-H "Authorization: Bearer $TOKENLAB_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-5.6-terra","messages":[{"role":"user","content":"Reply only with OK."}]}'SDK 예제 중 하나를 quickstart.py, quickstart.mjs, main.go 또는 quickstart.php로 저장한 다음 python quickstart.py, node quickstart.mjs, go run . 또는 php quickstart.php를 실행하세요. Python, JavaScript, Go는 공식 OpenAI SDK를 사용하며, PHP는 커뮤니티에서 유지 관리하는 OpenAI PHP client(PHP 8.2 이상)를 사용합니다.
Responses 전용 동작이 필요한 경우에만 POST /v1/responses를 사용하세요. Responses 전용 필드에 대한 지원은 선택한 모델에 따라 다릅니다.
결과 확인
성공적인 요청은 비어 있지 않은 답변을 반환합니다. 동일한 워크스페이스에서 Runs를 열어 모델, 상태 및 사용량을 확인하세요. 오류가 발생하면 문제 해결 가이드를 따르세요. 모델 변경이나 스트리밍 추가는 SDK 가이드의 별도 다음 단계입니다.
첫 번째 호출에서 402 오류가 발생하는 이유는 무엇인가요?
첫 번째 호출이 작동하는지 여부는 Billing에 표시된 잔액에 따라 다릅니다. 체험 크레딧 제공 기간 동안, 자격을 갖춘 새 계정은 7일 이내에 최대 10회 호출까지 $0.25를 한 번 받습니다. 열한 번째 호출은 402를 반환하며, 약간의 크레딧이 남아 있더라도 무료 체험 호출이 모두 소진되었음을 알립니다. 잔액이 $0인 계정은 오류 코드 insufficient_balance와 함께 HTTP 402를 받습니다. Billing에서 최소 $5 이상 충전하세요. 그런 다음 동일한 요청을 다시 보내세요. 새 API 키는 필요하지 않습니다. 잔액이 요청을 충족하면 생성한 키가 계속 작동합니다.
첫 번째 테스트 호출 비용은 매우 적습니다. deepseek-v4.1-flash에 대한 예제 요청 한 번의 비용은 $0.01보다 훨씬 낮습니다.
이미 잔액이 있는 경우, 402 메시지는 요청에 필요한 금액과 현재 잔액을 알려줍니다. TokenLab은 호출이 시작되기 전에 전체 max_tokens 비용을 보류하므로, 긴 입력이나 큰 max_tokens 값은 적은 잔액보다 더 많은 금액이 필요할 수 있습니다. /v1/chat/completions 및 /v1/messages에서 더 작은 max_tokens가 적합한 경우, 메시지는 해당 값으로 낮추라는 안내를 제공합니다. 입력 자체의 비용이 잔액보다 큰 경우, 입력을 줄이라는 안내가 표시됩니다.
자체 지출 한도에 도달한 키도 quota_exceeded 코드와 함께 402를 반환합니다. API Keys에서 한도를 높이거나 제거하세요. 코드에서 402를 처리하는 방법은 오류 처리를 참조하세요.