簡潔な回答
task_id でタスクAPIを照会します。返される quota が動画の総費用です。 2つのログエントリ(事前チャージ+精算)の合計がこの値になり、「非同期タスク」詳細ビューの quota も同じ数値です。
quota ÷ 500,000 = USD. パーソナルアクセストークン(sk- APIキーではなく、nap_ で始まるもの)で認証します。必要な権限は「利用状況と個人レコード · 読み取り」のみです。作成方法については、パーソナルアクセストークンとは何ですか? を参照してください。従来のシステムトークンは 2026-11-11 (UTC+8) に廃止予定です。
ログ照会APIを通じてログエントリを1つずつ照合しようとしないでください。どちらのエントリにも task_id は含まれておらず、精算エントリの request_id は空です。
3つの数値の関係
Seedance 動画は「送信時に事前請求し、完了時に差額を精算する」方式で課金されるため、1本の動画では2件のログエントリが残ります。一方、タスク API とタスク詳細ビューには単一のquota が表示されます。
精算は返金になる場合もあります。高速な 480p・4秒のテキストから動画へのタスクでは、144,000 が事前請求され、40,594 tokens × 18.5 × 0.18 = 135,179 を使用したため、精算エントリには −8,821($0.02 の返金)が記録され、タスク API の
quota は 135,179 です。
最初の数値セットは、参照動画を使用した実際の 2.0 画像から動画へのタスクに基づいています。368,100 tokens × 14(動画入力の課金ティア)× 0.18(グループ比率)= 927,612、すなわち $1.86 です。精算エントリの other フィールドには、final_quota = 927,612、original_quota = 224,999、adjustment_quota = 702,613 が格納されるため、3つすべてを1つのレコードで確認できます。
ステータス別に実際のコストを確認する
2 つの用語体系は異なります。動画クエリエンドポイント
/seedance/api/v3/.../tasks/{id} では成功を succeeded と報告しますが、タスク API /api/task/self では completed と報告します。ポーリングコードの条件をコピーしないでください。
パラメータ表記(ログクエリAPIとは逆)
タスクAPIのページングパラメータはsnake_casepage_sizeで、ページ番号はpが1から開始します。一方、ログクエリAPIではcamelCase pageSizeを使用し、pは0から開始します。間違えてもエラーは発生せず、デフォルトページが返されるだけです。
確認済みのフィルター:
バッチ照合では、時間ウィンドウで取得してください。各項目には
task_id、status、quota、submit_time、finish_time、model_nameが含まれます:
ログを手動で照合する必要がある場合
精算エントリの3つのフィールドは、タスク API と一致します。- そのタイムスタンプ(
created_at)は、1秒以内の差でタスクのfinish_timeと一致します - その
completion_tokensは、タスクのusage.completion_tokensと一致します - その
other.final_quotaは、タスクのquotaと一致します
request_id は、送信レスポンスの X-Shellapi-Request-Id ヘッダーと一致するため、/api/log/self?request_id=… で検索できます。レスポンスには X-Request-Id ヘッダーも含まれる点に注意してください。これはプロバイダー側のリクエスト ID であり、APIYI のログから見つけることはできません。ただし、複数のタスクが同じ秒に送信されると、チャージ前エントリが重複するうえ、精算エントリには request_id がないため、ログは個別タスクのスポットチェックにのみ適しています。プログラムによる照合にはタスク API を使用してください。
よくある質問
タスク詳細のクォータが2つのログエントリの合計と異なりますか?
タスク詳細のクォータが2つのログエントリの合計と異なりますか?
まずタスクのステータスをご確認ください。
submitted / in_progress の間、quota は事前チャージのみであり、2つ目のログエントリはまだ存在しません。failed の場合、quota には事前チャージが表示されたままですが、ログにはマイナスの返金エントリが追加されるため、2つのエントリの合計は0になります。completed のタスクでは両者が一致している必要があります。一致しない場合は、サポートに task_id を送信してください。精算エントリに token や request_id がないのはなぜですか?
精算エントリに token や request_id がないのはなぜですか?
精算はタスクの完了時にシステムによってゲートウェイのリクエストパスの外部で計上されるため、token、グループ、
request_id は含まれず、コンソールでは「ストリーミング」と表示されます。これは正常な動作です。汎用動画エンドポイント経由で送信されたタスクのログには task_id が含まれますか?
汎用動画エンドポイント経由で送信されたタスクのログには task_id が含まれますか?
/v1/videos およびその他の汎用エンドポイントでは、事前チャージエントリの content に task ID: cgt-… が含まれますが、精算エントリには依然として含まれません。また、現在これらのエンドポイントでは Seedance の解像度パラメータが完全には渡されないため、常にドキュメントに記載されているパス /seedance/api/v3/contents/generations/tasks を使用してください。詳細は動画生成 APIを参照してください。パーソナルアクセス token で他のアカウントのタスクを確認できますか?
パーソナルアクセス token で他のアカウントのタスクを確認できますか?
/api/task/self はその token を所有するアカウントのタスクのみを返します。照合用 token には「使用状況と個人記録・読み取り」のみを付与し、厳重に保管して、コードリポジトリには含めないようにしてください。