Skip to main content
POST
/
v1
/
asset-groups
Create asset group
curl --request POST \
  --url https://api.gravitex.ai/v1/asset-groups \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "description": "<string>",
  "channel_id": 123,
  "group_type": "<string>"
}
'

Documentation Index

Fetch the complete documentation index at: https://docs.gravitex.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Introduction

Create a virtual asset group (group_type = aigc). For liveness_face, use Create asset group (liveness). Up to 100 groups per user for aigc and liveness_face (separate quotas).

​
Authentication

​
Authorization
string
required
Bearer Token, e.g. Bearer sk-xxxxxxxxxx

​
Request body

​
name
string
required
Group name
​
description
string
Description; defaults to API key user username if empty
​
channel_id
integer
Upstream channel ID (optional)
​
group_type
string
default:"aigc"
Only aigc here; not liveness_face

​
Example

curl -X POST "https://api.gravitex.ai/v1/asset-groups" \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"name": "Character A", "description": "Test"}'
Save group_id for Create asset.