创建素材

国内端点

https://openai.qiniu.com

POST

/v1/assets

提交一个素材进行审核。

处理流程：

鉴权检查 API Key

处理 Group：

若传入 group_id，校验该 Group 属于当前用户且 status=active

若未传入，自动选用默认 Group；若无默认 Group，自动异步创建一个 pending Group

异步提交素材审核任务

立即返回 qassetid 和 pending 状态

说明：素材审核为异步流程，状态会经过 pending → reviewing → approved/failed。审核完成后才能在视频生成中引用。

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Body 参数application/json必填

示例

返回响应

🟢200

application/json

创建成功（注意：实际状态为 pending，需轮询查询最终状态）

Bodyapplication/json

请求示例

Shell

JavaScript

Java

Swift

curl --location 'https://openai.qiniu.com/v1/assets' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "type": "image",
    "url": "https://img.somake.ai/cdn-cgi/image/width=800,quality=80,format=auto,fit=scale-down/tools/examples/face-generator_gallery_1763099237_8262.jpg",
    "name": "年轻男人",
    "model": "bytedance/doubao-seedance-2-0-260128"
}'

响应示例

{
    "qassetid": "qasset-uid001-1716100100000000000",
    "type": "image",
    "name": "公司虚拟形象",
    "status": "pending",
    "group_id": "qgroup-uid001-1716100000000000000",
    "created_at": 1716100100,
    "updated_at": 1716100100
}

修改于 2026-05-28 08:30:05

更新素材分组

查询单个素材