送信後にSeedanceの動画タスクをキャンセルできますか？

​

簡単な回答

​

公開エンドポイントとタスクステータス

queued → running → succeeded / failed / expired

• queued: タスクが作成され、キューで待機しています。
• running: タスクが処理中です。
• succeeded: 動画生成が正常に完了しました。
• failed: タスクの処理に失敗しました。
• expired: タスクが実行可能時間を超過し、期限切れになりました。

content.video_url

​

What should I do after submitting a task?

​

Step 1: Save the task ID and request details

• The model name;
• The prompt or a prompt summary;
• Important parameters such as duration, resolution, and aspect ratio;
• The submission time;
• The request ID;
• The business ID in your own system.

​

Step 2: Query the original task

• Waiting about 20–30 seconds after submission before the first query;
• Querying every 10–20 seconds afterward;
• Not resubmitting immediately just because the video is not available yet.

curl "https://api.apiyi.com/seedance/api/v3/contents/generations/tasks/YOUR_TASK_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"

• YOUR_TASK_ID: The task ID returned by the task-creation endpoint;
• YOUR_API_KEY: An API key created in the APIYI console.

​

Step 3: Handle each task status

• queued: The task is still waiting; continue waiting and querying.
• running: The task is still generating; continue waiting and querying.
• succeeded: Download the video from content.video_url immediately.
• failed: Inspect the error information in the response.
• expired: Review the task details and call logs to determine why it expired.

​

Step 4: Confirm the task status after a client timeout

1. Check whether the client response already contains a task_id.
2. Check whether the console call logs contain a task record.
3. If a task_id exists, query the original task first.
4. If no task_id is visible yet, do not conclude from the network error alone that no task was created.
5. If you cannot confirm whether the task was created, ask support to verify it before retrying.

​

How can I prevent duplicate submissions?

• Generate a unique business ID for each request.
• Store the mapping between the business ID and the Seedance task_id.
• Temporarily disable the submit button after the user submits a request.
• After a client timeout or process exit, resume by querying the original task.
• Store the prompt, model, duration, aspect ratio, and reference-material details.
• Consider a new submission only after confirming that the original task does not exist or has clearly failed.
• Distinguish in-progress statuses from terminal statuses. Do not treat queued or running as failures.

Create task: execute once
Save task_id: write it to a database or task record
Query task: poll by task_id
Recover process: read the saved task_id and continue querying

​

重複送信後の課金をどのように照合すべきですか？

Pre-charge when the task is submitted → refund the difference or settle the final amount after completion

• クライアントのタイムアウト；
• ネットワークの切断；
• failed；
• expired；
• クライアントが完全なレスポンスを受信していないこと；
• サーバー上ではタスクが作成されている可能性があるにもかかわらず、クライアントにリクエストの失敗が表示されること。

• 関連するすべてのSeedance task_idの値；
• 対応するリクエスト ID；
• 送信時刻；
• モデル名；
• 重要なリクエストパラメーター；
• コンソールの呼び出しログ；
• 課金またはチャージ記録のスクリーンショット。

​

よくある質問

​

ポーリングを停止すると、Seedance のタスクも自動的に停止しますか？

​

リクエストがタイムアウトした直後に再試行できますか？

• レスポンスに task_id が含まれているかどうか。
• コンソールの呼び出しログにタスクの記録があるかどうか。
• 元のタスクの現在のステータス。
• 対応する課金記録がすでに存在するかどうか。

​

失敗または期限切れの場合、必ず課金されていないということですか？

​

無効なパラメータが原因の HTTP 400 は課金されますか？

• パラメータ形式が無効である。
• サポートされていない解像度である。
• アスペクト比が無効である。
• サポートされていない動画の長さである。
• モデルとパラメータの組み合わせに互換性がない。

​

生成された動画のURLはどのくらい保持できますか？

​

関連ドキュメント

• Seedance 2.0 動画生成 API
• Seedance 2.0 動画生成の概要
• モデルエラーのトラブルシューティング方法

​

サポートへのお問い合わせ

• queued または running のまま、通常よりも長時間経過しているタスクがある場合；
• クライアントのタイムアウト後にタスクが作成されたかどうか確認できない場合；
• 重複送信後に複数のタスクが作成された場合；
• タスクのステータスと課金記録が一致しない場合；
• 成功したタスクで動画が返されない、またはダウンロードできない場合。

• Seedance task_id；
• リクエストID；
• 送信時刻；
• モデル名；
• 重要なリクエストパラメータ；
• コンソールの呼び出しログ；
• 関連する課金記録。