Получите актив

Доступность

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

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

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

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

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

-H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

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

Запрос

Чтение одного актива по идентификатору. Используйте этот маршрут для опроса асинхронной загрузки, пока Status не станет Active или Failed.

Поле	Тип	Обязательно	Описание	Пример
`Id`	`string`	Да	Идентификатор актива для запроса.	`asset-20260528140922-d9646`

Пример JSON:

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

Пример cURL:

curl --request POST https://modelflare.dev/volc/asset/GetAsset \
  --header "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "Id": "asset-20260528140922-d9646"
}'

Ответ

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

Поле	Тип	Обязательно	Описание	Пример
`Id`	`string`	Да	Идентификатор актива.	`asset-20260528140922-d9646`
`Name`	`string`	Нет	Имя актива.	`character-reference`
`URL`	`string`	Нет	URL-адрес временного файла. Документированный срок службы составляет 12 часов; не сохраняйте его как ссылку на поколение.	`https://example.com/temporary-asset`
`AssetType`	`Image`	`Video`	`Audio`	Нет
`GroupId`	`string`	Нет	Идентификатор группы владельцев.	`group-20260320141746-zsf6b`
`Status`	`Processing`	`Active`	`Failed`	Нет
`ProjectName`	`string`	Нет	Название проекта.	`default`
`CreateTime / UpdateTime`	`string`	Нет	Временные метки ISO 8601.	`2026-05-28T06:09:31Z`

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

{
  "Id": "asset-20260528140922-d9646",
  "Name": "character-reference",
  "AssetType": "Image",
  "GroupId": "group-20260320141746-zsf6b",
  "Status": "Active",
  "ProjectName": "default",
  "CreateTime": "2026-05-28T06:09:22Z",
  "UpdateTime": "2026-05-28T06:09:31Z"
}

Ошибки

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

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

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

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