Список групп объектов

Доступность

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

Заметка

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

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

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

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

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

bash

-H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

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

Запрос

Список групп с дополнительными фильтрами имени, идентификатора и типа группы. При чтении не взимается плата за генерацию.

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

Пример JSON:

JSON

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

Пример cURL:

bash

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

Ответ

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

Поле	Тип	Обязательно	Описание	Пример
Items[]	object[]	Нет	Группы активов с Id, Name, GroupType и Status.	{ Id, Name, GroupType, Status }
Items[].Id / Name	string	Нет	Идентификатор группы и отображаемое имя.	group-20260320141746-zsf6b / my-project-assets
Items[].GroupType / Status	string	Нет	Тип группы и текущее состояние.	AIGC / Active
PageNumber	integer	Нет	Возвращен номер страницы.	1
PageSize	integer	Нет	Возвращенный размер страницы.	10
TotalCount	integer	Нет	Всего совпадающих групп.	1

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

JSON

{
  "Items": [
    {
      "Id": "group-20260320141746-zsf6b",
      "Name": "my-project-assets",
      "GroupType": "AIGC",
      "Status": "Active"
    }
  ],
  "PageNumber": 1,
  "PageSize": 10,
  "TotalCount": 1
}

Ошибки

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

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

JSON

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

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