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

簡潔な回答

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 と報告します。ポーリングコードの条件をコピーしないでください。
失敗したタスクの quota を合計すると、事前請求が支出として計上されます。プログラムで照合する場合は status でフィルタリングしてください。代わりにログ照会 API を通じて照合する場合は、type=2 と type=11 の両方を取得してください。後者は負の quota を持つ返金エントリです。

パラメータ表記(ログクエリAPIとは逆)

タスクAPIのページングパラメータはsnake_case page_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 を使用してください。

よくある質問

まずタスクのステータスをご確認ください。submitted / in_progress の間、quota は事前チャージのみであり、2つ目のログエントリはまだ存在しません。failed の場合、quota には事前チャージが表示されたままですが、ログにはマイナスの返金エントリが追加されるため、2つのエントリの合計は0になります。completed のタスクでは両者が一致している必要があります。一致しない場合は、サポートに task_id を送信してください。
精算はタスクの完了時にシステムによってゲートウェイのリクエストパスの外部で計上されるため、token、グループ、request_id は含まれず、コンソールでは「ストリーミング」と表示されます。これは正常な動作です。
/v1/videos およびその他の汎用エンドポイントでは、事前チャージエントリの content に task ID: cgt-… が含まれますが、精算エントリには依然として含まれません。また、現在これらのエンドポイントでは Seedance の解像度パラメータが完全には渡されないため、常にドキュメントに記載されているパス /seedance/api/v3/contents/generations/tasks を使用してください。詳細は動画生成 APIを参照してください。
/api/task/self はその token を所有するアカウントのタスクのみを返します。照合用 token には「使用状況と個人記録・読み取り」のみを付与し、厳重に保管して、コードリポジトリには含めないようにしてください。

関連ドキュメント