HappyHorse 1.0 Reference to Video

happyhorse-1.0-r2v HappyHorse 1.0 Reference to Video использует референсы для сохранения идентичности и стиля в сгенерированном движении. Она полезна для персонажных клипов и брендовой визуальной непрерывности.

Эндпоинты

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

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

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

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

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

curl --location "https://api.odirouter.ai/model/v1/queue/happyhorse-1.0-r2v" \
  --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": "reference_image",
        "url": "https://example.com/reference-image.webp"
      }
    ],
    "duration": 5,
    "resolution": "720P",
    "ratio": "4:3"
  }'

prompt string required

Текстовый промпт для описания содержимого генерируемого видео. Поддерживаются китайский и английский языки. Используйте плейсхолдеры, например [Image 1] и [Image 2], чтобы ссылаться на изображения в том же порядке, что и в массиве media, например [Image 1] gallops through a forest while [Image 2] follows behind. Максимальная длина: 2500 китайских иероглифов или 5000 символов на других языках; содержимое сверх лимита автоматически обрезается.

media array required

Массив референсных изображений.

Диапазон: от 1 до 9 референсных изображений

type string required

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

url string required

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

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

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

Короткая сторона: не менее 400 пикселей

Рекомендуемое разрешение: 720P или выше

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

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

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

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

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

duration int

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

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

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

resolution string

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

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

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

ratio string

Соотношение сторон генерируемого видео.

Варианты: 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21, 21:9

По умолчанию: 16:9

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.0-r2v/requests/mmsu_01hxyz.../response",
  "status_url": "https://api.odirouter.ai/model/v1/queue/happyhorse-1.0-r2v/requests/mmsu_01hxyz.../status",
  "cancel_url": "https://api.odirouter.ai/model/v1/queue/happyhorse-1.0-r2v/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	Текущая позиция в очереди.

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