✨ TokenLab API 統合スキル

このページを読み、現在のエージェントに TokenLab Skill を追加してください。インストール済みバージョンと設定を確認し、既存のアカウント、プロバイダー、権限、その他の設定を保持してください。ファイルをバックアップし、変更を示してください。API キーはローカルで入力するため、チャットで要求・表示しないでください。最初に設定の読み込みを確認し、有料テストは実行前に説明してください。
https://tokenlab.sh/docs/ja/integrations/coding-agent-skill

このスキルでできることCopy Anchor Link

• TokenLab のチャット、画像、音声、動画、翻訳などの 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

通常のチャット、画像、embedding、音声、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へ報告できます。