HappyHorse 1.1 - Image to Video

happyhorse-1.1-i2v HappyHorse 1.1 Image to Video генерирует высококачественные видео из одного изображения, сохраняя внешний вид объекта, визуальный стиль и мелкие детали, создавая при этом естественное движение. Идеально подходит для демонстраций продуктов, анимации персонажей и создания видео для соцсетей.

Эндпоинты

POST /v1/queue/happyhorse-1.1-i2v # Создать задачу

GET /v1/queue/happyhorse-1.1-i2v/requests/{request_id}/status # Проверить статус

GET /v1/queue/happyhorse-1.1-i2v/requests/{request_id}/response # Получить результат

PUT /v1/queue/happyhorse-1.1-i2v/requests/{request_id}/cancel # Отменить задачу

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

curl --location "https://api.odirouter.ai/model/v1/queue/happyhorse-1.1-i2v" \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "prompt": "A red apple slowly rotating on a white table, clean studio lighting, static camera.",
    "media": [
      {
        "type": "first_frame",
        "url": "https://example.com/reference-image.webp"
      }
    ],
    "duration": 5,
    "resolution": "720P"
  }'

prompt string

Текстовый промпт для описания содержимого генерируемого видео. Поддерживаются китайский и английский языки, например The horse starts running forward through the field. Максимальная длина: 2500 китайских иероглифов или 5000 символов на других языках; содержимое сверх лимита автоматически обрезается.

media array required

Массив входных медиа. Необходимо передать ровно одно изображение первого кадра.

type string required

Тип медиа, фиксированное значение: first_frame.

url string required

URL изображения первого кадра или данные изображения в Base64.

Требования к изображению:

Поддерживаемые форматы: JPEG, JPG, PNG, WEBP

Ширина и высота: обе стороны не менее 300 пикселей

Соотношение сторон: от 1:2.5 до 2.5:1

Размер файла: до 20MB

Формат ввода:

Публично доступный HTTP- или HTTPS-URL

Формат Base64: data:<MIME_type>;base64,<base64_data>

MIME-типы: для JPEG/JPG используется image/jpeg, для PNG — image/png, для WEBP — image/webp.

Используйте публично доступный URL, например https://example.com/first-frame.jpg.

duration int

Длительность видео в секундах. Списание рассчитывается по секундам успешно сгенерированного выходного видео, поэтому этот параметр влияет на стоимость.

Диапазон: 3 - 15

По умолчанию: 5

resolution string

Разрешение видео. Для разных уровней разрешения применяются разные тарифы, поэтому этот параметр влияет на стоимость.

Варианты: 720P, 1080P

По умолчанию: 1080P

seed int

Случайное зерно. Если не указано, система автоматически сгенерирует случайное значение. Чтобы повысить воспроизводимость, используйте одно и то же значение seed при повторных вызовах.

Диапазон: 0 - 2147483647

watermark bool

Добавлять ли водяной знак в правый нижний угол сгенерированного видео. Фиксированный текст водяного знака: Happy Horse.

По умолчанию: true

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

{
  "request_id": "mmsu_01hxyz...",
  "response_url": "https://api.odirouter.ai/model/v1/queue/happyhorse-1.1-i2v/requests/mmsu_01hxyz.../response",
  "status_url": "https://api.odirouter.ai/model/v1/queue/happyhorse-1.1-i2v/requests/mmsu_01hxyz.../status",
  "cancel_url": "https://api.odirouter.ai/model/v1/queue/happyhorse-1.1-i2v/requests/mmsu_01hxyz.../cancel",
  "queue_position": 0
}

Поле	Тип	Описание
`request_id`	string	Идентификатор задачи, используемый во всех последующих операциях.
`response_url`	string	URL для получения итогового результата.
`status_url`	string	URL для проверки статуса задачи.
`cancel_url`	string	URL для отмены задачи.
`queue_position`	int	Текущая позиция в очереди.

Следующие операции