Создайте видеоресурс

Доступность

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

Конечная точка

POST https://modelflare.dev/volc/asset/CreateAsset

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

Используйте ключ API Modelflare:

-H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

Отправьте Idempotency-Key с запросами на создание, обновление и удаление. Повторная попытка того же ключа для того же пользователя воспроизводит сохраненный ответ без повторения мутации.

Запрос

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

Поле	Тип	Обязательно	Описание	Пример
`GroupId`	`string`	Да	Идентификатор целевой группы активов.	`group-20260320141746-zsf6b`
`AssetType`	`Video`	Да	Должно быть `Video`.	`Video`
`URL`	`string`	Да	URL общедоступного видео. Видео Base64 не принимается. Используйте MP4 или MOV, 2–30 секунд, 24–60 кадров в секунду, 300–6000 пикселей с каждой стороны, соотношение сторон 0,4–2,5, 480p/720p/1080p/4K, общее количество пикселей 407696–2086876 и не более 200 МБ.	`https://example.com/video.mp4`
`file`	`binary`	Нет	Многочастная альтернатива `URL` с теми же ограничениями видео.	`video.mp4`
`Name`	`string`	Нет	Имя для отображения/поиска, до 64 символов.	`scene-clip`
`model`	`string`	Да		`volc-asset-video`
`ProjectName`	`string`	Нет	Название проекта. Оно должно соответствовать целевой группе; по умолчанию — `default`.	`default`

Пример JSON:

{
  "model": "volc-asset-video",
  "GroupId": "group-20260320141746-zsf6b",
  "Name": "scene-clip",
  "AssetType": "Video",
  "URL": "https://example.com/video.mp4",
  "ProjectName": "default"
}

Пример multipart/form-data:

curl --request POST https://modelflare.dev/volc/asset/CreateAsset \
  --header "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  --form "model=volc-asset-video" \
  --form "GroupId=group-20260320141746-zsf6b" \
  --form "file=@video.mp4"

Ответ

Видео вошло в асинхронную обработку. Опрашивайте GetAsset, пока Status не станет Active или Failed. Соглашение об уровне обслуживания во время загрузки отсутствует; Обычное видео занимает около 9–12 секунд, а загруженная очередь просмотра может занять от 10 секунд до 2 минут.

Поле	Тип	Обязательно	Описание	Пример
`Id`	`string`	Да	Идентификатор актива. Используйте `asset://<ID>` только после того, как статус станет `Active`.	`asset-20260528140922-d9646`

Пример ответа:

{
  "Id": "asset-20260528140922-d9646"
}

Ошибки

Статус	Значение
`400`	Запрос недействителен.
`401`	Ключ API отсутствует или неавторизован.

Пример тела ошибки (при возврате):

{
  "error": {
    "code": "invalid_request",
    "message": "Request validation failed."
  }
}

Создание изображений, видео и аудио происходит асинхронно. После получения идентификатора актива вызовите GetAsset и используйте ссылку asset://<ID> только тогда, когда статус равен Active.