はじめに

クイックスタート

cURL、Python、JavaScript、Go、またはPHPを使用して、最初のTokenLab APIリクエストを実行します。APIキーの設定、エンドポイントの構成、およびChat Completionsレスポンスの検証を行います。

APIキーの取得

アカウントの作成

tokenlab.sh にて、メールアドレス、Google、またはGitHubアカウントを使用してサインアップします。

APIキーの作成と保存

ワークスペースの API Keys を開きます。キーを作成し、その値をすぐに保存してください。値が表示されるのは一度きりです。すでに完全なキーを保存している場合は、その値を使用してください。リストから表示またはコピーされたプレフィックスではリクエストを認証できません。

ワークスペース残高の確認

Billing で残高を確認します。新規アカウントには初回限定のトライアルクレジットが付与される場合があります。それ以外の場合、残高は$0から始まり、最初のリクエストの前にチャージ(最低$5)が必要です。リクエストは、選択したモデルの現在の価格で課金されます。

APIキーは秘密にしてください。クライアント側のコードや公開リポジトリには含めないでください。

ターミナルへのキー設定

以下のコマンドでは、コマンド自体にキーを含めないようにしています。これらは現在のターミナルとその子プロセスに対してのみキーを設定します。デプロイされたアプリケーションにはシークレットマネージャーを使用してください。

printf 'TokenLab API key: '
read -r -s TOKENLAB_API_KEY
printf '\n'
export TOKENLAB_API_KEY

クライアントのインストール

pip install openai

最初のAPIリクエストの送信

ほとんどの新しい統合では、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以上) を使用します。

POST /v1/responses は、Responses固有の動作が必要な場合にのみ使用してください。Responses専用フィールドのサポートは、選択したモデルによって異なります。

結果の確認

リクエストが成功すると、空ではない回答が返されます。同じワークスペース内の Runs を開き、モデル、ステータス、使用状況を確認してください。エラーが発生した場合は、トラブルシューティング に従ってください。モデルの変更やストリーミングの追加は、SDKガイド の次のステップとなります。

最初の呼び出しで402が返される理由

最初の呼び出しが成功するかどうかは、Billing に表示される残高に依存します。トライアルクレジットの提供期間中、対象となる新規アカウントは7日間で最大10回まで使用できる$0.25を一度だけ受け取ります。11回目の呼び出しでは 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 を処理する方法については、エラーハンドリング を参照してください。

開発を続ける

このページの内容