メインコンテンツへスキップ
GET
Retrieve task
動画タスクと画像タスクは、同じ /v1/tasks/{task_id} を使用します。/v1/videos/generations を送信して task_id を取得した後、この API でポーリングします。

リクエスト

処理中のレスポンス

成功時のレスポンス

タスクが completed になると、/v1/videos/{task_id}/content から生成された動画を取得できます(Bearer 認証が必要です)。
製品内でエンドユーザーに動画を表示する場合は、サーバー側でこのダウンロードをプロキシすることを推奨します。まずキーを使って動画を取得し、その後に独自の認証を通して配信することで、DimiLinks のキーがブラウザに露出するのを防げます。

失敗時のレスポンス

ステータス

ポーリングに関する推奨事項

  • 3〜5 秒ごとに照会してください。画像タスクより少し長めの間隔です。
  • 1 タスクあたりのポーリングは最長 10 分を推奨します。タイムアウトした場合は、ユーザーに失敗を伝え、再試行できるようにしてください。
  • 404 が発生したらすぐにポーリングを停止してください。タスク ID が誤っているか、現在のキーに属していない可能性が高いです。

承認

Authorization
string
header
必須

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

パスパラメータ

task_id
string
必須

レスポンス

Image or video task

task_id
string
必須
例:

"task_xxx"

status
enum<string>
必須
利用可能なオプション:
NOT_START,
SUBMITTED,
QUEUED,
IN_PROGRESS,
SUCCESS,
FAILURE
progress
string
必須
Pattern: ^[0-9]{1,3}%$
例:

"50%"

created_at
integer
必須
platform
string
例:

"openai"

fail_reason
string
finished_at
integer
data
object