> ## Documentation Index
> Fetch the complete documentation index at: https://docs.acedata.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Grok Tasks API の接続と使用

> Grok API guide - Ace Data Cloud

Grok Tasks API の主な機能は、Grok Videos Generation API によって生成されたタスク ID を入力することで、そのタスクの実行状況を照会することです。

この文書では、Grok Tasks API の接続説明を詳しく紹介し、Grok Videos Generation API のタスク実行状況を簡単に統合して照会できるようにします。

## 申請プロセス

Grok Videos Generation API を使用するには、まず [Ace Data Cloud コンソール](https://platform.acedata.cloud/console/applications) で API トークンを取得し、バックアップとして保管してください。

![](https://cdn.acedata.cloud/dvc3cg.jpg)

まだログインまたは登録していない場合は、自動的にログインページにリダイレクトされ、登録とログインを促されます。完了後、現在のページに自動的に戻ります。

**1つの API トークンでプラットフォームのすべてのサービスを呼び出すことができ、各サービスごとに個別に申請する必要はありません。** 初回申請時には無料のクレジットが付与され、無料で体験できます。クレジットが不足した場合は、[コンソール](https://platform.acedata.cloud/console/coin) で共通残高をチャージできます。

> 📘 完全な文書：[Grok Videos Generation API →](https://platform.acedata.cloud/documents/grok-videos)

## リクエスト例

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

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

**リクエストヘッダー** には以下が含まれます：

* `accept`：JSON形式のレスポンス結果を受け取ることを指定し、ここには `application/json` を記入します。
* `authorization`：APIを呼び出すためのキーで、申請後に直接ドロップダウンから選択できます。

**リクエストボディ** には以下が含まれます：

* `id`：照会するタスク ID。
* `action`：タスクの操作方法、単一の照会には `retrieve` を記入します。

### CURL コード例

```bash theme={null}
curl -X POST 'https://api.acedata.cloud/grok/tasks' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "id": "b8976e18-32dc-4718-9ed8-1ea090fcb6ea",
  "action": "retrieve"
}'
```

### レスポンス例

リクエストが成功すると、API はこのタスクの詳細情報を返します。ここでの `request` フィールドはタスクを開始したときのリクエストボディで、`response` フィールドはタスク完了後に返されるレスポンスボディです。例えば：

```json theme={null}
{
  "id": "b8976e18-32dc-4718-9ed8-1ea090fcb6ea",
  "started_at": 1769262721.823,
  "finished_at": 1769262729.623,
  "elapsed": 7.8,
  "request": {
    "prompt": "A cinematic shot of a kitten chasing a butterfly in a sunlit garden",
    "model": "grok-imagine-video-1.5-fast:reverse",
    "resolution": "480p",
    "duration": 8
  },
  "type": "videos",
  "response": {
    "success": true,
    "task_id": "b8976e18-32dc-4718-9ed8-1ea090fcb6ea",
    "trace_id": "fb751e1e-4705-49ea-9fd4-5024b7865ea2",
    "data": [
      {
        "id": "grok-imagine-video-1.5-fast:reverse:41eb9a5f-3b2d-4d1e-9f5a-6c2f1a0b9e77",
        "video_url": "https://cdn.acedata.cloud/c8cbf53aa0.mp4",
        "state": "succeeded"
      }
    ]
  }
}
```

フィールドの説明は以下の通りです：

* `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` を記入します。

```bash theme={null}
curl -X POST 'https://api.acedata.cloud/grok/tasks' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "ids": ["b8976e18-32dc-4718-9ed8-1ea090fcb6ea"],
  "action": "retrieve_batch"
}'
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.