Skip to main content

token とは何ですか(API KEY)

token は、APIYI を呼び出す際に使用する API KEY で、sk- から始まります。これは、あなたの本人確認と権限のための認証情報です。主な役割は次のとおりです。

認証

すべての API 呼び出しには、本人確認とアカウント確認のために token を含める必要があります。

クォータと権限制御

token ごとに、専用のクォータ、有効期限、許可されたモデル、グループを設定できます。

利用統計

各 token の利用額、残りのクォータ、呼び出しログを個別に追跡します。

柔軟な割り当て

プロジェクトやチームメンバーごとに個別の token を作成できます。
登録後、システムは自動的に デフォルト token を生成し、そのまま使えます。必要に応じて追加の tokens も作成できます。

token の作成方法

1

Token ページを開く

上部ナビゲーションから「Token」ページを開きます: https://api.apiyi.com/token
2

「New」をクリック

右上の「New」ボタンをクリックして、token 作成ダイアログを開きます。
3

token の詳細を入力する

token 名、クォータ(無制限は任意)、有効期限(無期限は任意)、課金モード、グループを設定します(下記参照)。
4

保存して KEY をコピーする

保存後、token の右側にあるコピーアイコンをクリックして、sk- KEY 全体をコピーします。
新しい token を作成
token を作成するときに、利用可能なモデルを設定する必要はありません。ホワイトリスト方式が適用されます。空のままにすると token は 400 以上のすべてのモデルを使用でき、設定するとそのモデルに限定されます。Token モデルのホワイトリスト をご覧ください。

トークンの編集とコード例の表示

「操作」列の**管理メニュー(レンチアイコン)**をクリックすると、すべての操作を展開できます: Token management menu and request example
「リクエスト例」はコード例のエントリーポイントです。現在のトークンが事前入力された実行可能な呼び出しコードを生成するため、KEY と endpoint を手動で組み立てる必要がありません。クイックテストや統合に最適です。

複数人で 1 つの token を共有するとレート制限されますか?

お客様からよくある質問です: 「1 つの token を複数人で共有した場合、レート制限されますか?」 答えは、token 自体にレート制限はありません。レート制限は アカウント に基づいて適用されるため、所有している token の数や利用する人数にかかわらず、1 つの token を 10 人で共有しても、1 人につき 10 個の token を使っても、挙動はまったく同じです。

RPM(リクエスト/分)

一般的には、1 つのアカウントで最大 100 RPM までならまったく問題ありません。ほとんどのチームやアプリケーションには十分です。

TPM(毎分 token 数)

TPM は適用されません。そのため、長いコンテキストや高い同時 token 量で制限が発動する心配はありません。
token の共有はレート制限に影響しませんが、管理 の観点からは、メンバーごとまたはプロジェクトごとに個別の token を用意することを引き続きおすすめします。そうすれば、各自に固有のクォータ、呼び出しログ、利用額統計が割り当てられます。

グループとは

グループは、token に対して選択できる「リソースチャネル」です。 異なるグループは、異なる上流リソース、利用可能なモデル範囲、課金倍率に対応しており、ユーザーが選択できるように公開されています。 要するに、同じモデルでも複数の上流チャネルから提供されることがあり、グループを使うことでどのチャネルを使うかを選べます。モデルによっては異なるグループが必要になるため、適切なグループを選ぶことで呼び出しが正常に動作し、対応する割引も適用されます。
大半の場合、デフォルトグループ(Default) だけで十分です — テキストモデル、NanoBanana シリーズ、Veo 3.1 を含む、ほとんどすべてのモデルをカバーしています。

デフォルトグループとフォールバックグループ

1つの token には最大で 3つのグループ を設定できます: デフォルトグループ1つ + フォールバックグループ2つ

デフォルトグループ(プライマリ)

このグループを token が最初に使用します。ほとんどのモデルをカバーします。すべての token にはデフォルトグループが1つ必要です。

フォールバックグループ(バックアップ)

デフォルトグループでリクエストを処理できない場合に自動的に有効になるバックアップチャネルです。最大2つまで設定でき、呼び出し成功率を向上させます。
グループとフォールバックグループの選択 token の作成・編集ダイアログでは:
  • グループを選択: デフォルト(プライマリ)グループを設定します。Default 既定で
  • フォールバックグループ: プライマリが利用できないときに引き継ぐバックアップグループを1〜2つ追加します
グループは token の課金倍率と利用可能なモデルに影響します。 実際に使うモデルに基づいて選択してください。迷ったら、デフォルトの Default をそのままにしてください。

モデルごとに異なるグループが必要です

デフォルトのグループでほとんどのモデルをカバーできますが、一部のモデル、特に動画モデルは専用グループが必要です。
Sora 2 公式、Wan&HappyHorse、その他の専用グループのモデルを呼び出す場合、トークンに対応するグループが含まれていないとそのモデルは利用できません。よく使う専用グループをフォールバックとして追加するか、これらのモデル用に別のトークンを作成することを検討してください。

グループの概要

以下は、システムによって提供されるグループと説明です(コンソール表示が正です): APIYI token グループの概要
「グループ倍率」列は RMB 建ての相対値です。これはUSD の直接的な割引率ではないため、深く考えすぎる必要はありません。モデルに合うグループを選ぶだけで十分です。倍率と価格変換については、モデルの倍率とは何ですか? をご覧ください。

関連ドキュメント

Token 課金モード

従量課金とコールごとの課金の違いを理解します。

Token モデルの許可リスト

1つの token で使用できるモデルを制限する方法です。

モデル倍率

倍率の意味と料金計算を理解します。

呼び出しログ

token ごとの呼び出し記録と利用額の詳細を確認します。