> ## 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.

# Gemini Tasks API の対接と使用

> Gemini AI API guide - Ace Data Cloud

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

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

## 申請プロセス

Gemini 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) で共通残高をチャージできます。

> 📘 完全なドキュメント：[Gemini Videos Generation API →](https://platform.acedata.cloud/documents/gemini-videos)

## リクエスト例

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

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

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

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

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

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

### CURL コード例

```bash theme={null}
curl -X POST 'https://api.acedata.cloud/gemini/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": 1769262730.723,
  "elapsed": 8.9,
  "request": {
    "prompt": "A cinematic shot of a kitten chasing a butterfly in a sunlit garden",
    "model": "omni-flash",
    "aspect_ratio": "16:9"
  },
  "type": "videos",
  "response": {
    "success": true,
    "task_id": "b8976e18-32dc-4718-9ed8-1ea090fcb6ea",
    "trace_id": "fb751e1e-4705-49ea-9fd4-5024b7865ea2",
    "data": [
      {
        "id": "omni-flash:job_01k777hjrbfrgs2060q5zvf2a5",
        "video_url": "https://cdn.acedata.cloud/gemini/example-video.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/gemini/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.