Інтеграція та використання API Gemini Tasks

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

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

Щоб використовувати API Gemini Videos Generation, спочатку перейдіть до консолі Ace Data Cloud для отримання вашого API Token, зберігайте його для подальшого використання.

Якщо ви ще не увійшли в систему або не зареєстровані, вас автоматично перенаправлять на сторінку входу, де вас запросять зареєструватися та увійти, після чого ви будете автоматично повернені на цю сторінку. Один API Token дозволяє викликати всі послуги платформи, не потрібно окремо подавати заявку на кожну послугу. Перший запит на отримання токена надає безкоштовний ліміт, щоб ви могли безкоштовно протестувати; при недостатньому ліміті ви можете поповнити загальний баланс в консолі.

📘 Повна документація: API Gemini Videos Generation →

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

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

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

Request Headers включає:

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

Request Body включає:

id: ID завдання, яке потрібно перевірити.
action: спосіб виконання операції над завданням, для одиночного запиту вказується retrieve.

Приклад коду CURL

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 відповіді, що повертається після завершення завдання, наприклад:

{
  "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.

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"
}'

Getting Started

AI Чат

AI Зображення

AI Відео

AI Аудіо

Веб і дані

CAPTCHA

Ідентичність

Coding

Інші посібники

Інтеграція та використання API Gemini Tasks

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

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

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

Приклад коду CURL

Приклад відповіді

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

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

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

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

​Приклад коду CURL

​Приклад відповіді

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

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

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

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

Приклад коду CURL

Приклад відповіді

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