メインコンテンツへスキップ

​
概要

この endpoint は、現在の管理トークンに紐づく組織内に、新しい type=user API Key を作成します。

​
リクエストボディ

フィールド型既定値 / 制約説明
namestring必須、既定値 Default Key、長さ 1-50表示名。サーバー側で前後空白が取り除かれます
limitAmountnumber | null最小 0、最大 100000null または省略 = 無制限、0 = 利用可能額 0、正の値 = USD 上限
limitCurrencyenum既定値 USD任意: USD または CNY。CNY を指定すると limitAmount は人民元として解釈され、保存前にサーバー側で USD に換算されます
modelsstring[]既定値 []任意の論理モデル許可リスト
expiresAtstring | nullRFC3339 datetimenull は期限なしを意味します

​
補足

  • 完全な API Key 値はレスポンスで一度だけ返されます。
  • models: [] は、組織ポリシー以外の追加制限がないことを意味します。
  • limitAmount: 0 は有効だが利用可能額 0 のキーを作成します。後から更新できます。
  • デフォルトでは limitAmount は USD として解釈されます。limitCurrency: "CNY" を送ると、上限は人民元として扱われ、保存前に現在の為替レートで自動的に USD へ換算されます。
  • レスポンスには exchange_rate と、RMB 表示用の limit_amount_cny / used_amount_cny が含まれます。

​
例

curl -X POST "https://api.lemondata.cc/v1/management/api-keys" \
  -H "Authorization: Bearer mt-your-management-token" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Backend Worker",
    "limitAmount": 500,
    "models": ["veo3.1", "sora-2"],
    "expiresAt": "2026-12-31T23:59:59Z"
  }'

​
リクエスト / レスポンス

正確な schema とレスポンス項目は、上部のインタラクティブな OpenAPI パネルを参照してください。