细节呈现
细节丰富 · 真实细腻
穗禾 · SEEDANCE
2.0 满血版
更强模型 × 更稳输出 × 更懂创意
新一代视频生成大模型 · 开启创作新纪元
使用生成与账户能力前请先绑定 API Key（右上角「登录」）。
穗禾 · GPT 图像
高质量 图像生成
多档分辨率 · 组图与编辑 · 与视频创作同一账户
在「图片创作」中选用您账户内已开放的图像模型，按需生成与下载。
定价与可用模型以账户内「价位表」「可用模型」为准。
穗禾 · 图像创作
语义理解 画面表达
多风格生成 · 与站内其他图像模型同一入口
在「图片创作」中按账户权限选用已开放的图像模型，生成结果可下载与入库。
定价与可用模型以账户内「价位表」「可用模型」为准。
更强性能
生成更快 · 稳定高效
更懂创意
语义精准 · 镜头自由
满血体验
完整能力 · 无损释放
视频与图片创作
绑定 API Key 后，视频与图片创作区会从服务端加载您账户当前可用的模型；未登录时创作区不提供任何可选模型。
我们支持高质量视频生成（多种比例、时长与参考模式）与图片生成（多档分辨率与组图等）。具体以您账户内展示为准，此处不列举内部技术代号。
输入提示词，生成视频
施工中 · 需求对齐
漫剧创作
这一页还在施工与需求对齐阶段。我们尚未与漫剧 / 动漫产业链伙伴建立深度对接，此前在内部的推演不能代表最终产品形态或交付承诺。
接下来，我们希望与漫剧公司、制片方与渠道伙伴直接沟通：请您告诉我们真实的工作流、合规要求、交付标准与协作习惯；我们会据此做网站功能与交互设计，而不是闭门「想象」。
若您愿意率先共建，欢迎您主动联系我们，或把对「分镜—制作—成片」环节的宝贵意见通过您熟悉的服务对接渠道转达给我们——我们会纳入需求池与路线图。
当前站点已开放的能力以视频创作与图片创作为主；漫剧专区正式上线前，本页仅作坦诚说明。
输入图片描述，生成图像
画布功能
开发中
无限画布 · AI 图片/视频生成 · 智能排版
敬请期待
OpenAI 兼容 API
本站对外对接请仅按本文档使用：Authorization: Bearer；图片 / 视频创作的参考素材推荐使用 multipart/form-data 将原始文件直接上传到本站；application/json 多用于纯文参数或与 OpenAI 风格 SDK 对齐的兼容调用（见各小节）。素材库上传亦为 multipart。创作类接口均为异步任务：受理后请用 GET /v1/tasks/{task_id} 轮询至成功或失败；与「同一次请求内直接返回成品链接」的同步模式不同。
model：创作请求里请与 GET /v1/models 返回同一条目的 request_model 字段逐字相同。若您手写 label，须与当条返回完全一致；视频条目在库内无展示名时 label 可能为空，此时必须使用 request_model（或列表 id）。
绑定 API Key 后，下方「model 取值（当前环境）」会拉取列表并自动写入本页示例中的 model（优先用每条目的 request_model）。未绑定时为占位字串，请替换为接口返回值。
数据流（对接时请按此理解）
入参：参考图、视频首尾帧、关键帧与全能参考中的音/视频等，默认由客户端以原始二进制随 multipart 请求提交到本站；由本站完成接收与后续可拉取编排。不要求您先把素材上传到自建公网对象存储再把外链填进请求（URL 类字段仅作补充能力）。
出参：任务成功后，通过
入参：参考图、视频首尾帧、关键帧与全能参考中的音/视频等，默认由客户端以原始二进制随 multipart 请求提交到本站；由本站完成接收与后续可拉取编排。不要求您先把素材上传到自建公网对象存储再把外链填进请求（URL 类字段仅作补充能力）。
出参：任务成功后，通过
GET /v1/tasks/{task_id} 返回的 result_urls 获取成片 / 成图的可下载地址；请在业务侧使用该 URL 拉取成品。链接形态与有效期以实际为准，必要时可再次查询任务以取得更新后的地址。开放 API 根地址（Base URL）
对外 HTTP 调用请使用：
Shell 示例：
在本页浏览器内绑定 Key 做连通性验证时，请求经当前网站同源转发；独立脚本、服务端或第三方工具请用上列 API 域名。
对外 HTTP 调用请使用：
https://api.suihemedia.cloud（不要在末尾加 /v1）。完整路径示例：https://api.suihemedia.cloud/v1/models、https://api.suihemedia.cloud/v1/images/generations。Shell 示例：
export API_BASE="https://api.suihemedia.cloud"。OpenAI 风格 SDK 请将 baseURL 设为 https://api.suihemedia.cloud，由客户端拼接 /v1/...；勿把根地址写成 …/v1，以免路径重复。在本页浏览器内绑定 Key 做连通性验证时，请求经当前网站同源转发；独立脚本、服务端或第三方工具请用上列 API 域名。
与「官方 OpenAI」文档 / SDK 的关系
本站是自有网关，采用常见的 OpenAI 风格约定（如 Bearer 鉴权、部分 /v1 路径与 JSON 字段名），便于把客户端里的 baseURL（或等价配置）设为 https://api.suihemedia.cloud 后做连通性验证。这不表示与 OpenAI 公司公开 HTTP API 在路径、状态码、返回体上逐条一致；且与部分仅展示「JSON + 公网 URL 参考图」的官方示例不同——本站主推 multipart 直传原始参考文件。集成时勿仅凭外部「OpenAI 兼容」文章推断，必须以本页与 GET /v1/models 的实时返回为准。未在本页写明的行为，视为平台扩展或未支持能力。
对接说明不包含内部实现细节或未公开的内部标识。
鉴权
| Header | 说明 |
|---|---|
Authorization | Bearer <API Key>（sk-…），与常见兼容型接口一致 |
x-api-key | 可选，与上一项等价 |
响应可带 X-Request-Id；请求也可传 x-request-id 便于排查。
GET /health
GET /health连通性与 Key 校验；可带 Authorization: Bearer …。
GET /v1/models
GET /v1/models响应形如 { "object": "list", "data": [ … ] }。每条含 object: "model"、created、owned_by、label、user_display_name、request_model 等。对接时创作接口的 model 请优先填该条的 request_model（与列表中的取值规则一致）；与 label 在多数场景相同，视频无库内展示名时请以 request_model 为准。
model 取值（当前环境）
对接时创作接口的 model 请与下表第二列逐字相同（该列来自接口的 request_model，与 label 不一致时会并列显示便于核对）。绑定本页 API Key 后会自动刷新本表，并把「首条图片 / 首条视频」的推荐取值写入下方示例代码。
POST /v1/images/generations
POST /v1/images/generations由 Content-Type 区分两类：multipart/form-data（推荐）与 application/json。参考图优先用 multipart 随请求上传原始文件（字段 images）；由本站完成素材暂存与任务编排。参考图字段名在两种模式下不同，混用会导致「传了图但服务端收不到」。
推荐：
使用
multipart/form-data使用
-F 传 prompt、model、ratio、resolution 等文本字段，以及原始参考图文件字段 images（可多次 -F 'images=@…'；张数与单文件大小以服务端校验为准）。本站接收后会完成发布与拉取编排，对接方无需先把文件传到自建公网图床。若确有必要，可在同一次 multipart 中附加 image_url / image_urls（仅表单模式；且地址须为本站链路可拉取的 https，例如上一步 result_urls 等，勿抄外站文档里的虚构示例域）。兼容：
适合纯文生图或与部分第三方 SDK 对齐：参考图只能写在
application/json适合纯文生图或与部分第三方 SDK 对齐：参考图只能写在
image（字符串）与 images（字符串数组）中。优先用 data:image/…;base64,… 嵌入本地读入的字节；若填远程 https://，须为本站任务链路可拉取的地址（含本站返回的链接），勿在 JSON 中使用 image_url / image_urls。大体积 base64 会加重请求体，有参考原文件时请优先 multipart。JSON 内使用远程 https:// 时，须为本站可拉取地址；否则请改回 multipart 直传 images=@… 或使用 data URI。
受理成功：HTTP 多为 202，Body 含 task_id、id（与 task_id 同为 UUID）、object、status 等。随后轮询 GET /v1/tasks/{task_id}，在 success 时从 result_urls 取本站返回的成图下载地址。
| 字段 | 类型 | 说明 |
|---|---|---|
model | string | 必填；与 GET /v1/models 同类型条目的 request_model 一致（多数情况下与 label 相同） |
prompt | string | 必填 |
ratio | string | 可选，如 1:1、16:9、9:16 |
size | string | 可选，1K～4K 或 WxH（如 1024x1024） |
n | number | 可选，张数（服务端会限制范围） |
images（multipart） | file[] | 可选，推荐：原始参考图文件字段名；可多条 |
image_url / image_urls（multipart） | string | 可选，仅表单模式；须为本站可拉取的 https（如 result_urls 等），非「自建公网图床」演示用占位；image_urls 可为 JSON 字符串数组 |
image（JSON） | string | 可选，单张参考图 URL 或 data:image/…;base64,… |
images（JSON） | string[] | 可选，多张参考图 URL 或 data URI |
response_format | string | 可选，url / b64_json |
quality | string | 可选，low / medium / high / auto |
background | string | 可选，transparent / opaque / auto |
stream | boolean | 可选，部分模型支持 |
watermark | boolean | 可选，以模型能力为准 |
output_format | string | 可选，如 jpeg / png |
tools | array | 可选，如 [{ "type": "web_search" }]；也可用 web_search: true |
sequential_image_generation | string | 可选，如 disabled / auto |
sequential_image_generation_options | object | 可选，组图时如 { "max_images": 15 } |
max_images | number | 可选，与上一项简写 |
optimize_prompt_options | object | 可选，如 { "mode": "standard" } 或 fast |
output_compression | number | 可选，0～100 |
moderation | string | 可选，auto / low |
partial_images | number | 可选，流式相关 0～3 |
seed | number | 可选 |
POST /v1/videos/generations
POST /v1/videos/generations支持 multipart/form-data（推荐）与 application/json（由 Content-Type 与请求路由决定；等价入口另含 POST /v1/videos）。首尾帧、关键帧与全能参考中的音/视频素材，推荐以原始文件随 multipart 表单上传，由本站为您完成中转，并生成创作链路可拉取的地址；对接方无需先把素材上传到自建公网存储再填外链。
multipart 常见字段（按需组合）
文本：
文件：
文本：
prompt、model、ratio、duration、video_resolution、creative_mode（创作档，可选）、function_mode（可省略，服务端可按是否上传帧/素材自动推断）等。文件：
first_frame、end_frame（首尾帧）；frame_1…frame_10 与 JSON 字符串 multi_frames 搭配多关键帧；全能参考下 image_file、image_file_1…、video_file_*、audio_file_* 等与 materials（可为 JSON 字符串）配合。单文件大小等限制以服务端校验为准。application/json
与常见 OpenAI 风格客户端对齐；提示词与部分参考信息可用
与常见 OpenAI 风格客户端对齐；提示词与部分参考信息可用
prompt、content、materials 等字段（以实际为准）。平面 JSON 下清晰度请用 resolution 或 quality（如 720p）；勿仅依赖 video_resolution 字段名（该名主要为 multipart 表单使用）。受理状态码：表单直传分支常见 202；JSON 分支常见 200——均以响应体中的 task_id 为准继续轮询 GET /v1/tasks/…。注意：JSON 受理响应里的 id 可能为 cgt- 前缀形态，不能直接用作 GET /v1/tasks/{task_id} 的路径参数；请使用同响应中的 task_id（UUID）。另可使用 GET /v1/videos/{id} 携带受理响应中的 id（含 cgt- 前缀）查询受理侧简要信息；该接口返回的字段与 GET /v1/tasks/{task_id} 的任务详情不完全相同，轮询完成状态与获取成片请以 tasks 接口为准。出参：终态后从 GET /v1/tasks/{task_id} 的 result_urls 读取本站返回的成片下载地址。
| 字段 | 类型 | 说明 |
|---|---|---|
JSON 体常用（application/json） | ||
model | string | 必填；与 GET /v1/models 视频条目的 request_model 一致 |
prompt | string | 必填；亦可配合 content 等结构化字段（以实际为准） |
content | object | 可选，结构化内容与参考信息 |
ratio | string | 可选，宽高比 |
duration | number | 可选，秒 |
resolution / quality（JSON 平面体） | string | 可选，清晰度，如 720p、1080p（与网关平面解析一致） |
video_resolution（multipart） | string | 可选，表单常用字段，如 720p、1080p |
function_mode | string | 可选，如 first_last_frames、omni_reference 等 |
creative_mode | string | 可选，创作档：native（原生模式）或 super_economy（超级节约）；亦可用中文「原生模式」「超级节约模式」。省略时：成片 480p 默认 native；720p / 1080p / 2k / 4k 等高于 480p 的档位默认 super_economy（与网页创作区、旧栈未传参行为一致）。2k / 4k 不可传 native。 |
channel | string | 可选 |
generate_audio | boolean | 可选 |
watermark | boolean | 可选 |
| multipart 文件字段名（节选，与上文提示块一致） | ||
first_frame / end_frame | file | 可选，首尾帧原始图 |
frame_1 … frame_10 | file | 可选，多关键帧；常配合 multi_frames（字符串化 JSON） |
image_file* / video_file* / audio_file* | file / URL 字符串 | 可选，全能参考；部分键也可传可拉取的 http(s) 字符串作补充 |
创作档（creative_mode）与旧栈对接
网页「视频创作」会在提交时带上
网页「视频创作」会在提交时带上
creative_mode；若您从旧环境迁移、请求体未包含该字段，网关将按成片分辨率自动选择：480p → 原生（native）；高于 480p → 超级节约（super_economy）（上游先生成 480p，再画质增强至目标分辨率）。预扣积分、目录 SKU 与任务 request_params.creative_mode 均按解析后的档位计费与履约。GET /v1/tasks/{task_id}
GET /v1/tasks/{task_id}查询图片、视频等异步任务。路径中的 {task_id} 须为任务 UUID（与图片及视频 multipart 受理、以及视频 JSON 受理响应中的 task_id 一致）。成功体含 object: "task"、status、result_urls、fail_reason、进度字段等。result_urls 为成片 / 成图的可下载地址列表，由本站随任务状态返回（必要时重复查询可拿到刷新后的链接）；业务下载成品请使用该字段，无需自行拼接本站以外的存储路径。
调用流程与示例
共同流程：提交创作请求 → 取响应中的
task_id（须为 UUID）→ 轮询 GET /v1/tasks/{task_id} → 成功态下从 result_urls 下载本站返回的成品。视频 JSON 受理响应里的 id 可能为 cgt-…，勿用于 /v1/tasks/…；请只用其中的 task_id。图片受理及 multipart 视频受理中 id 与 task_id 一般为同一 UUID，可与 task_id 互换。推荐路径：参考素材用
multipart/form-data 直传原始文件到本站；受理 HTTP 状态码图片多为 202，视频在表单模式下多为 202、JSON 模式下多为 200（以实际为准）。以下示例假定已设置环境变量：API_BASE=https://api.suihemedia.cloud（根地址，不要以 /v1 结尾）、API_KEY（你的 sk-…）。Windows 可改用 set API_BASE=https://api.suihemedia.cloud 或 PowerShell $env:API_BASE=…。
推荐：图片 · multipart 上传参考原文件（curl）
model 须与 GET /v1/models 同类型条目的 request_model 完全一致。参考图随 images=@ 上传，无需事先托管到公网图床。
Shell
curl -sS -i -X POST "${API_BASE}/v1/images/generations" \
-H "Authorization: Bearer ${API_KEY}" \
-F 'prompt=基于参考图生成同构图，色彩更明快' \
-F 'model=你的图片模型展示名' \
-F 'ratio=1:1' \
-F 'resolution=2k' \
-F 'images=@/path/to/local-reference.png'推荐：视频 · multipart 上传首尾帧原文件（curl）
首帧 / 尾帧以原始图片文件提交；文本参数与网页创作区一致。可省略 creative_mode：例如 video_resolution=720p 时默认超级节约，480p 时默认原生（见上文参数表）。
Shell
curl -sS -i -X POST "${API_BASE}/v1/videos/generations" \
-H "Authorization: Bearer ${API_KEY}" \
-F 'prompt=镜头从海面缓缓推向城市' \
-F 'model=你的视频模型展示名' \
-F 'ratio=16:9' \
-F 'duration=5' \
-F 'video_resolution=720p' \
-F 'first_frame=@/path/to/start.png' \
-F 'end_frame=@/path/to/end.png'兼容：图片 · JSON 文生图（curl）
无参考图或需对接仅支持 JSON 的 SDK 时使用。受理成功多为 HTTP 202。
Shell
curl -sS -i -X POST "${API_BASE}/v1/images/generations" \
-H "Authorization: Bearer ${API_KEY}" \
-H "Content-Type: application/json" \
-d '{
"model": "你的图片模型展示名",
"prompt": "测试画面，简洁插画风格",
"size": "1024x1024",
"n": 1
}'兼容：图片 · JSON 内含参考图 data URI（curl，可选）
有参考图时优先 multipart images=@…：原文件由本站接收并完成可拉取托管，不要求您先传到公网。若客户端只能发 JSON，可将参考图读成 data:image/…;base64,… 写入 image / images（下列为 1×1 PNG 的最小示例，真实图请用脚本生成完整 base64）。大文件请避免 JSON，改用 multipart。
Shell
curl -sS -X POST "${API_BASE}/v1/images/generations" \
-H "Authorization: Bearer ${API_KEY}" \
-H "Content-Type: application/json" \
-d '{
"model": "你的图片模型展示名",
"prompt": "在保持人物姿态的前提下换成水彩风",
"size": "1024x1024",
"n": 1,
"image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8z8BQDwAEhQGAhKmMIQAAAABJRU5ErkJggg=="
}'可选：multipart 中的 image_url（仅当您已有本站可拉取地址）
常规对接只传 -F 'images=@本地文件' 即可。仅当您手上的 https 已被本站判定为可拉取（例如上一步任务 result_urls、素材库返回的下载地址）时，才在同一次请求中附加 image_url / image_urls；不要使用外站文档里的虚构域名占位。
Shell
# 主路径：原始参考图直传；无本站可拉取的 IMAGE_REF 时请删去最后一行
curl -sS -X POST "${API_BASE}/v1/images/generations" \
-H "Authorization: Bearer ${API_KEY}" \
-F 'prompt=按参考构图生成新场景' \
-F 'model=你的图片模型展示名' \
-F 'ratio=16:9' \
-F 'resolution=2k' \
-F 'images=@/path/to/local-reference.png'
# -F "image_url=${IMAGE_REF}"轮询任务并取成品下载地址（curl）
将受理响应中的 task_id（或 id）代入路径；status 为成功时，result_urls 即本站提供的成片/成图下载链接。
Shell
TASK_ID='上一步返回的task_id'
curl -sS "${API_BASE}/v1/tasks/${TASK_ID}" \
-H "Authorization: Bearer ${API_KEY}" | python3 -m json.tool若已安装 jq，也可：curl -sS … | jq .；生产环境建议带退避间隔轮询。
兼容：图片 · JSON（Python 3 标准库）
仅演示 JSON 路径；带参考图文件时请改用可发 multipart 的 HTTP 客户端。
Python
import json, os, time, urllib.request
API_BASE = os.environ["API_BASE"].rstrip("/")
API_KEY = os.environ["API_KEY"]
def api_json(method, path, body=None):
url = API_BASE + path
data = None if body is None else json.dumps(body).encode("utf-8")
req = urllib.request.Request(
url,
data=data,
method=method,
headers={
"Authorization": "Bearer " + API_KEY,
"Content-Type": "application/json",
},
)
with urllib.request.urlopen(req) as resp:
raw = resp.read().decode("utf-8")
return resp.status, json.loads(raw) if raw else {}
status, submit = api_json("POST", "/v1/images/generations", {
"model": "你的图片模型展示名",
"prompt": "测试画面",
"size": "1024x1024",
"n": 1,
})
task_id = submit.get("task_id") or submit.get("id")
# 视频 JSON 受理：若 id 为 cgt- 前缀，不可用于 /v1/tasks/，请仅用 task_id
for _ in range(60):
_, task = api_json("GET", f"/v1/tasks/{task_id}")
st = task.get("status")
if st in ("success", "failed", "cancelled"):
print(json.dumps(task, ensure_ascii=False, indent=2))
break
time.sleep(2)兼容：视频 · JSON 提交（curl）
平面 JSON 用 resolution 或 quality 表示成片清晰度；可省略 creative_mode（480p 默认原生，高于 480p 默认超级节约）。下列示例未传 creative_mode，等价于 super_economy。
Shell
curl -sS -X POST "${API_BASE}/v1/videos/generations" \
-H "Authorization: Bearer ${API_KEY}" \
-H "Content-Type: application/json" \
-d '{
"model": "你的视频模型展示名",
"prompt": "一只猫在草地奔跑",
"ratio": "16:9",
"duration": 8,
"resolution": "720p"
}'JSON 分支受理常见为 HTTP 200；取 task_id 后轮询 GET /v1/tasks/…，从 result_urls 下载成片。受理响应或任务详情中可能带回实际采用的 creative_mode（含服务端默认补全）。
错误与兼容说明
| HTTP | 说明 |
|---|---|
400 | 参数错误 |
401 | 鉴权失败 |
402 | 余额或结算额度不足 |
429 | 限流或并发上限 |
500 / 503 | 服务端异常或繁忙 |
错误多为 { "error": { "message", "type", "code" } }；部分场景另含 error_detail 供兼容形态 SDK 解析。
与常见「OpenAI 兼容」公开文档的差异：① 成品不在受理响应里内联返回，须用 result_urls 取本站给出的下载地址；② 参考素材主推 multipart 直传原始文件，与部分「仅 JSON + 公网 URL」示例不同；③ 图片受理多为 202，视频在表单模式下多为 202、JSON 模式下多为 200；④ 图像参考在 JSON 下仅识别 image / images，与 multipart 下的 image_url / image_urls 勿混用；⑤ 不提供对话类 completions / chat；⑥ 若 SDK 仍请求官方域名而未改 baseURL，请求不会到达本站。
素材库
与网页素材能力一致；上传为 multipart，其余列表为 JSON。
虚拟人像素材按上传条数计费；计价说明请以 GET /v1/channels 返回的 virtualPortraitStorage 为准。
集成方子客户命名空间（可选）：若您只用一个本站 API Key 对接、但需在服务端区分多个终端用户的虚拟人像素材，可为每个终端用户传入稳定且唯一的子标识（对方 user id、业务 key 等均可）。上传、列表、下载原文件、删除时须使用同一子标识；不传或空字符串为默认命名空间，与存量行为兼容。传递优先级：X-Integrator-Sub-Key 请求头 → 查询参数 integrator_sub_key → JSON 字段 integrator_sub_key 或 sub_customer_key → 列表还可写 filter.integrator_sub_key。trim 后最长 128 字符，勿含 ASCII 控制字符。每个 (API Key, 子标识) 单独占用该 Key 的 max_virtual_portrait_assets 条数上限。列表 items[] 中含 integrator_sub_key 便于核对命名空间。
POST
/v1/asset-library/assetsmultipart/form-data：file（必填）、可选 name、thumbnail（Data URL）；可选 integrator_sub_key / sub_customer_key（与请求头等价，任选其一即可）。
POST
/v1/asset-library/assets/listJSON：filter（可选 asset_type、status、integrator_sub_key）、page_number、page_size；亦可仅用请求头/顶层字段传子标识。响应含 items、total_count；每条素材含 integrator_sub_key。
GET
/v1/asset-library/assets/{id}/file下载图片原文件（仅图片类素材）；须携带与创建该素材时一致的子标识（请求头或 ?integrator_sub_key=）。
DELETE
/v1/asset-library/assets/{id}删除指定素材 ID；须携带与创建时一致的子标识（请求头或查询参数）。
代码示例（curl）
与上文「调用流程与示例」一致：API_BASE=https://api.suihemedia.cloud（不以 /v1 结尾）、API_KEY。将 /path/to/... 换成本地图片路径；ASSET_ID 为上传或列表返回的素材 id。
上传素材（默认命名空间）
curl -sS -X POST "${API_BASE}/v1/asset-library/assets" \
-H "Authorization: Bearer ${API_KEY}" \
-F 'file=@/path/to/virtual-portrait.png' \
-F 'name=my-portrait'上传素材（为终端用户划分命名空间：请求头）
export SUB='your-end-user-id-or-key'
curl -sS -X POST "${API_BASE}/v1/asset-library/assets" \
-H "Authorization: Bearer ${API_KEY}" \
-H "X-Integrator-Sub-Key: ${SUB}" \
-F 'file=@/path/to/virtual-portrait.png'列出素材（分页）
curl -sS -X POST "${API_BASE}/v1/asset-library/assets/list" \
-H "Authorization: Bearer ${API_KEY}" \
-H 'Content-Type: application/json' \
-d '{"page_number":1,"page_size":20,"filter":{}}' | python3 -m json.tool列出某子命名空间下的素材
curl -sS -X POST "${API_BASE}/v1/asset-library/assets/list" \
-H "Authorization: Bearer ${API_KEY}" \
-H "X-Integrator-Sub-Key: ${SUB}" \
-H 'Content-Type: application/json' \
-d '{"page_number":1,"page_size":20}' | python3 -m json.tool下载图片原文件
# 默认命名空间（上传时未传子标识）：
curl -sS -o "./portrait.bin" "${API_BASE}/v1/asset-library/assets/${ASSET_ID}/file" \
-H "Authorization: Bearer ${API_KEY}"
# 带子标识时须与上传一致（任选 header 或查询参数其一）：
curl -sS -o "./portrait.bin" "${API_BASE}/v1/asset-library/assets/${ASSET_ID}/file" \
-H "Authorization: Bearer ${API_KEY}" \
-H "X-Integrator-Sub-Key: ${SUB}"删除素材
# 默认命名空间：
curl -sS -X DELETE "${API_BASE}/v1/asset-library/assets/${ASSET_ID}" \
-H "Authorization: Bearer ${API_KEY}"
# 带子标识：
curl -sS -X DELETE "${API_BASE}/v1/asset-library/assets/${ASSET_ID}" \
-H "Authorization: Bearer ${API_KEY}" \
-H "X-Integrator-Sub-Key: ${SUB}"子标识中含 &、空格等时，若用查询参数请自行 URL 编码；优先使用请求头可避免编码问题。