メインコンテンツへスキップ
Grok Tasks API の主な機能は、Grok Videos Generation API によって生成されたタスク ID を入力することで、そのタスクの実行状況を照会することです。 この文書では、Grok Tasks API の接続説明を詳しく紹介し、Grok Videos Generation API のタスク実行状況を簡単に統合して照会できるようにします。

申請プロセス

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

リクエスト例

Grok Tasks API は、Grok Videos Generation API の結果を照会するために使用できます。

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

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

CURL コード例

レスポンス例

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

バッチ照会操作

複数のタスク ID のタスク詳細を照会する場合は、action を retrieve_batch に設定し、ids でタスク ID の配列を渡します: リクエストボディ には以下が含まれます:
  • ids:照会するタスク ID の配列。
  • action:タスクの操作方法、バッチ照会には retrieve_batch を記入します。