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

# Интеграция и использование API задач Gemini

> Gemini AI API guide - Ace Data Cloud

Основная функция API задач Gemini заключается в том, чтобы запрашивать статус выполнения задач, сгенерированных с помощью API генерации видео Gemini, по введенному идентификатору задачи.

В этом документе подробно описывается интеграция API задач Gemini, чтобы помочь вам легко интегрировать и запрашивать статус выполнения задач API генерации видео Gemini.

## Процесс подачи заявки

Чтобы использовать API генерации видео Gemini, сначала получите ваш API Token в [консоли Ace Data Cloud](https://platform.acedata.cloud/console/applications) и сохраните его для использования.

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

Если вы еще не вошли в систему или не зарегистрированы, вы будете автоматически перенаправлены на страницу входа, где вас пригласят зарегистрироваться и войти. После завершения вы будете автоматически возвращены на текущую страницу.

**Один API Token позволяет вызывать все сервисы платформы, не нужно отдельно запрашивать для каждого сервиса.** При первом запросе предоставляется бесплатный лимит, чтобы вы могли попробовать; при недостаточном лимите вы можете пополнить общий баланс в [консоли](https://platform.acedata.cloud/console/coin).

> 📘 Полная документация: [API генерации видео Gemini →](https://platform.acedata.cloud/documents/gemini-videos)

## Пример запроса

API задач Gemini можно использовать для запроса результатов API генерации видео Gemini.

### Установка заголовков запроса и тела запроса

**Заголовки запроса** включают:

* `accept`: указывает на прием ответа в формате JSON, здесь указывается `application/json`.
* `authorization`: ключ для вызова API, после запроса можно выбрать из выпадающего списка.

**Тело запроса** включает:

* `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": "Кинематографический кадр котенка, гоняющегося за бабочкой в солнечном саду",
    "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`: идентификатор сгенерированной задачи, используемый для уникальной идентификации этой задачи.
* `request`: информация о запросе в задаче.
* `response`: информация о возвращенном ответе в задаче.
* `created_at`: время создания задачи, Unix временная метка (секунды, с плавающей точкой).
* `started_at`: время начала выполнения задачи, Unix временная метка (секунды, с плавающей точкой).
* `finished_at`: время завершения задачи, Unix временная метка (секунды, с плавающей точкой). Это поле не возвращается, если задача не завершена.
* `elapsed`: время выполнения задачи, в секундах (с плавающей точкой, с 3 знаками после запятой). Это поле не возвращается, если задача не завершена.

## Пакетный запрос

Для запроса деталей нескольких идентификаторов задач установите `action` в `retrieve_batch` и передайте массив идентификаторов задач через `ids`:

**Тело запроса** включает:

* `ids`: массив идентификаторов задач, которые нужно запросить.
* `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.