curl --request GET \
--url 'https://toapis.com/v1/pricing?model=seedance-2-5' \
--header 'Authorization: Bearer <token>'
{
"object": "list",
"currency": "USD",
"data": [
{
"id": "seedance-2-5",
"type": "video",
"prices": [
{
"group": "default",
"conditions": {"resolution": "720p", "has_video_input": false},
"charge_type": "per_token",
"price_basis": "total_tokens",
"unit": "1m_tokens",
"unit_price": "4"
}
]
}
],
"has_more": false,
"next_after": ""
}
アカウント
料金と実際の請求額
API Keyで利用できる料金と、生成レスポンスで確定した請求額を確認します
GET
/
v1
/
pricing
curl --request GET \
--url 'https://toapis.com/v1/pricing?model=seedance-2-5' \
--header 'Authorization: Bearer <token>'
{
"object": "list",
"currency": "USD",
"data": [
{
"id": "seedance-2-5",
"type": "video",
"prices": [
{
"group": "default",
"conditions": {"resolution": "720p", "has_video_input": false},
"charge_type": "per_token",
"price_basis": "total_tokens",
"unit": "1m_tokens",
"unit_price": "4"
}
]
}
],
"has_more": false,
"next_after": ""
}
中国本土から利用する場合は、Base URLに
https://toapis.cn を使用してください。以下の例の https://toapis.com を https://toapis.cn に置き換えます。GET /v1/pricing は、現在のAPI Keyで利用できる画像・動画モデルの料金を返します。顧客別の固定価格または割引と、有効なグループ価格はすでに反映されています。
このエンドポイントが返すのは料金カタログです。1 回の生成に対する見積もりではありません。価格の予約や固定、生成パラメータからの合計金額の計算は行いません。
認証
string
必須
生成API Keyを
Bearer YOUR_API_KEY の形式で指定します。クエリパラメータ
string
完全一致のモデルID。省略すると、利用可能な画像・動画モデルをすべて返します。
string
image または video で絞り込みます。integer
デフォルト:"100"
返すモデル数。
1 から 100 まで指定できます。string
前回のレスポンスの
next_after をページネーションカーソルとして指定します。model に seedance-2-5、seedance-2-5-cn、seedance-2-5-global を指定します。地域専用のクエリパラメータはありません。
curl --request GET \
--url 'https://toapis.com/v1/pricing?model=seedance-2-5' \
--header 'Authorization: Bearer <token>'
{
"object": "list",
"currency": "USD",
"data": [
{
"id": "seedance-2-5",
"type": "video",
"prices": [
{
"group": "default",
"conditions": {"resolution": "720p", "has_video_input": false},
"charge_type": "per_token",
"price_basis": "total_tokens",
"unit": "1m_tokens",
"unit_price": "4"
}
]
}
],
"has_more": false,
"next_after": ""
}
料金フィールド
string
料金の通貨。現在は
USD です。string
オブジェクトの種類。常に
list です。array
利用可能なモデル。各項目には完全一致のモデル
id、type、0 件以上の prices が含まれます。boolean
次のページがあるかどうかを示します。
string
次のリクエストで使うカーソル。
has_more が false の場合は空文字列です。string
料金が適用されるルーティンググループ。API Keyが自動グループ選択を使用する場合、複数のグループが返ることがあります。
object
料金が成立する条件。料金に影響するモデルの既定値も含まれます。生成リクエストをこの値に合わせてください。
string
per_request、per_second、または per_token。string
課金基準。
request、output_seconds、total_tokens、または text_input_tokens。string
料金単位。
request、second、または 1m_tokens。string
USD建ての有効な単価を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です。
記載された条件と互換性がある有効な候補チャネルが1つ以上存在する料金だけを返します。この確認ではルートを予約せず、チャネルのリアルタイムな正常性も検査しません。安全に完全な料金を公開できない場合、モデルの prices は空になることがあります。空の配列や料金項目の欠落は、無料であることを意味しません。
実際の請求額
請求額を確認できる場合、生成レスポンスには次のオブジェクトが含まれます。{
"billing": {
"status": "settled",
"credits": "100",
"cost_usd": "0.5"
}
}
| フィールド | 意味 |
|---|---|
status | pending、settled、または refunded |
credits | 確定したToAPIs Creditsの消費量。10進文字列 |
cost_usd | 同じ確定済み請求のUSD金額。10進文字列 |
pending は最終金額が未確定であることを示し、金額フィールドは省略されます。refunded は確定した純請求額がゼロであることを示します。billing 全体がない場合は、安全に公開できる値を確認できなかったことを示します。無料という意味ではありません。
このオブジェクトは次の場所に含まれる場合があります。
- 非同期画像タスク照会
GET /v1/images/generations/{task_id} - 非同期動画タスク照会
GET /v1/videos/generations/{task_id} - Task Webhookの
data.billing - 対応する非ストリーミング同期画像生成・編集レスポンスのトップレベル
billing
エラー
| ステータス | コード | 意味 |
|---|---|---|
400 | invalid_request_error | 未対応のクエリパラメータ、または無効な type / limit |
401 / 403 | 状況により異なる | API Keyが無効、期限切れ、制限対象、または対象のアカウント・グループを利用できない |
404 | model_not_found | 完全一致のモデルIDをこのAPI Keyで利用できない |
503 | pricing_unavailable | 顧客別料金を安全に取得できない。公開価格へのフォールバックは行わない |
Cache-Control: private, no-store が設定されます。