跳转到主要内容
POST
/
v1
/
assets
创建素材
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.

​
简介

在素材组内创建素材。仅支持公网 https URL，不支持 Base64。创建后 status 为 processing，需轮询至 active 后再用于 asset://。

​
认证

​
Authorization
string
必填
Bearer Token，如 Bearer sk-xxxxxxxxxx

​
请求参数

​
group_id
string
必填
素材组 ID
​
asset_type
string
必填
image、video、audio
​
url
string
必填
公网 https 资源地址
​
name
string
素材名称

​
请求示例

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": "参考图"
  }'

​
响应示例

{
  "virtual_id": "asset-20260508120001-xyz",
  "status": "processing",
  "asset_type": "image"
}
生成任务中使用：asset://asset-20260508120001-xyz（映射到对应 image_url / video_url / audio_url）。