Token 管理 API

API 概要

Token 管理 API では、コンソールでキーを 1 つずつクリックして操作する代わりに、APIキーのライフサイクル全体をコードで管理できます。最も一般的なユースケースは 一括発行 です。各チームメンバー、下流の顧客、またはプロジェクトにそれぞれ専用のキーを割り当て、利用できる金額の上限、呼び出せるモデル、有効な期間 にそれぞれ制限を設定します。

クォータ上限

remain_quota は、このキーが合計で利用できる金額の上限を設定します

モデル上限

models は許可リストを設定し、それ以外への呼び出しは拒否されます

有効期限上限

expired_time は有効期限のタイムスタンプを設定し、その後はキーが動作しなくなります

1つか2つのキーだけ必要なら、コンソールのほうが速いです。APIキーの作成方法を参照してください。この API は、自動発行、定期ローテーション、またはキー管理を自社システムに組み込む用途に向いています。

システムトークンの取得方法

トークン管理 API は システムトークン で認証します。これは API キーとは別物です。

コンソールにアクセス

プロフィールページにアクセスするには api.apiyi.com/account/profile を開いてください

システムトークンを見つける

ページ下部の「アカウントオプション - システムトークン」セクションを見つけてください

アクセストークンを生成

アカウントのパスワードを入力すると、その後の API クエリに使用できるアクセストークンを取得できます

システムトークンでは API キーの作成と削除ができます。アカウントのパスワードと同じように扱ってください。システムトークンはモデルを直接呼び出すことはできません — /v1/chat/completions に対して使用すると拒否されます — しかし、使用できる API キーを作成できます。そのため、システムトークンの漏洩は 1 つの API キーの漏洩よりもはるかに深刻です。 コード内ではなくシークレットマネージャーに保管し、リポジトリには決してコミットせず、定期的にローテーションしてください。

エンドポイント

すべてのエンドポイントは同じ方法で認証します。生のシステム token を Authorization ヘッダーに入れ、Bearer プレフィックスは付けません。

Method	Path	用途
`GET`	`/api/token/?p=0&page_size=100`	アカウント内のすべての token を一覧表示します
`GET`	`/api/token/{id}`	単一の token を取得します
`POST`	`/api/token/`	token を作成します; レスポンスはキーをプレーンテキストで返します
`PUT`	`/api/token/`	token を更新します（完全なオブジェクトが必要です）
`PUT`	`/api/token/?status_only=true`	有効/無効の状態のみを切り替えます
`DELETE`	`/api/token/{id}`	token を削除します

ベース URL は https://api.apiyi.com です。

トークンの作成

リクエスト例

export APIYI_SYS_TOKEN='YOUR_SYSTEM_TOKEN'

curl --compressed -s -X POST 'https://api.apiyi.com/api/token/' \
  -H "Authorization: $APIYI_SYS_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "team-alice",
    "remain_quota": 500000,
    "unlimited_quota": false,
    "group": "default",
    "models": "gpt-5.6,deepseek-chat",
    "expired_time": -1
  }'

リクエスト項目

Field	Type	Description
`name`	String	トークン名、識別用
`remain_quota`	Integer	クレジット単位のクォータ上限；500,000 = $1.00
`unlimited_quota`	Boolean	クォータが無制限かどうか；デフォルトは`false`です
`group`	String	トークンが紐づくグループ識別子。例：`default`
`models`	String	モデルの許可リスト、カンマ区切り。制限しない場合は省略してください
`expired_time`	Integer	Unix秒の有効期限タイムスタンプ；`-1` は無期限を意味します

unlimited_quota のデフォルトは false で、remain_quota のデフォルトは 0 です — 両方を省略すると使用できないクォータ 0 のトークンが作成されます。remain_quota を明示的に設定するか、 unlimited_quota を true に設定してください。

モデルの許可リストには models フィールドを使用してください。レスポンス構造には model_limits、model_limits_enabled、allow_ips も含まれます。これらを渡してもエラーにはならず、エンドポイントは引き続き 200 を返しますが、現時点では効果はなく、トークンを取得し直しても未設定のままです。利用可能なモデルを制限するには models を使用してください。送信元 IP の制限は、現時点ではご自身で実装する必要があります。

レスポンス例

{
  "success": true,
  "message": "",
  "data": {
    "id": 119431,
    "user_id": 80778,
    "key": "K1RPzapuXLfBU4kDC5D9C0E70b1841AeAa542186B2F54b75",
    "status": 1,
    "name": "team-alice",
    "group": "default",
    "models": "gpt-5.6,deepseek-chat",
    "remain_quota": 500000,
    "unlimited_quota": false,
    "used_quota": 0,
    "expired_time": -1,
    "created_time": 1785599000
  }
}

レスポンス内の key はプレーンテキストで、sk- プレフィックスは含まれていません。 自分で先頭に付ける必要があります — 上の例では、実際の API キーは sk-K1RPzapu… です。作成時にキーを保存して共有し、key を含むレスポンス本文をログファイルに残したままにしないでください。

バッチ作成

サーバー側にバッチ用エンドポイントはありません — リクエストボディに count のようなものを渡しても効果はなく、単一の token が作成されるだけです。バッチ発行はクライアント側でループして行います。

Python
Node.js
cURL

import json
import os
import time

import requests

BASE = "https://api.apiyi.com"
HEADERS = {"Authorization": os.environ["APIYI_SYS_TOKEN"],
           "Content-Type": "application/json"}
QUOTA_PER_USD = 500_000


def create_token(name, quota_usd=None, group="default", models=None, days=0):
    """Create one token. quota_usd=None means unlimited; days=0 means never expires."""
    body = {
        "name": name,
        "group": group,
        "unlimited_quota": quota_usd is None,
        "remain_quota": 0 if quota_usd is None else int(quota_usd * QUOTA_PER_USD),
        "expired_time": -1 if not days else int(time.time()) + days * 86400,
    }
    if models:
        body["models"] = models

    resp = requests.post(f"{BASE}/api/token/", headers=HEADERS, json=body, timeout=30)
    resp.raise_for_status()
    data = resp.json()["data"]
    return {"id": data["id"], "name": data["name"], "key": "sk-" + data["key"]}


if __name__ == "__main__":
    names = ["team-alice", "team-bob", "team-carol"]
    created = [
        create_token(n, quota_usd=1, group="default", models="gpt-5.6", days=30)
        for n in names
    ]
    for row in created:
        print(f"{row['name']:16s} id={row['id']} {row['key']}")

    # the plaintext key is only returned at creation time, so store it carefully
    with open("keys.json", "w") as f:
        json.dump(created, f, ensure_ascii=False, indent=1)

const BASE = "https://api.apiyi.com";
const HEADERS = {
  Authorization: process.env.APIYI_SYS_TOKEN,
  "Content-Type": "application/json",
};
const QUOTA_PER_USD = 500_000;

async function createToken(name, { quotaUsd = null, group = "default",
                                   models = null, days = 0 } = {}) {
  const body = {
    name,
    group,
    unlimited_quota: quotaUsd === null,
    remain_quota: quotaUsd === null ? 0 : Math.round(quotaUsd * QUOTA_PER_USD),
    expired_time: days ? Math.floor(Date.now() / 1000) + days * 86400 : -1,
  };
  if (models) body.models = models;

  const resp = await fetch(`${BASE}/api/token/`, {
    method: "POST",
    headers: HEADERS,
    body: JSON.stringify(body),
  });
  if (!resp.ok) throw new Error(`HTTP ${resp.status}`);
  const { data } = await resp.json();
  return { id: data.id, name: data.name, key: `sk-${data.key}` };
}

const names = ["team-alice", "team-bob", "team-carol"];
for (const name of names) {
  const row = await createToken(name, { quotaUsd: 1, models: "gpt-5.6", days: 30 });
  console.log(row.name, row.id, row.key);
}

export APIYI_SYS_TOKEN='YOUR_SYSTEM_TOKEN'

for NAME in team-alice team-bob team-carol; do
  curl --compressed -s -X POST 'https://api.apiyi.com/api/token/' \
    -H "Authorization: $APIYI_SYS_TOKEN" \
    -H 'Content-Type: application/json' \
    -d "{\"name\":\"$NAME\",\"remain_quota\":500000,\"unlimited_quota\":false,\"group\":\"default\",\"expired_time\":-1}" \
    | jq -r '"\(.data.name)\tsk-\(.data.key)"'
done

3つのリミットの使い方

クォータ制限

remain_quota は token が使える金額の上限を設定します。換算は残高照会 API と一致します:

換算ルール

500,000 クォータ = $1.00 USD

たとえば、下流の顧客に $10 を上限とするキーを発行するには、remain_quota を 5000000 に、unlimited_quota を false に設定します。これまでの消費量は、token の used_quota フィールドから読み取れます。

モデル制限

models は、カンマ区切りの許可リストです。一度設定すると、リスト外の model を呼び出すと拒否されます:

{
  "error": {
    "message": "This token is not authorized to use model: deepseek-chat"
  }
}

レスポンスは HTTP 403 で、課金は発生しません。models を省略すると、制限なしを意味します。

有効期限制限

expired_time は Unix 秒のタイムスタンプで、-1 は期限なしを意味します。たとえば、30日後に期限切れになるキー:

import time
expired_time = int(time.time()) + 30 * 86400

トークン一覧

curl --compressed -s 'https://api.apiyi.com/api/token/?p=0&page_size=100' \
  -H "Authorization: $APIYI_SYS_TOKEN" | jq '.data[] | {id, name, status, remain_quota, used_quota, models}'

主要フィールド:

フィールド	説明
`id`	更新と削除に使用する Token ID
`key`	`sk-` プレフィックスなしのプレーンテキストのキー
`status`	`1` = 有効、`2` = 無効
`remain_quota` / `used_quota`	残り / 消費済みのクォータ
`unlimited_quota`	クォータが無制限かどうか
`models`	モデルの許可リスト。空の場合は制限なし
`expired_time`	有効期限のタイムスタンプ。`-1` は期限なしを意味します

token の更新

更新エンドポイントには完全なオブジェクトが必要です。パッチではありません。正しい流れは次のとおりです: GET 完全な token オブジェクトを取得し、変更したいフィールドを修正してから、 PUT オブジェクト全体 を送り返します。変更したフィールドだけを送ると、残りはクリアされます。

import os
import requests

BASE = "https://api.apiyi.com"
HEADERS = {"Authorization": os.environ["APIYI_SYS_TOKEN"],
           "Content-Type": "application/json"}

# 1. fetch the complete object
token = requests.get(f"{BASE}/api/token/119431", headers=HEADERS, timeout=30).json()["data"]

# 2. change only what you need, leaving everything else as-is
token["remain_quota"] = 2_500_000     # raise the cap to $5
token["models"] = "gpt-5.6,gemini-3-pro"

# 3. PUT the whole object back
resp = requests.put(f"{BASE}/api/token/", headers=HEADERS, json=token, timeout=30)
print(resp.json()["success"])

無効化と削除

無効化（記録は保持されます）

無効化すると、キーは直ちに動作しなくなります — そのキーを使った呼び出しは 401 を返します — ただし token の記録とその利用履歴は保持されます。

token = requests.get(f"{BASE}/api/token/119431", headers=HEADERS, timeout=30).json()["data"]
token["status"] = 2      # 1 = enabled, 2 = disabled

requests.put(f"{BASE}/api/token/", headers=HEADERS,
             params={"status_only": "true"}, json=token, timeout=30)

削除（元に戻せません）

curl --compressed -s -X DELETE 'https://api.apiyi.com/api/token/119431' \
  -H "Authorization: $APIYI_SYS_TOKEN"

一括削除も同様にクライアント側のループです:

for token_id in [119431, 119432, 119433]:
    requests.delete(f"{BASE}/api/token/{token_id}", headers=HEADERS, timeout=30)

削除は元に戻せません。key を一時的に停止したいだけなら、代わりに無効化してください — 利用履歴は照合用に引き続き利用できます。

よくある質問

作成時に返されたキーが使えないのはなぜですか？

レスポンス内のkeyにはsk-プレフィックスが含まれていません。自分で先頭に付けてください: 利用可能なAPIキーは、返された値の前にsk-を付けたものです。

新しく作成した token がクォータ不足と表示されるのはなぜですか？

おそらく、作成時にremain_quotaが設定されておらず、unlimited_quotaもtrueに設定されていなかったためです。そのデフォルトの組み合わせでは、クォータ 0 の token が作成されます。2つのうちどちらか一方を明示的に指定して、再作成してください。

model_limits または allow_ips が効かないのはなぜですか？

これらのフィールドは、model_limits_enabledとともに、現時点では有効になりません。渡してもエラーにはなりませんが、何も保存されません。利用可能なモデルを制限するにはmodelsを使用してください。送信元IP の制限は、当面はお客様側で対応する必要があります。

1回のリクエストで複数の token を作成できますか？

サーバー側のバッチエンドポイントはなく、body にcountのようなものを渡しても効果はありません。代わりに、クライアント側で create 呼び出しをループしてください。上の一括作成セクションをご覧ください。

update 後に他のフィールドが消えてしまいました

update エンドポイントでは完全なオブジェクトが必要です。まず完全なオブジェクトをGETし、変更してから、変更されたフィールドだけを送るのではなく、全体をPUTしてください。

無効化と削除の違いは何ですか？

無効化（status: 2）するとキーはすぐに使えなくなりますが、レコードと利用履歴は保持され、いつでも1に戻せます。削除は元に戻せず、レコードも削除されます。一時停止には無効化をお勧めします。

各キーの使用額を確認するにはどうすればよいですか？

token のused_quotaフィールドは、そのキーの累計使用額です（÷ 500,000 = USD）。期間ごとの内訳や呼び出し単位の詳細を確認するには、 token_nameフィルター付きで Log Query API を使用してください。

重要な注意事項

システム token は API key ではなく、両者は互換ではありません

API key（sk- で始まる）は /v1/* 推論エンドポイント用です
システム token（接頭辞のないプレーンな文字列）は /api/* 管理エンドポイント用です

取り違えると、それぞれ 401 と無効な token エラーが返ります。

プレーンテキストの key は慎重に扱ってください作成レスポンスと token 一覧の両方が、key をプレーンテキストで返します。したがって:

key を含むレスポンス本文をログファイルに書き込んだり、リポジトリにコミットしたりしないでください
key はグループチャットではなく、安全なチャネルでチームメンバーに共有してください
このプレーンテキストには sk- プレフィックスが付かないため、一般的なシークレットスキャナーでは検出されない場合があります — 自動チェックに頼って検出させないでください

運用のヒント

一括で作成する場合は、呼び出し間に適度な遅延を入れて、一時的な高い同時実行数を避けてください
各 key に意味のある name（たとえば team-alice や prod-webhook）を付けておくと、後でログ上で token_name 別に使用状況を把握できます
ローテーション時は、新しい key を作成し、トラフィックを切り替え、古い key を無効化し、しばらく様子を見てから、呼び出しが残っていないことを確認した時点で削除してください

基本

基本API

画像API（公式）

動画API（公式）

マルチモーダル理解API

テキスト生成

検索と安全性

API 概要

クォータ上限

モデル上限

有効期限上限

システムトークンの取得方法

エンドポイント

トークンの作成

リクエスト例

リクエスト項目

レスポンス例

バッチ作成

3つのリミットの使い方

クォータ制限

換算ルール

モデル制限

有効期限制限

トークン一覧

token の更新

無効化と削除

無効化（記録は保持されます）

削除（元に戻せません）

よくある質問

重要な注意事項

関連ドキュメント

​API 概要

クォータ上限

モデル上限

有効期限上限

​システムトークンの取得方法

​エンドポイント

​トークンの作成

​リクエスト例

​リクエスト項目

​レスポンス例

​バッチ作成

​3つのリミットの使い方

​クォータ制限

換算ルール

​モデル制限

​有効期限制限

​トークン一覧

​token の更新

​無効化と削除

​無効化（記録は保持されます）

​削除（元に戻せません）

​よくある質問

​重要な注意事項

関連ドキュメント

API 概要

システムトークンの取得方法

エンドポイント

トークンの作成

リクエスト例

リクエスト項目

レスポンス例

バッチ作成

3つのリミットの使い方

クォータ制限

モデル制限

有効期限制限

トークン一覧

token の更新

無効化と削除

無効化（記録は保持されます）

削除（元に戻せません）

よくある質問

重要な注意事項