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

> Gemini AI API guide - Ace Data Cloud

Основна функція API Gemini Tasks полягає в тому, щоб за допомогою введеного ID завдання, згенерованого API Gemini Videos Generation, перевіряти стан виконання цього завдання.

Цей документ детально описує інструкції з інтеграції API Gemini Tasks, щоб допомогти вам легко інтегрувати та перевіряти стан виконання завдань API Gemini Videos Generation.

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

Щоб використовувати API Gemini Videos Generation, спочатку перейдіть до [консолі 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).

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

## Приклад запиту

API Gemini Tasks можна використовувати для перевірки результатів API Gemini Videos Generation.

### Налаштування заголовків запиту та тіла запиту

**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` містить body запиту, що ініціював завдання, а поле `response` містить body відповіді, що повертається після завершення завдання, наприклад:

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

## Пакетний запит

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

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