Dreamina Tasks API の接続と使用
Dreamina Tasks API は、Dreamina Video Generation API によって作成されたデジタル人動画タスクの実行結果を照会するために使用されます。生成インターフェースにcallback_url または async: true を渡すと、インターフェースはすぐに task_id を返します。このインターフェースを使用して、task_id または trace_id によってタスクの状態と最終動画のアドレスをポーリングできます。このインターフェースは無料です。
申請プロセス
Dreamina シリーズ API を使用するには、まず Ace Data Cloud コンソール で API トークンを取得し、保管してください。 まだログインまたは登録していない場合は、自動的にログインページにリダイレクトされ、登録とログインを促されます。完了後、現在のページに自動的に戻ります。 1つの API トークンでプラットフォームのすべてのサービスを呼び出すことができ、各サービスごとに個別に申請する必要はありません。 初回申請時には無料のクレジットが付与され、無料で体験できます。クレジットが不足した場合は、コンソール で一般残高をチャージできます。リクエストパラメータ
リクエストヘッダーaccept：JSON形式のレスポンス結果を受け取ることを指定し、application/jsonを記入します。authorization：APIを呼び出すためのキーで、形式はBearer {token}です。content-type：application/jsonを記入します。
単一タスクを照会する場合、idとtrace_idのいずれかを提供する必要があります。
単一タスクの照会
CURL
Python
レスポンス例
リクエストが成功すると、API はそのタスクの詳細を返します。request はタスク作成時のリクエストボディで、response はタスク完了後のレスポンスボディであり、data.video_url は生成されたデジタル人動画のアドレスです：
id：今回の動画生成タスクのユニーク ID。trace_id：今回のリクエストのトレース ID、問題のトラブルシューティングに使用。request：タスク作成時に提出されたリクエスト内容。response：タスク完了後に返されるレスポンス内容。response.data.statusがdoneの場合、response.data.video_urlが最終動画のアドレスです。created_at：タスク作成時間、Unix タイムスタンプ（秒、浮動小数点）。started_at：タスク開始実行時間、Unix タイムスタンプ（秒、浮動小数点）。finished_at：タスク完了時間、Unix タイムスタンプ（秒、浮動小数点）。タスクが未完了の場合、このフィールドは返されません。elapsed：タスク実行にかかった時間、単位は秒（浮動小数点、3桁の小数点以下）。タスクが未完了の場合、このフィールドは返されません。
タスクがまだ完了していない場合、statusはdone以外の状態である可能性があります。タスクが存在しないか、結果がまだ生成されていない場合、インターフェースは空のオブジェクト{}を返しますので、後で再試行してください。
バッチタスクの照会
action を retrieve_batch に設定し、ids 配列を渡します：
items はバッチタスクの詳細配列（各要素は単一照会結果の形式と一致）で、count は今回返されたタスクの数です。
エラー処理
API を呼び出す際にエラーが発生した場合、対応するエラーコードとメッセージが返されます：400 bad_request：リクエストエラー、id/trace_idなどの必要なパラメータが不足している可能性があります。401 invalid_token：未承認、承認トークンが無効または欠落しています。429 too_many_requests：リクエストが多すぎます、レート制限を超えました。500 api_error：サーバー内部エラー。
エラーレスポンス例
結論
この文書を通じて、Dreamina Tasks API を使用して単一またはバッチのデジタル人動画タスクの結果を照会する方法を理解しました。生成インターフェースのcallback_url / async 非同期モードと組み合わせることで、安定したポーリングを実現できます。ご不明な点がございましたら、いつでも技術サポートチームにお問い合わせください。