seedance-2.5 API

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

Пример выводаseedance-2.5POST /v1/videos5.1s

Параметры: duration=5resolution=1080pratio=16:9

Промпт: A small research submersible descends through the deep ocean, its headlights sweeping over a drifting field of bioluminescent jellyfish and a sunken stone archway. Camera follows from behind, particles float in the beams, blue-black water, calm and mysterious, photoreal, no text.

Запрос, по которому был создан этот образец

{
  "model": "seedance-2.5",
  "prompt": "A small research submersible descends through the deep ocean, its headlights sweeping over a drifting field of bioluminescent jellyfish and a sunken stone archway. Camera follows from behind, particles float in the beams, blue-black water, calm and mysterious, photoreal, no text.",
  "seconds": "5",
  "duration": 5,
  "resolution": "1080p",
  "ratio": "16:9",
  "aspect_ratio": "16:9"
}

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

Используйте ключ 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": "seedance-2.5",
    "content": [{"type": "text", "text": "A white cat runs through a neon-lit street in the rain, cinematic tracking shot"}],
    "resolution": "720p",
    "duration": 5,
    "generate_audio": 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"

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

Seedance использует content[] для текста, кадров и справочных материалов; отдельный контракт на управление активами Seedance документируется независимо.

Заметка

Сначала загрузите изображения виртуальных людей в библиотеку ресурсов Seedance. Дождитесь статуса Active, затем используйте asset://<ID> в content[]. Modelflare не предоставляет проверку реальных людей.

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

Seedance использует один асинхронный мультимодальный конверт. Поместите текст и медиа в content[]; роли мультимедиа выбирают первый/последний кадр или справочные рабочие процессы.

Поле	Обязательно	Примечания
model	Да	seedance-2.5
content[]	Да	text, image_url, video_url и audio_url; используйте role для определения цели СМИ
resolution	Нет	480p / 720p / 1080p
ratio	Нет	21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / adaptive
duration	Нет	-1 для автоматической синхронизации или 4–30 секунд.
generate_audio	Нет	Генерация синхронизированных диалогов, эффектов и фонового звука
tools	Нет	Используйте web_search только там, где это поддерживается официальной страницей модели.
watermark	Нет	Добавлять ли водяной знак
omni_reference_task_type	Нет	auto / reference / edit / extend; редактирование и расширение налагают более строгие правила соотношения/длительности
output_format	Нет	mp4 / mov
return_last_frame	Нет	Вернуть последний кадр в виде изображения

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

Эта модель поддерживает разрешение 480p, 720p и 1080p. Используйте -1 для автоматического выбора времени или выберите 4–30 секунд. Запрос может объединить до 30 изображений, 10 видео и 10 аудиоклипов. Обычная генерация ссылок принимает явное соотношение или adaptive; Рабочие процессы редактирования, расширения и первого/последнего кадра требуют ratio: "adaptive", а редактирование требует duration: -1. Изображения виртуальных людей нужно сначала загрузить в библиотеку ресурсов; Modelflare не предоставляет проверку реальных людей.

Документированные примеры рабочих процессов

Seedance 2.5 классифицирует рабочие процессы ссылок, редактирования, расширения и управления кадрами по ролям мультимедиа и типам задач. В примерах сохраняется официальный контракт при использовании конечной точки Modelflare и идентификатора модели.

Мультимодальная ссылка

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5",
    "omni_reference_task_type": "reference",
    "content": [
      {"type":"text","text":"@image1 performs the movement from @video1, paced to @audio1"},
      {"type":"image_url","image_url":{"url":"https://example.com/character.jpg"},"role":"reference_image"},
      {"type":"video_url","video_url":{"url":"https://example.com/motion.mp4"},"role":"reference_video"},
      {"type":"audio_url","audio_url":{"url":"https://example.com/music.mp3"},"role":"reference_audio"}
    ],
    "ratio": "16:9", "duration": 15, "output_format": "mp4"
  }'

Монтаж видео

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5", "omni_reference_task_type": "edit",
    "content": [
      {"type":"text","text":"Remove the background pedestrians but preserve the main subject"},
      {"type":"video_url","video_url":{"url":"https://example.com/source.mov"},"role":"reference_video"}
    ],
    "ratio": "adaptive", "duration": -1, "output_format": "mov"
  }'

Расширение видео

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5", "omni_reference_task_type": "extend",
    "content": [{"type":"video_url","video_url":{"url":"https://example.com/source.mp4"},"role":"reference_video"}],
    "ratio": "adaptive", "duration": 11, "output_format": "mov"
  }'

Первый и последний кадры

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5", "content": [
      {"type":"text","text":"The subject smiles while the camera makes a smooth orbit"},
      {"type":"image_url","image_url":{"url":"https://example.com/first.jpg"},"role":"first_frame"},
      {"type":"image_url","image_url":{"url":"https://example.com/last.jpg"},"role":"last_frame"}
    ],
    "ratio": "adaptive", "duration": -1, "return_last_frame": true
  }'

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

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

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

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

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

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

Заметка

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

Варианты

Идентификатор модели	Разница
seedance-2.5	Модель, описанная на этой странице.