Обновление объекта

Доступность

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

Заметка

Шлюз записывает идентификаторы активов поставщика, статус и принадлежность пользователей. Локальная библиотека Castaly остается отдельной от пространства имен ресурсов поставщика.

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

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

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

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

bash

-H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

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

Запрос

Обновите имя актива или переместите его в другую группу.

Поле	Тип	Обязательно	Описание	Пример
Id	string	Да	Идентификатор актива.	asset-20260528140922-d9646
Name	string	Нет	Новое имя актива.	updated-character-reference
GroupId	string	Нет	Идентификатор группы назначения.	group-20260320141746-zsf6b
model	string	Нет	Модель выставления счетов. По умолчанию volc-asset.	volc-asset

Пример JSON:

JSON

{
  "model": "volc-asset",
  "Id": "asset-20260528140922-d9646",
  "Name": "updated-character-reference",
  "GroupId": "group-20260320141746-zsf6b"
}

Пример cURL:

bash

curl --request POST https://modelflare.dev/volc/asset/UpdateAsset \
  --header "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "volc-asset",
  "Id": "asset-20260528140922-d9646",
  "Name": "updated-character-reference",
  "GroupId": "group-20260320141746-zsf6b"
}'

Ответ

Запрос выполнен успешно.

Поле	Тип	Обязательно	Описание	Пример
Id	string	Да	Идентификатор актива.	asset-20260528140922-d9646
Name	string	Нет	Обновлено название объекта.	updated-character-reference
GroupId	string	Нет	Идентификатор группы активов.	group-20260320141746-zsf6b
UpdateTime	string	Нет	Обновление временной метки.	2026-05-28T06:09:31Z

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

JSON

{
  "Id": "asset-20260528140922-d9646",
  "Name": "updated-character-reference",
  "GroupId": "group-20260320141746-zsf6b",
  "UpdateTime": "2026-05-28T06:09:31Z"
}

Ошибки

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

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

JSON

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

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