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

​
申請プロセス

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

​
リクエスト例

Producer Tasks API は、Producer Audios Generation API の結果を照会するために使用できます。Producer Audios Generation API の使用方法については、文書 Producer Audios Generation API を参照してください。 ここでは、Producer Audios Generation API サービスから返されたタスクIDの例を用いて、この API の使用方法を示します。タスクID：1a6ac2ad-10f2-4e2b-b500-66ec27fe82ad があると仮定し、次にタスクIDを渡す方法を示します。

​
タスク例の画像

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

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

​
コード例

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

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

​
CURL

​
レスポンス例

リクエストが成功すると、API はこのタスクの詳細情報を返します。例えば：
返された結果には複数のフィールドがあり、request フィールドはタスクを開始したときの request body であり、response フィールドはタスク完了後に返される response body です。フィールドの説明は以下の通りです。
  • id、生成タスクのID、今回の生成タスクを一意に識別するために使用されます。
  • request、クエリタスク内のリクエスト情報。
  • response、クエリタスク内の返却情報。
  • created_at、タスク作成時間、Unixタイムスタンプ（秒、浮動小数点）。
  • started_at、タスク開始実行時間、Unixタイムスタンプ（秒、浮動小数点）。
  • finished_at、タスク完了時間、Unixタイムスタンプ（秒、浮動小数点）。タスクが未完了の場合、このフィールドは返されません。
  • elapsed、タスク実行にかかった時間、単位は秒（浮動小数点、3桁の小数点以下を保持）。タスクが未完了の場合、このフィールドは返されません。

​
バッチクエリ操作

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

​
コード例

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

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

​
レスポンス例

リクエストが成功した後、APIは今回のすべてのバッチタスクの具体的な詳細情報を返します。例えば：

​
CURL

​
エラー処理

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

​
エラー応答の例

​
結論

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