Список активов

Доступность

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

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

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

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

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

-H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

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

Запрос

Список активов с дополнительными фильтрами по имени, группе и типу группы. Прежде чем использовать идентификатор в запросе Seedance, дождитесь Status: Active.

Поле	Тип	Обязательно	Описание	Пример
`model`	`string`	Да	Модель выставления счетов. По умолчанию `volc-asset`.	`volc-asset`
`Filter.Name`	`string`	Нет	Фильтр нечетких названий активов.	`character`
`Filter.GroupIds`	`string[]`	Нет	Фильтрация по идентификаторам групп.	`["group-20260320141746-zsf6b"]`
`Filter.GroupType`	`AIGC`	`LivenessFace`	Нет	Фильтр по типу группы.
`PageNumber`	`integer`	Нет	Номер страницы. По умолчанию `1`.	`1`
`PageSize`	`integer`	Нет	Элементов на странице. По умолчанию `10`.	`10`

Пример JSON:

{
  "model": "volc-asset",
  "Filter": {
    "Name": "character",
    "GroupIds": [
      "group-20260320141746-zsf6b"
    ],
    "GroupType": "AIGC"
  },
  "PageNumber": 1,
  "PageSize": 10
}

Пример cURL:

curl --request POST https://modelflare.dev/volc/asset/ListAssets \
  --header "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "volc-asset",
  "Filter": {
    "Name": "character",
    "GroupIds": [
      "group-20260320141746-zsf6b"
    ],
    "GroupType": "AIGC"
  },
  "PageNumber": 1,
  "PageSize": 10
}'

Ответ

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

Поле	Тип	Обязательно	Описание	Пример
`Items[]`	`object[]`	Нет	Объекты активов с идентификацией, типом, группой, статусом, проектом и метками времени.	`{ Id, Name, AssetType, GroupId, Status, ... }`
`Items[].Id / Name`	`string`	Нет	Идентификация и отображаемое имя актива.	`asset-20260528140922-d9646 / character-reference`
`Items[].AssetType / GroupId`	`string`	Нет	Тип актива и группа владельцев.	`Image / group-20260320141746-zsf6b`
`Items[].Status / ProjectName`	`string`	Нет	Состояние обработки и название проекта.	`Active / default`
`Items[].CreateTime / UpdateTime`	`string`	Нет	Временные метки создания и обновления ISO 8601.	`2026-03-20T14:25:01Z`
`Items[].URL`	`string`	Нет	URL-адрес временного файла. Документированный срок службы составляет 12 часов; используйте `asset://<ID>` для запросов генерации.	`https://example.com/temporary-asset`
`Items[].Error`	`object`	Нет	Ошибка обработки с `Code` и `Message`, когда `Status` равно `Failed`.	`{ Code, Message }`
`PageNumber`	`integer`	Нет	Возвращен номер страницы.	`1`
`PageSize`	`integer`	Нет	Возвращенный размер страницы.	`10`
`TotalCount`	`integer`	Нет	Всего соответствующих активов.	`2`

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

{
  "Items": [
    {
      "Id": "asset-20260528140922-d9646",
      "Name": "character-reference",
      "AssetType": "Image",
      "GroupId": "group-20260320141746-zsf6b",
      "Status": "Active",
      "ProjectName": "default"
    }
  ],
  "PageNumber": 1,
  "PageSize": 10,
  "TotalCount": 1
}

Ошибки

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

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

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

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