happyhorse-1.1-i2v API

Используйте точный идентификатор модели happyhorse-1.1-i2v. Поле модели должно точно соответствовать этой странице.

Пример выводаhappyhorse-1.1-i2vPOST /v1/videos5.2s

Параметры: duration=5resolution=1080pratio=16:9Входное изображение

Промпт: One continuous take, no cuts. The braided steam keeps thickening until the ribbons lock into one coral and ultraviolet serpent that uncoils along the ceiling, drops down past the stools and pours out through the open door into the rain, the cook in the orange jacket stepping back to let it pass. The camera holds at counter height, then tracks with the serpent to the doorway and tilts to watch it leave. One hard tungsten bulb overhead stays the only warm source. Real weight and inertia, visible density in the steam, no text.

Запрос, в результате которого был создан этот образец, с заменой входного URL-адреса мультимедиа.

{
  "model": "happyhorse-1.1-i2v",
  "prompt": "One continuous take, no cuts. The braided steam keeps thickening until the ribbons lock into one coral and ultraviolet serpent that uncoils along the ceiling, drops down past the stools and pours out through the open door into the rain, the cook in the orange jacket stepping back to let it pass. The camera holds at counter height, then tracks with the serpent to the doorway and tilts to watch it leave. One hard tungsten bulb overhead stays the only warm source. Real weight and inertia, visible density in the steam, no text.",
  "seconds": "5",
  "duration": 5,
  "resolution": "1080p",
  "ratio": "16:9",
  "aspect_ratio": "16:9",
  "image": "https://example.com/input-image.png"
}

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

Используйте ключ API Modelflare с https://modelflare.dev/v1. Точка входа шлюза — POST /v1/videos.

HTTP

Authorization: Bearer YOUR_MODELFLARE_API_KEY

Создать задачу

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "happyhorse-1.1-i2v",
    "input": {"prompt": "The cat runs across the grass as the camera follows smoothly.", "media": [{"type": "first_frame", "url": "https://example.com/cat.png"}]},
    "parameters": {"resolution": "1080P", "duration": 5, "watermark": false}
  }'

Опрос и загрузка

Сохраните идентификатор задачи. Опросите GET /v1/videos/{task_id} и загрузите с помощью GET /v1/videos/{task_id}/content. Срок действия URL-адресов результатов может истечь, поэтому передайте файл как можно скорее.

bash

curl https://modelflare.dev/v1/videos/TASK_ID \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

Запросить примечания

HappyHorse использует input.prompt; выберите фигуру input.media, соответствующую идентификатору модели t2v, i2v или r2v.

Запрос параметров

HappyHorse I2V помещает одно изображение first_frame в input.media.

Поле	Обязательно	Примечания
model	Да	happyhorse-1.1-i2v
input.prompt	Нет	Дополнительное описание движения и камеры, до 5000 некитайских или 2500 китайских иероглифов.
input.media[]	Да	Ровно один first_frame; общедоступный URL-адрес или URL-адрес данных Base64, размер до 20 МБ, ширина сторон не менее 300 пикселей и соотношение сторон 1:2,5–2,5:1.
parameters.resolution	Нет	720P / 1080P, по умолчанию 1080P
parameters.ratio	Нет	Не поддерживается; вывод соответствует соотношению изображения первого кадра
parameters.duration	Нет	3–15 секунд, по умолчанию 5
parameters.watermark	Нет	Добавлять ли водяной знак HappyHorse
parameters.seed	Нет	Необязательное начальное значение от 0 до 2 147 483 647.

Пределы ввода и вывода

I2V использует одно изображение first_frame; принять общедоступный URL-адрес или URL-адрес данных Base64 размером менее 20 МБ с минимальными сторонами 300 пикселей и соотношением сторон 1: 2,5–2,5: 1 и приблизительно сохранить соотношение входных данных.

Ошибки и невыполненные задачи

Неверные параметры модели возвращают 4xx с идентификатором запроса. Асинхронная задача также может оказаться неудачной после успешного создания; используйте error_code и error_message из ответа на опрос в качестве окончательной причины задачи. Не повторяйте тот же запрос с другой формой JSON.

Поддерживаемая область применения

На этой странице описаны вызовы создания и редактирования модели Modelflare. Поиск или расширение карты, голосовое управление и управление библиотекой элементов — это API-интерфейсы ресурсов, находящиеся за пределами этой общедоступной поверхности вызова модели, и они не являются обязательными полями запроса.

Цены и выставление счетов

В этой модели используется посекундная оплата видео. Текущую цену для клиентов, цену по справочному прейскуранту и полную спецификацию см. на странице цен модели .

Заметка

На этой странице документирован публичный интерфейс Modelflare; показанные здесь поля и ограничения соответствуют текущему контракту.