seedance-2.0 API

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

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

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

Промпт: One continuous take, no cuts. An empty indoor swimming pool at night, tiled walls and underwater lights. A swimmer in a chrome-finish suit stands on the edge and lifts both arms; the water answers by leaving the pool, rising as a single rotating column of turquoise that twists up past the roof beams and holds there, the emptied tiles glowing underneath. The camera starts low at the pool edge, cranes up alongside the column and tilts to look down into the drained basin. One hard cyan key from the underwater lights, warm sodium spill from the high windows. Real weight and inertia, spray and refraction, no text.

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

{
  "model": "seedance-2.0",
  "prompt": "One continuous take, no cuts. An empty indoor swimming pool at night, tiled walls and underwater lights. A swimmer in a chrome-finish suit stands on the edge and lifts both arms; the water answers by leaving the pool, rising as a single rotating column of turquoise that twists up past the roof beams and holds there, the emptied tiles glowing underneath. The camera starts low at the pool edge, cranes up alongside the column and tilts to look down into the drained basin. One hard cyan key from the underwater lights, warm sodium spill from the high windows. Real weight and inertia, spray and refraction, 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.0",
    "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.0
content[]	Да	text, image_url, video_url и audio_url; используйте role для определения цели СМИ
resolution	Нет	480p / 720p / 1080p / 4k (по умолчанию 720p)
ratio	Нет	21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / adaptive
duration	Нет	4–15 секунд
generate_audio	Нет	Генерация синхронизированных диалогов, эффектов и фонового звука
tools	Нет	Используйте web_search только там, где это поддерживается официальной страницей модели.
watermark	Нет	Добавлять ли водяной знак

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

Эта модель поддерживает вывод 480p, 720p, 1080p и 4k с длительностью 4–15 секунд. Мультимодальные ссылки позволяют использовать до девяти изображений, трех видео и трех аудиоклипов; аудио нельзя использовать отдельно. Отметьте носитель значениями role в content[]; Рабочие процессы первого кадра, редактирования, расширения и веб-поиска имеют свои собственные ограничения. Изображения виртуальных людей нужно сначала загрузить в библиотеку ресурсов; Modelflare не предоставляет проверку реальных людей.

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

Серия Seedance 2.0 поддерживает преобразование текста в видео, первый/первый и последний кадры, мультимодальные ссылки, редактирование, расширение и веб-поиск для преобразования текста в видео. Упорядочивайте медиафайлы как текст, изображение, видео, а затем аудио.

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

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0",
    "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"}
    ],
    "generate_audio": true, "ratio": "16:9", "duration": 11
  }'

Монтаж видео и поиск в Интернете

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0", "content": [{"type": "text", "text": "Macro shot of cherry blossoms in spring"}],
    "generate_audio": true, "ratio": "16:9", "duration": 11,
    "tools": [{"type": "web_search"}]
  }'

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

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

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

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

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

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

Заметка

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

Варианты

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