Создайте группу объектов

Доступность

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

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

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

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

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

-H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

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

Запрос

Создайте группу для изображений, видео и аудио, используемых в рабочих процессах Seedance.

Поле	Тип	Обязательно	Описание	Пример
`Name`	`string`	Да	Название группы активов.	`my-project-assets`
`model`	`string`	Нет	Модель выставления счетов. По умолчанию `volc-asset`.	`volc-asset`

Пример JSON:

{
  "Name": "my-project-assets",
  "model": "volc-asset"
}

Пример cURL:

curl --request POST https://modelflare.dev/volc/asset/CreateAssetGroup \
  --header "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "Name": "my-project-assets",
  "model": "volc-asset"
}'

Ответ

Группа создана.

Поле	Тип	Обязательно	Описание	Пример
`Id`	`string`	Да	Новый идентификатор группы активов.	`group-20260320141746-zsf6b`

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

{
  "Id": "group-20260320120601-hsw4s"
}

Ошибки

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

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

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

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