시작하기
빠른 시작
cURL, Python, JavaScript, Go 또는 PHP로 첫 TokenLab API 요청을 보내세요. API 키와 엔드포인트를 설정하고 Chat Completions 예제를 실행해 응답을 확인하세요.
단계 1: 계정 만들기 및 잔액 충전
계정 만들기
이메일, Gmail 또는 GitHub 계정으로 tokenlab.sh에서 가입하세요.
워크스페이스 잔액 확인
청구에서 사용 가능한 잔액을 확인하세요. 이 요청은 모델의 현재 요금으로 청구되므로 필요하면 충전하세요.
API 키 생성 및 저장
워크스페이스의 API 키를 열고 키를 생성한 뒤 전체 값을 즉시 저장하세요. 전체 키는 한 번만 표시됩니다. 이미 저장한 전체 키가 있으면 그 값을 사용하세요. 목록에 표시되거나 목록에서 복사한 접두사로는 요청을 인증할 수 없습니다.
API 키를 안전하게 보관하세요. 클라이언트 측 코드나 공개 저장소에 절대 노출하지 마십시오.
현재 터미널에 키 설정
아래 명령은 명령 자체에 키를 쓰지 않습니다. 현재 터미널과 자식 프로세스에만 적용됩니다. 배포된 앱에는 비밀 관리 도구를 사용하세요.
printf 'TokenLab API key: '
read -r -s TOKENLAB_API_KEY
printf '\n'
export TOKENLAB_API_KEY단계 2: 클라이언트 설치
pip install openai단계 3: 첫 요청 보내기
대부분의 신규 통합은 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는 커뮤니티 클라이언트를 사용합니다. PHP 8.2 이상이 필요합니다.
Responses 전용 동작이 명시적으로 필요한 경우에만 POST /v1/responses를 사용하세요. 일부 Responses 전용 필드는 선택한 모델 및 라우팅 경로에 따라 다릅니다.
결과 확인
성공한 요청은 비어 있지 않은 답변을 반환합니다. 같은 워크스페이스의 요청에서 모델, 상태, 사용량을 확인하세요. 오류는 문제 해결, 모델 변경과 스트리밍은 SDK 가이드를 참고하세요.