はじめに
クイックスタート
cURL、Python、JavaScript、Go、PHP で初めての TokenLab API リクエストを送信。API キーとエンドポイントを設定し、Chat Completions のサンプルを実行して応答を確認します。
ステップ 1: アカウントを作成して入金する
アカウントを作成
サインアップは tokenlab.sh で、メール、Gmail、または GitHub アカウントを使用して行ってください。
ワークスペースの残高を確認
請求で利用可能な残高を確認します。このリクエストはモデルの現在の料金で課金されるため、必要に応じて入金してください。
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 ガイドを参照してください。