happyhorse-1.1-r2v API

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

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

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

Промпт: One continuous take, no cuts. Keep the woman in the crimson satin coat and the peeling carpet ribbons from the reference and move the event outdoors: she walks out of a revolving door onto a wet plaza and the patterned ribbons keep tearing up behind her, now lifting off the paving stones and streaming out across the square in a long coloured wake. The camera tracks backward ahead of her at waist height and cranes up as the wake spreads. One hard green sign light above the door, warm street lamps across the plaza. Real weight and inertia, satin and wet stone, no text.

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

{
  "model": "happyhorse-1.1-r2v",
  "prompt": "One continuous take, no cuts. Keep the woman in the crimson satin coat and the peeling carpet ribbons from the reference and move the event outdoors: she walks out of a revolving door onto a wet plaza and the patterned ribbons keep tearing up behind her, now lifting off the paving stones and streaming out across the square in a long coloured wake. The camera tracks backward ahead of her at waist height and cranes up as the wake spreads. One hard green sign light above the door, warm street lamps across the plaza. Real weight and inertia, satin and wet stone, 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-r2v",
    "input": {"prompt": "The person in [Image 1] picks up [Image 2].", "media": [{"type": "reference_image", "url": "https://example.com/person.jpg"}, {"type": "reference_image", "url": "https://example.com/object.jpg"}]},
    "parameters": {"resolution": "1080P", "ratio": "16:9", "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 R2V помещает 1–9 элементов reference_image в input.media и ссылается на них по порядку из подсказки.

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

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

R2V использует элементы 1–9 reference_image и обращается к ним в порядке подсказок: «Изображение 1», «Изображение 2» и т. д. Подсказки ограничены 5000 некитайскими или 2500 китайскими иероглифами; Размер изображений не превышает 20 МБ с минимальной короткой стороной 400 пикселей.

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

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

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

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

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

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

Заметка

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