Skip to main content
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

id
string
:

"img_xxx"

task_id
string
:

"img_xxx"

object
string
:

"image.task"

status
enum<string>
利用可能なオプション:
queued,
in_progress,
succeeded,
failed
progress
integer
必須範囲: 0 <= x <= 100
created_at
integer
completed_at
integer
result
object
error
object