Skip to main content

短い回答

task_id でタスク API を照会してください。返される quota が動画の合計コストです。 2 件のログエントリ(事前チャージ + 精算)の合計がこれに一致し、「非同期タスク」詳細ビューの quota も同じ数値です。
quota ÷ 500,000 = USDシステム tokensk- API キーではありません)で認証してください。取得方法については、ログ照会 APIを参照してください。 ログ照会 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=2type=11 の両方を取得してください。後者は負の quota を持つ返金エントリです。

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

タスクAPIのページングパラメータはsnake_case page_sizeで、ページ番号はpが1から開始します。一方、ログクエリAPIではcamelCase pageSizeを使用し、pは0から開始します。間違えてもエラーは発生せず、デフォルトページが返されるだけです。 確認済みのフィルター: バッチ照合では、時間ウィンドウで取得してください。各項目にはtask_idstatusquotasubmit_timefinish_timemodel_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タスクの場合は、2件の値が一致する必要があります。一致しない場合は、task_idをサポートに送信してください。
決済はタスク完了時にシステムによって記録され、ゲートウェイのリクエスト経路外で処理されるため、token、グループ、request_idは含まれず、コンソールでは「streaming」と表示されます。これは正常な動作です。
/v1/videosおよびその他の汎用エンドポイントでは、事前チャージエントリのcontenttask ID: cgt-…が含まれますが、決済エントリには依然として含まれません。これらのエンドポイントでは、現在もSeedanceの解像度パラメータの引き渡しが不完全であるため、必ずドキュメントに記載されたパス/seedance/api/v3/contents/generations/tasksを使用してください。動画生成 APIを参照してください。
/api/task/selfは、tokenを所有するアカウントのタスクのみを返します。システムtokenはアカウント認証情報と同等です。そのため、パスワードと同じように厳重に管理し、コードリポジトリに保存しないでください。

関連ドキュメント