> ## 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 整合指南 - 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 Token，留作備用。

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

如果你尚未登錄或註冊，會自動跳轉到登錄頁面邀請你註冊和登錄，完成後會自動返回當前頁面。

**一個 API Token 即可調用平台所有服務，無需為每個服務單獨申請。** 首次申請會贈送免費額度，可免費體驗；額度不足時可在 [控制台](https://platform.acedata.cloud/console/coin) 充值通用餘額。

> 📘 完整文檔：[Gemini Videos Generation API →](https://platform.acedata.cloud/documents/gemini-videos)

## 請求示例

Gemini Tasks API 可以用於查詢 Gemini Videos Generation API 的結果。

### 設置請求頭和請求體

**Request Headers** 包括：

* `accept`：指定接收 JSON 格式的響應結果，這裡填寫為 `application/json`。
* `authorization`：調用 API 的密鑰，申請之後可以直接下拉選擇。

**Request Body** 包括：

* `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` 字段是發起任務時的 request body，`response` 字段是任務完成後返回的 response body，例如：

```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 陣列：

**Request Body** 包括：

* `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.