Документация API HappyHorse

Полное руководство по интеграции API генерации видео HappyHorse 1.0 в ваши приложения.

API v1.0 Base URL: https://happyhorse.app

Быстрый старт

bash

curl -X POST 'https://happyhorse.app/api/generate' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "happyhorse-1.0/video",
    "prompt": "A cinematic shot of mountains at sunrise",
    "mode": "pro",
    "duration": 5,
    "aspect_ratio": "16:9"
  }'

Аутентификация

Все запросы к API требуют токена Bearer в заголовке Authorization.

Получить API-ключ: API-ключ можно получить на странице API Keys в панели управления. → Получить API-ключ

http

Authorization: Bearer YOUR_API_KEY

Доступные модели

HappyHorse 1.0

Высококачественная генерация видео с ИИ на базе HappyHorse

Тип	Описание	Длительность	Кредиты
`pro (text-to-video)`	Текст в видео, качество Pro	3-15s	54/s (no audio) · 80/s (with audio)
`pro (image-to-video)`	Изображение в видео, качество Pro	3-15s	54/s (no audio) · 80/s (with audio)
`std (text-to-video)`	Текст в видео, стандартное качество	3-15s	40/s (no audio) · 60/s (with audio)
`std (image-to-video)`	Изображение в видео, стандартное качество	3-15s	40/s (no audio) · 60/s (with audio)

Конечные точки API

Создаёт задачу генерации видео. Поле model должно быть 'happyhorse-1.0/video'.

Тело запроса

Параметры телаJSON

model:string

Имя модели — 'happyhorse-1.0/video'

prompt:optional string

Текстовое описание видео (до 2500 символов). Не обязательно, если multi_shots равно true.

mode:optional string

Режим качества: 'pro' или 'std' (по умолчанию: std) Defaults to std.

duration:optional number

Длительность в секундах (3–15, по умолчанию: 5) Defaults to 5.

aspect_ratio:optional string

Соотношение сторон (16:9, 9:16, 1:1) Defaults to 16:9.

image_urls:optional string[]

Массив URL изображений для image-to-video

sound:optional boolean

Включить нативное аудио (по умолчанию: true) Defaults to true.

cfg_scale:optional number

Сила следования промпту (0-1, по умолчанию: 0.5). Более высокие значения точнее следуют промпту. Defaults to 0.5.

multi_shots:optional boolean

Режим нескольких кадров с несколькими промптами Defaults to false.

multi_prompt:optional array

Массив объектов 'prompt, duration' для multi-shot

happyhorse_elements:optional array

Массив объектов элементов. В тексте промпта пишите @ и сразу значение поля name (например name 'element_dog' → в промпте @element_dog). Каждый элемент: name, description, element_input_urls (2-4 URL изображений). Не более 3 элементов на задачу.

Текст в видео

json

{
  "model": "happyhorse-1.0/video",
  "prompt": "A majestic eagle soaring through clouds at sunset",
  "mode": "pro",
  "duration": 5,
  "aspect_ratio": "16:9",
  "sound": true
}

Изображение в видео

json

{
  "model": "happyhorse-1.0/video",
  "prompt": "The character slowly turns and smiles",
  "mode": "pro",
  "image_urls": ["https://example.com/my-image.jpg"],
  "duration": 5
}

Мультикадровое видео

json

{
  "model": "happyhorse-1.0/video",
  "mode": "pro",
  "multi_shots": true,
  "multi_prompt": [
    { "prompt": "A woman walks into a coffee shop", "duration": 3 },
    { "prompt": "She orders a latte and sits by the window", "duration": 4 },
    { "prompt": "She looks outside and smiles", "duration": 3 }
  ],
  "aspect_ratio": "16:9"
}

Ответы

Task created successfully

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n92abc123hh10",
    "status": "IN_PROGRESS"
  }
}

Проверка статуса генерации по task_id из ответа generate.

Параметры запроса

task_id:string

Уникальный ID задачи из generate (префикс n92)

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

bash

curl -X GET 'https://happyhorse.app/api/status?task_id=n92abc123hh10' \
  -H 'Authorization: Bearer YOUR_API_KEY'

Подсказка: Поле response содержит массив resultUrls. URL видео: data.response.resultUrls[0].

javascript

// Extract video URL from response
const videoUrl = data.response.resultUrls[0];

Ответы

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n92abc123hh10",
    "status": "SUCCESS",
    "consumed_credits": 400,
    "created_at": "2026-04-08T10:30:00Z",
    "type": "text-to-video",
    "request": {
      "model": "happyhorse-1.0/video",
      "prompt": "A majestic eagle soaring through clouds at sunset",
      "mode": "pro",
      "duration": 5,
      "aspect_ratio": "16:9"
    },
    "response": {
      "resultUrls": [
        "https://cdn.example.com/videos/abc123.mp4"
      ]
    },
    "error_message": null
  }
}

Песочница API

Тестируйте API прямо в браузере. Замените YOUR_API_KEY на свой ключ.

Песочница APIPOST

Базовый URL

Конечная точка

Заголовки

Тело запроса

Коды ошибок

HTTP-статус	Код	Описание
400 Неверный запрос	INVALID_PROMPT	Промпт недействителен или пуст
400 Неверный запрос	INVALID_DURATION	Длительность вне допустимого диапазона (3–15 с)
400 Неверный запрос	INVALID_MODEL	Модель должна быть 'happyhorse-1.0/video'
401 Не авторизован	INVALID_API_KEY	API-ключ отсутствует или недействителен
402 Требуется оплата	INSUFFICIENT_CREDITS	Недостаточно кредитов для операции
429 Слишком много запросов	RATE_LIMITED	Слишком много запросов, снизьте частоту
500 Внутренняя ошибка сервера	INTERNAL_ERROR	Ошибка сервера, повторите позже