Skip to main content
POST
cURL
素材提交后会保存在你的 APIPod 账号下(素材的查询与删除仅限本人提交的素材)。在 Seedance 2.0/2.5 生成请求中直接以 URL 形式传入的素材默认会先在上游送审(real_person 默认 true),送审通过、任务受理后自动登记到你的素材库;确认素材不含真人时可设置 real_person=false 跳过送审、直接透传。在 Seedance 2.0/2.5 系列视频生成请求中通过 assetId://{assetId} 引用素材——image_url / image_urlsvideo_urlsaudio_url / audio_urls 字段均支持引用图片、视频、音频三类素材。 素材 ID 为全平台共享标识:任何账号都可以在生成请求中引用已知的 assetId,不限提交者,与公开 URL 的共享语义一致。其他视频模型不支持 assetId:// 引用。只有 ACTIVE 状态的素材可以通过校验。

素材状态说明

授权

Authorization
string
header
必填

在 Authorization 请求头中使用 APIPod API key 作为 Bearer token。

请求体

application/json
assetType
enum<string>
必填

素材媒体类型,大小写不敏感。

可用选项:
Image,
Video,
Audio
示例:

"Image"

url
string
必填

调用方原始素材 URL,需可被服务端访问;当前不支持 base64 入参。

示例:

"https://example.com/person.png"

name
string

可选的展示名称,超过 50 个 Unicode 字符会自动截断。

示例:

"真人参考图"

响应

素材已受理

素材提交的标准响应信封

code
integer
必填

HTTP 状态码。

message
string
必填

响应消息。

Allowed value: "success"
data
素材 · object
必填