Интеграция и использование Hailuo Tasks API

Основная функция Hailuo Tasks API заключается в том, чтобы запрашивать статус выполнения задачи, используя ID задачи, сгенерированный Hailuo Videos Generation API. В этом документе подробно описывается интеграция Hailuo Tasks API, чтобы помочь вам легко интегрировать и в полной мере использовать мощные функции этого API. С помощью Hailuo Tasks API вы можете легко реализовать запрос статуса выполнения задач Hailuo Videos Generation API.

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

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

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

📘 Полная документация: Hailuo Videos Generation API →

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

Hailuo Tasks API можно использовать для запроса результатов Hailuo Videos Generation API. Для получения информации о том, как использовать Hailuo Videos Generation API, пожалуйста, обратитесь к документации Hailuo Videos Generation API. Мы возьмем в качестве примера один ID задачи, возвращенный сервисом Hailuo Videos Generation API, и продемонстрируем, как использовать этот API. Предположим, у нас есть ID задачи: 58cc618b-9639-4ee7-add2-d2fcf260d9a3, далее мы покажем, как передать этот ID задачи.

Пример задачи

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

Request Headers включает:

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

Request Body включает:

id: загруженный ID задачи.
action: способ выполнения операции над задачей.

Настройка, как показано на следующем изображении:

Пример кода

Можно заметить, что на правой стороне страницы автоматически сгенерирован код на различных языках, как показано на изображении:

Некоторые примеры кода:

CURL

curl -X POST 'https://api.acedata.cloud/hailuo/tasks' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "id": "58cc618b-9639-4ee7-add2-d2fcf260d9a3",
  "action": "retrieve"
}'

Python

import requests

url = "https://api.acedata.cloud/hailuo/tasks"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "id": "58cc618b-9639-4ee7-add2-d2fcf260d9a3",
    "action": "retrieve"
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)

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

После успешного запроса API вернет информацию о деталях этой видео задачи. Например:

{
  "_id": "67866dff550a4144a5867aa7",
  "id": "58cc618b-9639-4ee7-add2-d2fcf260d9a3",
  "api_id": "d5af91f6-a7ec-4015-b0a5-d25051158470",
  "application_id": "2f9f4d93-9193-4c49-a1a5-eddf0ff38abb",
  "created_at": 1736863231.588,
  "started_at": 1736863231.648,
  "finished_at": 1736863300.748,
  "elapsed": 69.1,
  "credential_id": "f634e655-012e-432e-92a8-a87e4a80d636",
  "request": {
    "action": "generate",
    "prompt": "Internal heat"
  },
  "trace_id": "0c1f9f13-0aef-4d9a-a9d2-1d27055ff190",
  "user_id": "ad7afe47-cea9-4cda-980f-2ad8810e51cf",
  "response": {
    "success": true,
    "task_id": "58cc618b-9639-4ee7-add2-d2fcf260d9a3",
    "trace_id": "0c1f9f13-0aef-4d9a-a9d2-1d27055ff190",
    "data": [
      {
        "id": "2a1tbgnjdxrg80cmcmes19s33r",
        "model": "minimax-t2v",
        "prompt": "Internal heat",
        "first_image_url": null,
        "video_url": "https://platform.cdn.acedata.cloud/czjl/tjU3QYKgU96IJFgpL0eMfBFhmy0qXz9Y05P2IBhShCYaDCFUA/tmp5uligw3a.output.mp4",
        "state": "succeeded"
      }
    ]
  }
}

Возвращаемый результат содержит несколько полей, поле request — это тело запроса, отправленного для задачи, в то время как поле response — это тело ответа, возвращенное после завершения задачи. Описание полей:

id: ID, сгенерированный для этой видео задачи, используется для уникальной идентификации данной задачи по созданию видео.
request: информация о запросе в видео задаче.
response: информация о возвращаемом ответе в видео задаче.
created_at: время создания задачи, Unix временная метка (секунды, с плавающей точкой).
started_at: время начала выполнения задачи, Unix временная метка (секунды, с плавающей точкой).
finished_at: время завершения задачи, Unix временная метка (секунды, с плавающей точкой). Это поле не возвращается, если задача не завершена.
elapsed: время выполнения задачи, в секундах (с плавающей точкой, с 3 знаками после запятой). Это поле не возвращается, если задача не завершена.

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

Это запрос для получения деталей видео задач по нескольким ID задач, в отличие от предыдущего, здесь необходимо выбрать action как retrieve_batch. Request Body включает:

ids: массив загруженных ID задач.
action: способ выполнения операции над задачей.

Настройка, как показано на следующем изображении:

Пример кода

Некоторые примеры кода:

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

После успешного запроса API вернет конкретную информацию о всех пакетных видео задачах. Например:

{
  "items": [
    {
      "_id": "67866fad550a4144a587053c",
      "id": "09d4a93e-d5c8-4778-bdf2-711773d71c59",
      "api_id": "d5af91f6-a7ec-4015-b0a5-d25051158470",
      "application_id": "2f9f4d93-9193-4c49-a1a5-eddf0ff38abb",
      "created_at": 1736863661.511,
      "started_at": 1736863661.571,
      "finished_at": 1736863730.671,
      "elapsed": 69.1,
      "credential_id": "f634e655-012e-432e-92a8-a87e4a80d636",
      "request": {
        "action": "generate",
        "prompt": "Внутреннее тепло"
      },
      "trace_id": "0edc94c6-4938-4bff-bb16-20364c254e40",
      "user_id": "ad7afe47-cea9-4cda-980f-2ad8810e51cf",
      "response": {
        "success": true,
        "task_id": "09d4a93e-d5c8-4778-bdf2-711773d71c59",
        "trace_id": "0edc94c6-4938-4bff-bb16-20364c254e40",
        "data": [
          {
            "id": "24zdgea0s1rge0cmcmjbsfj2m8",
            "model": "minimax-t2v",
            "prompt": "Внутреннее тепло",
            "first_image_url": null,
            "video_url": "https://platform.cdn.acedata.cloud/czjl/6cTYBRBDVJIQANzG7GaPwPblbeIiFe4yUDcVoMkkXttqJCFUA/tmpm4ke45c5.output.mp4",
            "state": "succeeded"
          }
        ]
      }
    },
    {
      "_id": "67866dff550a4144a5867aa7",
      "id": "58cc618b-9639-4ee7-add2-d2fcf260d9a3",
      "api_id": "d5af91f6-a7ec-4015-b0a5-d25051158470",
      "application_id": "2f9f4d93-9193-4c49-a1a5-eddf0ff38abb",
      "created_at": 1736863231.588,
      "started_at": 1736863231.648,
      "finished_at": 1736863300.748,
      "elapsed": 69.1,
      "credential_id": "f634e655-012e-432e-92a8-a87e4a80d636",
      "request": {
        "action": "generate",
        "prompt": "Внутреннее тепло"
      },
      "trace_id": "0c1f9f13-0aef-4d9a-a9d2-1d27055ff190",
      "user_id": "ad7afe47-cea9-4cda-980f-2ad8810e51cf",
      "response": {
        "success": true,
        "task_id": "58cc618b-9639-4ee7-add2-d2fcf260d9a3",
        "trace_id": "0c1f9f13-0aef-4d9a-a9d2-1d27055ff190",
        "data": [
          {
            "id": "2a1tbgnjdxrg80cmcmes19s33r",
            "model": "minimax-t2v",
            "prompt": "Внутреннее тепло",
            "first_image_url": null,
            "video_url": "https://platform.cdn.acedata.cloud/czjl/tjU3QYKgU96IJFgpL0eMfBFhmy0qXz9Y05P2IBhShCYaDCFUA/tmp5uligw3a.output.mp4",
            "state": "succeeded"
          }
        ]
      }
    }
  ],
  "count": 2
}

返回结果一共有多个字段，其中items是包含了批量视频任务的具体详情信息，每个视频任务的具体信息与上文的字段一样，字段信息如下。

items，批量视频任务的所有具体详情信息。它是一个数组，每个数组的元素 и上文查询单个任务的返回结果格式是一样的。
count，此处批量查询视频任务的个数。

CURL

curl -X POST 'https://api.acedata.cloud/hailuo/tasks' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "ids": ["09d4a93e-d5c8-4778-bdf2-711773d71c59","58cc618b-9639-4ee7-add2-d2fcf260d9a3"],
  "action": "retrieve_batch"
}'

Python

import requests

url = "https://api.acedata.cloud/hailuo/tasks"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "ids": ["09d4a93e-d5c8-4778-bdf2-711773d71c59","58cc618b-9639-4ee7-add2-d2fcf260d9a3"],
    "action": "retrieve_batch"
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)

Ошибка обработки

В случае возникновения ошибки при вызове API, API вернет соответствующий код ошибки и информацию. Например:

400 token_mismatched：Неверный запрос, возможно, из-за отсутствия или недопустимых параметров.
400 api_not_implemented：Неверный запрос, возможно, из-за отсутствия или недопустимых параметров.
401 invalid_token：Неавторизован, недопустимый или отсутствующий токен авторизации.
429 too_many_requests：Слишком много запросов, вы превысили лимит частоты.
500 api_error：Внутренняя ошибка сервера, что-то пошло не так на сервере.

Пример ответа об ошибке

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "fetch failed"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

Заключение

С помощью этого документа вы узнали, как использовать Hailuo Tasks API для запроса всех конкретных деталей о единичных или пакетных видео задачах. Надеемся, что этот документ поможет вам лучше интегрировать и использовать этот API. Если у вас есть какие-либо вопросы, пожалуйста, не стесняйтесь обращаться в нашу техническую поддержку.

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

AI Чат

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

AI Видео

AI Аудио

Веб и данные

CAPTCHA

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

Прокси

Продвинутый

Coding

Интеграция и использование Hailuo Tasks API

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

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

Пример задачи

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

Пример кода

CURL

Python

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

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

Пример кода

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

CURL

Python

Ошибка обработки

Пример ответа об ошибке

Заключение

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

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

​Пример задачи

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

​Пример кода

​CURL

​Python

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

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

​Пример кода

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

​CURL

​Python

​Ошибка обработки

​Пример ответа об ошибке

​Заключение

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

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

Пример задачи

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

Пример кода

CURL

Python

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

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

Пример кода

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

CURL

Python

Ошибка обработки

Пример ответа об ошибке

Заключение