Skip to main content
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 を記入します。