✨ TokenLab API 통합 스킬

이 페이지를 읽고 현재 에이전트에 TokenLab Skill을 추가하세요. 설치된 버전과 활성 설정부터 확인하고 기존 계정, 제공자, 권한 및 설정을 보존하세요. 파일을 백업하고 변경 내용을 보여 주세요. API 키는 제가 로컬에서 입력하므로 채팅에서 요구하거나 표시하지 마세요. 설정 로딩부터 확인하고 유료 테스트는 실행 전에 설명하세요.
https://tokenlab.sh/docs/ko/integrations/coding-agent-skill

이 스킬이 하는 일Copy Anchor Link

• TokenLab chat, image, audio, video, translation 및 기타 API 제품군을 위한 최소 실행 예제를 만듭니다.
• OpenAI 호환 클라이언트에는 https://api.tokenlab.sh/v1을 사용하고, Anthropic 또는 Gemini 네이티브 라우트로 전환해야 하는 경우를 설명합니다.
• 오래된 목록을 추측하지 않고 /v1/models, /llms.txt, recommended_for 후보로 모델을 탐색합니다.
• 비채팅 요청을 재시도하기 전에 모델 모델 세부정보을 읽어 지원되지 않는 필드가 조용히 제거되지 않게 합니다.
• did_you_mean, suggestions, retry_after, recommended_request 같은 Agent-First 오류 힌트를 처리합니다.

설치Copy Anchor Link

npx skills add https://github.com/hedging8563/tokenlab-skills --skill tokenlab-api-integration -y

기존 설치 업데이트Copy Anchor Link

TokenLab skills 저장소 정리 전에 설치했다면 같은 명령을 다시 실행하세요. 현재 공개 패키지는 더 작고 생성된 로컬 검색 스크립트에 의존하지 않습니다.

설치 확인Copy Anchor Link

coding agent에게 물어보세요:

사용 가능한 skills는 무엇인가요?

tokenlab-api-integration이 보이면 설치가 성공한 것입니다.

API Key 받기Copy Anchor Link

권장 Agent 워크플로Copy Anchor Link

현재 모델 목록과 선택한 모델의 tokenlab.accepted_request_formats 및 공개 요청 필드를 읽으세요. 대화와 도구 호출은 같은 형식을 유지하며, 형식 간 필드는 자동 변환되지 않습니다. 오류 때문에 사용자가 선택한 모델이나 프로토콜을 임의로 바꾸지 마세요.

최소 채팅 예제Copy Anchor Link

이 예제는 OpenAI Python SDK와 TokenLab base URL을 사용합니다:

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["TOKENLAB_API_KEY"],
    base_url="https://api.tokenlab.sh/v1",
)

response = client.chat.completions.create(
    model="gpt-5.6-luna",
    messages=[{"role": "user", "content": "Hello!"}],
)

print(response.choices[0].message.content)

실행 방법:

pip install openai
export TOKENLAB_API_KEY="sk-your-api-key"
python app.py

모델 탐색과 모델 세부정보Copy Anchor Link

오래된 번들 목록보다 실시간 탐색을 우선하세요:

# 기계가 읽을 수 있는 API 개요
curl https://api.tokenlab.sh/llms.txt

# 모델 목록
curl "https://api.tokenlab.sh/v1/models" -H "Authorization: Bearer $TOKENLAB_API_KEY"
curl "https://api.tokenlab.sh/v1/models?category=image" -H "Authorization: Bearer $TOKENLAB_API_KEY"

# 비채팅 추천 후보
curl "https://api.tokenlab.sh/v1/models?recommended_for=image" -H "Authorization: Bearer $TOKENLAB_API_KEY"
curl "https://api.tokenlab.sh/v1/models?recommended_for=video" -H "Authorization: Bearer $TOKENLAB_API_KEY"
curl "https://api.tokenlab.sh/v1/models?recommended_for=translation" -H "Authorization: Bearer $TOKENLAB_API_KEY"

# 비채팅 요청을 재시도하기 전 단일 모델 모델 세부정보 읽기
curl "https://api.tokenlab.sh/v1/models/gpt-image-2" -H "Authorization: Bearer $TOKENLAB_API_KEY"

# 가격 전용 상세
curl "https://api.tokenlab.sh/v1/models/gpt-image-2/pricing" -H "Authorization: Bearer $TOKENLAB_API_KEY"

네이티브 프로토콜 선택Copy Anchor Link

일반적인 chat, image, embedding, audio, rerank 예제는 OpenAI 호환 /v1이 기본 경로입니다. 모델명이나 제공자명 또는 Chat 응답 헤더에서 네이티브 프로토콜 가용성을 추론하지 마세요. GET /v1/models/{model}을 확인하고 모델 상세 정보에 공개된 요청 형식만 사용하세요.

확인할 필드는 tokenlab.accepted_request_formats입니다.

프로토콜 엔드포인트는 Chat Completions의 /v1/chat/completions, Responses의 /v1/responses, Messages의 /v1/messages, Gemini의 /v1beta/models/{model}:generateContent입니다.

Agent-First 오류 복구Copy Anchor Link

오류에는 coding agent가 문서를 긁지 않고 파싱할 수 있는 필드가 포함됩니다:

HTTP 상태와 오류 code를 우선 확인하세요. 모델 이름 오류의 did_you_mean을 참고할 수 있지만 사용자 선택 없이 모델을 바꾸지 마세요. 429는 Retry-After 또는 retry_after를 따르고, 오류가 허용하며 재시도를 명시적으로 선택한 경우에만 재시도하세요. 검증, 인증, 잔액, 권한 오류는 먼저 수정해야 합니다. 생성 요청이 시간 초과되면 다시 보내기 전에 기존 작업이 있는지 확인하세요.

지원 API 제품군Copy Anchor Link

모범 사례Copy Anchor Link

FAQCopy Anchor Link

리소스Copy Anchor Link

API나 계정 문제는 앱 내 지원에서 미리보기를 확인한 뒤 명시적으로 제출하세요. 특정 요청은 요청 목록과 조사 가이드에서 시작하세요. Skill 자체의 결함은 GitHub Issues에 신고하세요.