跳转到主要内容
POST
创建自定义主体

授权

Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

请求体

application/json
element_name
string
必填

主体名称,最长 20 个字符。

Maximum string length: 20
示例:

"my-character"

element_description
string
必填

主体描述,最长 100 个字符。

Maximum string length: 100
示例:

"视频系列主角"

reference_type
enum<string>
必填

参考方式。image_refer 通过多张图片定义主体外观;video_refer 通过一段参考视频定义视频角色主体。

可用选项:
image_refer,
video_refer
示例:

"image_refer"

element_image_list
object

reference_type 为 image_refer 时必填。提供一张正面参考图和 1–3 张不同角度或特写参考图。支持可访问 URL 或原始 Base64;格式为 JPG/JPEG/PNG,不超过 10 MB,宽高均不小于 300 px,宽高比 1:2.5 至 2.5:1。

element_video_list
object

reference_type 为 video_refer 时必填,图片参考方式下不生效。支持一段 MP4/MOV 视频,时长 3–8 秒、1080p、画面比例 16:9 或 9:16,不超过 200 MB。视频角色主体仅支持 Kling Video O3 及后续模型。

element_voice_id
string

可选绑定音色 ID。图片主体仅人物或类人角色支持绑定音色。

tag_list
object[]

标签列表。可用 tag_id:

  • o_101:热梗
  • o_102:人物(Character)
  • o_103:动物
  • o_104:道具
  • o_105:服饰
  • o_106:场景(Scene)
  • o_107:特效
  • o_108:其他

响应

主体创建任务已提交

id
string

任务 ID

示例:

"863121016086724692"

task_id
string

任务 ID(同 id)

示例:

"863121016086724692"

object
string

固定 video

示例:

"video"

model
string

固定 kling-element

示例:

"kling-element"

status
string

初始任务状态

示例:

"queued"

progress
integer

进度 0–100

示例:

0

created_at
integer

Unix 时间戳

示例:

1773812605