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

API HappyHorse Tasks используется для запроса задач на создание или редактирование видео, созданных с помощью API HappyHorse Videos.

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

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

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

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

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

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

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

Request Headers включает:

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

Request Body включает:

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

Пример кода CURL

curl -X POST 'https://api.acedata.cloud/happyhorse/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": 1769262774.423,
  "elapsed": 52.6,
  "request": {
    "action": "generate",
    "model": "happyhorse-1.1-t2v",
    "prompt": "Кинематографический кадр белой лошади, бегущей по пляжу при лунном свете",
    "resolution": "720P",
    "duration": 5
  },
  "type": "videos",
  "response": {
    "success": true,
    "task_id": "b8976e18-32dc-4718-9ed8-1ea090fcb6ea",
    "trace_id": "fb751e1e-4705-49ea-9fd4-5024b7865ea2",
    "data": [
      {
        "id": "1469cfc3-3004-4d9e-ab10-xxxxxx",
        "video_url": "https://cdn.acedata.cloud/happyhorse/c8cbf53aa0.mp4",
        "state": "succeeded",
        "duration": 5,
        "resolution": "720P",
        "ratio": "16:9"
      }
    ]
  }
}

Описание полей:

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

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

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

curl -X POST 'https://api.acedata.cloud/happyhorse/tasks' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "ids": ["b8976e18-32dc-4718-9ed8-1ea090fcb6ea"],
  "action": "retrieve_batch"
}'

В возвращаемом результате будут содержаться поля items и count, где items — массив деталей задач, а count — количество задач, соответствующих запросу.

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

AI Чат

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

AI Видео

AI Аудио

Веб и данные

CAPTCHA

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

Coding

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

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

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

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

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

Пример кода CURL

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

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

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

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

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

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

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

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

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

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

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

Пример кода CURL

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

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