モデル料金を取得
アカウントまたはキー視点の現在のモデル価格カタログを取得
中国本土のユーザー向け: 中国本土のユーザーは https://api.toapis.cn を API エンドポイント (Base URL)としてご利用ください. 本ドキュメント内の例では https://api.toapis.com を https://api.toapis.cn に置き換えてください.
動作
現在のアカウントで利用可能なモデル料金カタログを返し, 各モデルの課金方式と単価を確認できます. api_key_id を指定すると特定キー視点のカタログになります. 旧 GET /v1/pricing と同じカタログ計算を共有しますが, 認証方式, パラメータ, レスポンス構造は異なります.
カタログは現在レートを示すもので, 生成リクエストの見積もりでも総額見積や価格固定にも使えません. 実際の課金額は実費とタスク用量を参照してください.
料金リージョンはアカウントで決まり, region, group, after, 生成パラメータは受け付けません. アカウントに有効な料金リージョンが一つもない場合は 503 を返し, その空の結果をアカウントの料金リージョン設定として保存することもありません.
アカウント視点ではアカウントの有効基本グループを使い, api_key_id 指定時は対象キーのグループとモデル制限も適用します. 対象キーが削除済み, 他人のもの, scope 付きの場合は 404, グループが利用できない場合は 403 (code=13003) です.
meta.key_status は対象キーの設定状態を示すだけで, 現在の利用可否ではありません.
全量カタログは価格を確認できないモデルを除外し, 価格がないことは無料を意味しません. model 指定時: 可視カタログにない場合は 404 (code=16008), 可視だが価格未確定は 503 (code=18029), カタログ依存の障害は 503 (code=18028) です.
設定変更でカーソルが無効になることがあり, 同一ページング内でも価格スナップショットの一貫性は保証されません.
認証
Authorizationstringヘッダー必須Bearer YOUR_SYSTEM_ACCESS_TOKEN を使用します. モデルキーは不可, X-User-Id は不要です. 共通ルールは利用方法を参照してください.
リクエストパラメータ
api_key_idstringクエリ任意の未削除所有キーの料金設定. 省略はアカウント設定. 無効, 期限切れ, 残高不足でも設定料金を参照できますが, 呼び出し可能とは限りません.
modelstringクエリ正確なモデル ID, 最大 255 バイト.
typestringクエリモデル種別: image, video, audio.
limitintegerクエリデフォルト: 100ページ件数, 既定 100, 範囲 1-100.
cursorstringクエリ前ページの next_cursor, 最大 2048 バイト. 条件や料金設定が変わったら最初から取得.
リクエスト例
リクエスト例
curl --request GET \
--url 'https://api.toapis.com/api/v1/pricing?type=image&limit=20' \
--header 'Authorization: Bearer YOUR_SYSTEM_ACCESS_TOKEN'import requests
response = requests.get(
"https://api.toapis.com/api/v1/pricing",
headers={"Authorization": "Bearer YOUR_SYSTEM_ACCESS_TOKEN"},
params={"type": "image", "limit": "20"},
timeout=30,
)
response.raise_for_status()
print(response.json())const response = await fetch("https://api.toapis.com/api/v1/pricing?type=image&limit=20", {
method: "GET",
headers: { Authorization: "Bearer YOUR_SYSTEM_ACCESS_TOKEN" },
signal: AbortSignal.timeout(30_000),
});
if (!response.ok) {
throw new Error(`HTTP ${response.status}: ${await response.text()}`);
}
console.log(await response.json());レスポンスフィールド
例は架空のデータです. 共通レスポンスとエラーは利用方法を参照してください.
data.itemsarrayid, type, prices を含むモデル一覧.
data.meta.currencystring通貨, 常に USD.
data.meta.contextstring料金の視点: account または api_key.
data.meta.api_key_idstring | null対象キー ID, アカウント視点は null.
data.meta.key_statusstring | null対象キーの状態, アカウント視点は null.
data.meta.regionstring有効地域: cn または global.
data.has_moreboolean次ページの有無.
data.next_cursorstring | null次カーソル, 最終ページは null.
prices[].groupstring料金が適用されるルーティンググループ. API Keyが自動グループ選択を使用する場合, 複数のグループが返ることがあります.
prices[].conditionsobject料金が成立する条件. 料金に影響するモデルの既定値も含まれます. 生成リクエストをこの値に合わせてください.
prices[].charge_typestringper_request, per_second, または per_token.
prices[].price_basisstring課金基準. request, output_seconds, output_videos, total_tokens, または text_input_tokens.
prices[].unitstring料金単位. request, second, video, または 1m_tokens.
prices[].unit_pricestringUSD建ての有効な単価を10進文字列で返します. 顧客別料金とグループ倍率は反映済みです. グループ倍率を再度掛けないでください.
料金には input_unit_price, input_image_unit_price, free_input_image_count, minimum_charge_usd, image_token_prices が含まれる場合があります.
時間帯別料金では pricing_period, pricing_timezone, pricing_schedule_version, pricing_peak_windows が含まれる場合があります.
画像トークン料金の image_token_prices には, text_input, cached_text_input, image_input, cached_image_input, image_output が含まれます. 各金額の単位は100万トークンあたりのUSDです.
レスポンス例
レスポンス例
{
"code": 0,
"message": "",
"data": {
"items": [
{
"id": "example-image-model",
"type": "image",
"prices": [
{
"charge_type": "per_request",
"unit": "request",
"unit_price": "0.05",
"price_basis": "request",
"group": "default",
"conditions": {
"size": "1024x1024"
}
}
]
}
],
"has_more": false,
"next_cursor": null,
"meta": {
"currency": "USD",
"context": "account",
"api_key_id": null,
"key_status": null,
"region": "global"
}
}
}