Higgsfield: DOP Preview

DOP Preview превращает переданные изображения в видео в документированном процессе с шаблонами движения. Конкретный селектор dop-preview поддерживает один или два эффекта; параметры strength, prompt и seed сохраняются вместе с завершённым результатом.

Ailoot Ultra · Видео POST /v1/videos dop-preview

О модели

Описание раскрывает возможности модели. Доступные в Ailoot входные данные, результаты и параметры выбранного метода перечислены ниже.

DOP Preview оживляет переданные изображения в документированном процессе Higgsfield по созданию видео из изображения. Точный селектор — dop-preview. Используйте dop-preview для выбора модели на верхнем уровне и как значение model внутри документированного объекта params. Изображение задаёт визуальный материал, а шаблоны движения и письменные указания управляют запрошенным движением и эффектом.

Подготовьте исходное изображение, на котором отчётливо видны нужный объект, важные детали и окружающее пространство. Руководство рекомендует изображение высокого разрешения для более чётких деталей. Для сцены с товаром выберите ракурс, показывающий форму предмета и поверхности, которые должны оставаться узнаваемыми при движении. Для человека или окружения укажите визуальную черту, которую движение должно подчеркнуть. Передайте реальный URL исходного изображения через вход изображения, используемый в примере метода.

Для операции документированы один или два шаблона движения. Для двух шаблонов руководство описывает объединение их эффектов. Описания предустановок включают движение камеры, вращение объекта и визуальные преобразования: например, Dolly In описывает приближение камеры, а 3D Rotation — поворот объекта или товара на месте. Выберите документированные идентификаторы шаблонов, подходящие нужной последовательности, и сохраняйте каждый идентификатор вместе со значением интенсивности.

Интенсивность движения задаётся числом от 0 до 1; документированное значение по умолчанию — 0.8. Руководство описывает 0.3 как слабый эффект, а 1 — как сильное движение. Выбирайте интенсивность с учётом детали, которая должна оставаться различимой, и проверяйте всё сгенерированное действие. Описание движения и его интенсивность выполняют разные задачи: шаблон выбирает эффект, а интенсивность управляет его силой.

Поле prompt должно присутствовать согласно его описанию, но пустая строка разрешена. Для эффектов на основе шаблонов руководство рекомендует оставлять prompt пустым; если текст указан, рекомендуется включать описание шаблона, поскольку промпт может существенно изменить результат. Параметр enhance_prompt включает оптимизацию промпта и документирован со значением true по умолчанию. При сравнении версий сохраняйте текст и этот параметр вместе с исходным изображением и выбранными шаблонами.

Параметр seed принимает целое число от 1 до 1000000. Записывайте выбранный seed вместе с настройками генерации. Запрос также содержит целочисленное поле seconds; сохраняйте использованное значение вместе с полученным роликом и проверяйте фактическое время действия и кадрирование. Логический параметр check_nsfw включает документированный фильтр контента; по умолчанию используется true. Эти параметры относятся к запросу создания видео из изображения и должны оставаться связанными с конкретной выбранной моделью.

Генерация асинхронная. Сохраняйте идентификатор возвращённой задачи, выполняя настроенный запрос её статуса и результата. Обработка завершения читает записи завершённых заданий и исходные URL их результатов. Сохраняйте каждый завершённый видеорезультат и его идентификатор задания вместе с возвращённым URL, объединяя все завершённые записи в результат операции.

Проверьте всё видео по переданному изображению, выбранному эффекту и письменным указаниям: внешний вид объекта, движение, кадрирование и заключительный вид. Для доработки укажите конкретную визуальную деталь, которую нужно изменить, и сохраните удачные части запроса. Храните вместе исходное изображение, точный селектор, промпт, идентификаторы движений, интенсивности, seed, запрошенные настройки и завершённые материалы, чтобы следующее сравнение опиралось на фактическую генерацию.

Ailoot Ultra · Видео POST /v1/videos dop-preview

dop-preview

Higgsfield /dop-preview

Начало

Допустимые входные данные: Картинки · Текст
Результаты: Видео

Доступно в Ailoot · входные данные и методы

Ailoot Ultra · Видео POST /v1/videos

Входные данные: image, text
Результат: video

Поле	Тип	Требование	Значения и ограничения	По умолчанию
Поле`model`	Тип`string`	ТребованиеОбязательно	Значения и ограничения dop-preview Условия: Идентификатор модели Ailoot.	По умолчанию—
Поле`params`	Тип`object`	ТребованиеОбязательно	Значения и ограничения Условия: Параметры генерации видео из изображения; сохраните эту структуру запроса.	По умолчанию—
Поле`params.model`	Тип`string`	ТребованиеОбязательно	Значения и ограничения dop-preview Условия: Используйте тот же идентификатор модели, что и в поле model верхнего уровня.	По умолчанию—
Поле`params.prompt`	Тип`string`	ТребованиеОбязательно	Значения и ограничения Условия: Не опускайте это поле; пустая строка документирована. Текстовые указания сильно влияют на выбранный эффект движения.	По умолчанию—
Поле`params.seconds`	Тип`integer`	ТребованиеНеобязательно	Значения и ограничения Условия: Запрошенная длительность; документированные диапазон или значение по умолчанию не заявляются.	По умолчанию—
Поле`params.motions`	Тип`array`	ТребованиеНеобязательно	Значения и ограничения Условия: Выберите один или два документированных шаблона движения.	По умолчанию—
Поле`params.motions[].id`	Тип`string`	ТребованиеОбязательно	Значения и ограничения Условия: Идентификатор движения в документированном рабочем примере запроса.	По умолчанию—
Поле`params.motions[].strength`	Тип`number`	ТребованиеОбязательно	Значения и ограничения Минимум: 0 Максимум: 1 Условия: Интенсивность движения: 0.3 описана как слабая, а 1 — как сильная.	По умолчанию0,8
Поле`params.input_images`	Тип`array`	ТребованиеНеобязательно	Значения и ограничения Условия: Референсные изображения: используйте массив объектов image_url, показанный в рабочем примере.	По умолчанию—
Поле`params.input_images[].type`	Тип`string`	ТребованиеОбязательно	Значения и ограничения image_url Условия: Представление для справки.	По умолчанию—
Поле`params.input_images[].image_url`	Тип`string`	ТребованиеОбязательно	Значения и ограничения Условия: Фактический доступный URL вашего референсного изображения.	По умолчанию—
Поле`params.enhance_prompt`	Тип`boolean`	ТребованиеНеобязательно	Значения и ограничения Условия: Улучшение текстового запроса.	По умолчаниюtrue
Поле`params.check_nsfw`	Тип`boolean`	ТребованиеНеобязательно	Значения и ограничения Условия: Фильтрация содержимого.	По умолчаниюtrue
Поле`params.seed`	Тип`integer`	ТребованиеНеобязательно	Значения и ограничения Минимум: 1 Максимум: 1 000 000 Условия: Начальное значение генератора случайных чисел для воспроизводимого результата.	По умолчанию—
Поле`webhook`	Тип`object`	ТребованиеНеобязательно	Значения и ограничения Условия: Необязательные документированные настройки webhook; получение результатов, принадлежащих Ailoot, использует пути задач Ailoot.	По умолчанию—
Поле`webhook.url`	Тип`string`	ТребованиеНеобязательно	Значения и ограничения Условия: URL вашего получателя.	По умолчанию—
Поле`webhook.secret`	Тип`string`	ТребованиеНеобязательно	Значения и ограничения Условия: Секрет вашего получателя.	По умолчанию—
Поле`callback`	Тип`string`	ТребованиеНеобязательно	Значения и ограничения Условия: Необязательный получатель обратного вызова (callback); согласно документации, получатель отвечает HTTP 200.	По умолчанию—

Сочетания входных материалов

Параметры и жизненный цикл метода

Параметр	Контракт
Параметр`content_type`	Контрактapplication/json
Параметр`required`	Контрактmodel, params
Параметр`optional`	Контрактparams.seconds, params.motions, params.input_images, params.enhance_prompt, params.check_nsfw, params.seed, webhook, webhook.url, webhook.secret, callback
Параметр`material_types`	Контрактimage, text
Параметр`additional_properties`	Контрактtrue
Параметр`validation_scope`	КонтрактМодель определяет маршрут запроса; структура параметров соответствует показанному запросу генерации видео из изображения.

Псевдонимы метода: /v1/videos/generations

Жизненный цикл: submit_once_poll_original

GET /v1/videos/{request_id}

GET /v1/videos/generations/{request_id}

GET /v1/videos/{request_id}/content

GET /v1/videos/generations/{request_id}/content

Используйте один и тот же идентификатор модели на верхнем уровне и внутри params.

Создайте один раз, затем используйте возвращённые публичные id и polling_url для исходной операции.

Получите каждое готовое видео, принадлежащее Ailoot; проверьте фактическую длительность и размеры в результате.

Замените YOUR_ACCESSIBLE_IMAGE_URL в примере на реальный URL вашего референсного изображения.

Тарифы

Как рассчитывается итоговая плата

Отображаемые тарифы позволяют оценить стоимость до генерации. Итоговое списание рассчитывается по стоимости, записанной для исходной генерации. Измеренная длительность результата и прогнозные объёмы не являются итоговым оплачиваемым объёмом.

Тарифная справка не добавляет режимы запроса. Поддерживаемые параметры указаны для выбранного метода.

Быстрый режим: Не указано При выборе быстрого режима
Режим flex: Не указано При выборе режима flex
Максимальная интенсивность рассуждений: Не указано При максимальной интенсивности рассуждений с корректировкой по умолчанию (default)

Оценочные ставки для сравнения

Цены по конфигурациям

Сопоставьте каждую плату с указанными условиями. Для каждого набора альтернативных конфигураций используйте одну ставку.

Конфигурация	Шкала ставок	Прогноз количества	Плата
КонфигурацияБазовые тарифы на токены	Шкала ставокБазовая ставка	Прогноз количества—	Плата Вход · Входные токены · Оценка только для сравнения — / 1K токенов Выход · Выходные токены · Оценка только для сравнения — / 1K токенов Вход · Чтение кэша · Оценка только для сравнения — / 1K токенов Вход · Запись в кэш · Оценка только для сравнения — / 1K токенов Вход · Запись в кэш, 1 час · Оценка только для сравнения — / 1K токенов
КонфигурацияОриентировочная стоимость генерации	Шкала ставок—	Прогноз количестваОценка для одной генерации	Плата Выход · Оценочная стоимость генерации · Оценка только для сравнения $1.24 оценка до генерации Эта оценка не является дополнительным списанием или фиксированным тарифом для завершённой генерации.

Ailoot резервирует расчётную сумму перед запросом. После получения результата списывает итоговую плату по измеренному расходу. Для окончательного списания за потоковый ответ используется итоговая запись расхода. Как работают резервирование и расчёт →

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

Ailoot Ultra · Видео

JSON · создать видеоcurl · прочитать исходную задачу

{
  "model": "dop-preview",
  "params": {
    "model": "dop-preview",
    "prompt": "a cat",
    "seed": 500000,
    "motions": [
      {
        "id": "2bae49e6-ffe7-42a8-a73f-d44632c4acaa",
        "strength": 0.5
      }
    ],
    "input_images": [
      {
        "type": "image_url",
        "image_url": "YOUR_ACCESSIBLE_IMAGE_URL"
      }
    ],
    "enhance_prompt": true,
    "check_nsfw": true
  }
}

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_POLL'
import json
from pathlib import Path
from urllib.parse import quote,urljoin,urlsplit
r=json.loads(Path("result.json").read_text())
i=r.get("id")
if not isinstance(i,str) or not i:raise SystemExit("Keep original response/headers/id; do not resubmit creation.")
u=urljoin("https://api.ailoot.ai",r.get("polling_url") or "/v1/videos/"+quote(i,safe=""))
p=urlsplit(u)
if p.scheme!="https" or p.netloc!="api.ailoot.ai" or not p.path.startswith("/v1/videos/"):raise SystemExit("Use the actual Ailoot lookup path.")
Path("poll-url.txt").write_text(u)
PY_POLL
curl --fail-with-body --silent --show-error "$(cat poll-url.txt)" -H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json

Получить и сохранить результаты

Ailoot Ultra · Видео

Сохраните возвращённые задачи и их состояния. Получите результаты каждого готового видео, принадлежащего Ailoot.

GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/videos/generations/{request_id}/content

Сохраняйте все готовые результаты

Сохраните каждое готовое видео или полученный файл; загрузите содержимое по каждому фактически полученному URL материала.

Получите каждый фактический готовый результат; не считайте количество результатов фиксированным.

Если нужно проверить исходный ответ

Сохраните исходный ответ и возвращённую идентичность задачи; неизвестное состояние или неоднозначная отправка не разрешают новое создание.

Поля ответа

Поле	Тип	Значение
Поле`id`	Типstring	ЗначениеПубличный идентификатор задачи или операции Ailoot.
Поле`provider_task_id`	Типstring	ЗначениеИсходный идентификатор задачи, отдельный от публичного id.
Поле`polling_url`	Типstring	ЗначениеВозвращённый путь проверки Ailoot.
Поле`jobs[].id`	Типstring	ЗначениеФактический возвращённый идентификатор задачи.
Поле`jobs[].status`	Типstring	ЗначениеСостояние каждой возвращённой задачи.
Поле`jobs[].results.raw.url`	Типstring	ЗначениеКаждое готовое видео доступно через подписанный URL, принадлежащий Ailoot.

Ошибки и дальнейшие шаги

Ответ	Условие	Следующий шаг
Ответ400 · `invalid_request_error`	УсловиеНедопустимый JSON/model или индекс содержимого.	Следующий шаг
Ответ401 · `authentication_error`	УсловиеНедействительный ключ Ailoot API.	Следующий шаг
Ответ403 · `permission_error`	УсловиеГруппа ключа API не допущена к этому медиамаршруту.	Следующий шаг
Ответ404 · `not_found_error`	УсловиеИсходная задача или запрошенный результат отсутствуют либо не принадлежат тому же пользователю, ключу API или группе.	Следующий шаг
Ответ502 · `result_pending_check`	УсловиеИсходная отправка или статус неполны либо их невозможно сверить; сохраните исходный ID и не отправляйте запрос повторно.	Следующий шаг
Ответ503 · `result_pending_check`	УсловиеИсходная привязка, маршрут или принадлежащий Ailoot медиаресурс ещё проверяются; продолжайте проверять ту же исходную операцию.	Следующий шаг
Ответ503 · `server_error`	УсловиеМедиасервис или хранилище исходных задач недоступны.	Следующий шаг

Псевдонимы

Псевдонимы моделей

Ailoot Ultra dop-preview

Псевдонимы путей метода

/v1/videos/generations

Связанные ID для вызова

dop-preview

FAQ · Higgsfield: DOP Preview

Какие входные данные и результаты доступны?: POST /v1/videos · dop-preview: image, text → video
Какие поля использует запрос?: POST /v1/videos · dop-preview: model, params, webhook, callback
Какие ограничения действуют?: POST /v1/videos · dop-preview: params.motions[].strength.minimum: 0; params.motions[].strength.maximum: 1; params.seed.minimum: 1; params.seed.maximum: 1000000

Higgsfield: DOP Preview