Skip to main content
POST
/
v1
/
assets
Create asset
curl --request POST \
  --url https://api.gravitex.ai/v1/assets \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "group_id": "<string>",
  "asset_type": "<string>",
  "url": "<string>",
  "name": "<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 an asset in a group. Public https URLs only. Initial status is processing; poll until active before using asset://.

​
Authentication

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

​
Request body

​
group_id
string
required
Asset group ID
​
asset_type
string
required
image, video, audio
​
url
string
required
Public https URL
​
name
string
Asset name

​
Example

curl -X POST "https://api.gravitex.ai/v1/assets" \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "group_id": "group-20260508120000-abcde",
    "asset_type": "image",
    "url": "https://example.com/face.jpg",
    "name": "Reference"
  }'
Use in generation: asset://asset-20260508120001-xyz (mapped by asset_type).