Skip to main content
SeeDream Tasks API の主な機能は、SeeDream Images Generation API によって生成されたタスクIDを入力することで、そのタスクの実行状況を照会することです。 この文書では、SeeDream Tasks API の接続説明を詳しく紹介し、簡単に統合し、この API の強力な機能を十分に活用できるようにします。SeeDream Tasks API を使用することで、SeeDream Images Generation API のタスク実行状況を簡単に照会できます。

​
申請プロセス

SeeDream Images Generation API を使用するには、まず Ace Data Cloud コンソール で API トークンを取得し、保管してください。 まだログインまたは登録していない場合は、自動的にログインページにリダイレクトされ、登録とログインを促されます。完了後、現在のページに自動的に戻ります。 1つの API トークンでプラットフォームのすべてのサービスを呼び出すことができ、各サービスごとに個別に申請する必要はありません。 初回申請時には無料のクレジットが付与され、無料で体験できます。クレジットが不足した場合は、コンソール で一般残高をチャージできます。
📘 完全な文書：SeeDream Images Generation API →

​
リクエスト例

SeeDream Tasks API は、SeeDream Images Generation API の結果を照会するために使用できます。SeeDream Images Generation API の使用方法については、文書 SeeDream Images Generation API を参照してください。 SeeDream Images Generation API サービスから返されたタスクIDを例に、どのようにこの API を使用するかを示します。タスクID：20068983-0cc9-4c6a-aeb6-9c6a3c668be0 があると仮定し、次にタスクIDを渡す方法を示します。

​
タスク例の画像

​
リクエストヘッダーとリクエストボディの設定

リクエストヘッダー には以下が含まれます：
  • accept：JSON形式のレスポンス結果を受け取ることを指定し、ここでは application/json を記入します。
  • authorization：APIを呼び出すためのキーで、申請後に直接ドロップダウンから選択できます。
リクエストボディ には以下が含まれます：
  • id：アップロードされたタスクID。
  • action：タスクの操作方法。
設定は以下の図のようになります：

​
コード例

ページの右側には、さまざまな言語のコードが自動生成されていることがわかります。以下の図のように：

一部のコード例は以下の通りです：

​
CURL

​
レスポンス例

リクエストが成功すると、API はこのタスクの詳細情報を返します。例えば：
返された結果には複数のフィールドがあり、以下のように説明されます：
  • success：この時点でのビデオ生成タスクの状態。
  • task_id：この時点でのビデオ生成タスク ID。
  • trace_id：この時点でのビデオ生成トレース ID。
  • data：この時点での画像生成タスクの結果リスト。
    • image_url：この時点での画像生成タスクのリンク。
    • prompt：プロンプト。
    • size: 生成された画像のピクセル。

​
バッチ照会操作

これは複数のタスクIDに対してタスクの詳細を照会するもので、上記とは異なり、action を retrieve_batch に設定する必要があります。 リクエストボディ には以下が含まれます：
  • ids：アップロードされたタスクIDの配列。
  • action：タスクの操作方法。
設定は以下の図のようになります：

​
コード例

一部のコード例は以下の通りです：

​
レスポンス例

リクエストが成功すると、API は今回のすべてのバッチタスクの具体的な詳細情報を返します。例えば：
返却結果には複数のフィールドが含まれており、itemsはバッチタスクの具体的な詳細情報を含んでいます。各タスクの具体的な情報は上記のフィールドと同じです。
  • items、バッチタスクのすべての具体的な詳細情報。これは配列であり、各配列の要素は上記の単一タスクの返却結果の形式と同じです。
  • count、ここでのバッチクエリタスクの数。
バッチ結果の各タスクオブジェクトには、以下のタイミングフィールドも含まれています。
  • created_at、タスク作成時間、Unixタイムスタンプ（秒、浮動小数点）。
  • started_at、タスク開始実行時間、Unixタイムスタンプ（秒、浮動小数点）。
  • finished_at、タスク完了時間、Unixタイムスタンプ（秒、浮動小数点）。タスクが未完了の場合、このフィールドは返されません。
  • elapsed、タスク実行にかかった時間、単位は秒（浮動小数点、3桁の小数点以下）。タスクが未完了の場合、このフィールドは返されません。

​
CURL

​
エラーハンドリング

APIを呼び出す際にエラーが発生した場合、APIは対応するエラーコードと情報を返します。例えば：
  • 400 token_mismatched：不正なリクエスト、パラメータが不足しているか無効である可能性があります。
  • 400 api_not_implemented：不正なリクエスト、パラメータが不足しているか無効である可能性があります。
  • 401 invalid_token：認証されていない、無効または不足している認証トークン。
  • 429 too_many_requests：リクエストが多すぎます、レート制限を超えました。
  • 500 api_error：内部サーバーエラー、サーバーで何かがうまくいきませんでした。

​
エラー応答の例

​
結論

この文書を通じて、SeeDream Tasks APIを使用して単一またはバッチタスクのすべての具体的な詳細情報を照会する方法を理解しました。この文書がAPIの接続と使用に役立つことを願っています。ご不明な点がございましたら、いつでも技術サポートチームにお問い合わせください。