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

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

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

Чтобы использовать API генерации видео Gemini, сначала получите ваш API Token в консоли Ace Data Cloud и сохраните его для использования.

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

📘 Полная документация: API генерации видео Gemini →

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

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

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

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

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

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

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 содержит тело запроса, отправленное при создании задачи, а поле response содержит тело ответа, возвращенное после завершения задачи, например:

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

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

Начало работы

AI Чат

AI Изображение

AI Видео

AI Аудио

Веб и данные

CAPTCHA

Идентичность

Coding

Другие руководства

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

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

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

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

Пример кода CURL

Пример ответа

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

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

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

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

​Пример кода CURL

​Пример ответа

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

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

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

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

Пример кода CURL

Пример ответа

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