MoonApiX Docs

Appearance

seedance-2.5-cl ​

seedance-2.5-cl 是 MoonApiX 的 Seedance 2.5 标准视频模型，适合文生视频、图生视频和图片、视频、音频混合参考。创建任务时，model 固定填写 seedance-2.5-cl。

当前配置 ​

项目说明
创建入口POST /v1/videos
查询入口GET /v1/videos/{task_id} 或 GET /v1/tasks/{task_id}
输出格式mp4、mov
分辨率480P、720P、1080P
时长4 - 30 秒
比例16:9、9:16、1:1、4:3、3:4、21:9；部分任务支持 adaptive
生成音频支持，省略 generate_audio 时默认开启

实际可用参数以 GET /v1/models 和当前 API Key 权限为准。

能力边界 ​

能力支持情况
文生视频支持
单图和多图参考最多 30 张图片
参考视频最多 10 个
参考音频最多 10 个；需要同时提供图片或视频
混合参考素材合计最多 50 个
首帧 / 尾帧支持，按请求中的 role 指定
真人参考支持；仍需通过内容安全审核

创建视频任务 ​

文生视频 ​

bash
curl https://moonapix.com/v1/videos \
  -H "Authorization: Bearer <MOONAPIX_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5-cl",
    "prompt": "清晨海边，镜头平稳向前推进，电影感光线。",
    "duration": 4,
    "aspect_ratio": "16:9",
    "size": "480p",
    "generate_audio": true
  }'

图片参考 ​

新接入推荐使用 references[]。图片可以是无需登录即可抓取的稳定公网 URL，也可以是已经按 seedance-2.5-cl 准备完成的 Asset:// 素材引用：

json
{
  "model": "seedance-2.5-cl",
  "prompt": "图中女孩对着镜头说“茄子”，镜头缓慢环绕。",
  "references": [
    {
      "media_type": "image",
      "role": "reference_image",
      "url": "Asset://asset_xxx",
      "alias": "人物"
    }
  ],
  "duration": 4,
  "aspect_ratio": "9:16",
  "size": "480p",
  "generate_audio": true
}

认证素材 ​

需要复用认证素材时，先调用 POST /v1/assets/uploads，使用 mode=asset 和目标模型 seedance-2.5-cl，然后等待素材详情中的 generation_ready=true、preparation_status=ready。创建视频时必须显式传入返回的 Asset://asset_xxx。

认证素材引用与普通公网 URL 是两种不同的输入语义：

  • Asset://asset_xxx 表示使用已经按当前模型准备并认证的素材。
  • 如果素材引用缺少当前模型的可用绑定、状态未 ready 或引用解析失败，视频请求会直接返回错误。
  • 认证素材不会静默降级为公网 URL；如果业务需要使用公网 URL，应在请求中明确传入公网 URL。
  • 不同 Seedance 模型线的 Asset:// 素材不要直接混用，必须按实际生成模型重新准备或确认。

创建认证素材 ​

bash
curl https://moonapix.com/v1/assets/uploads \
  -H "Authorization: Bearer <MOONAPIX_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5-cl",
    "mode": "asset",
    "type": "image",
    "url": "https://example.com/person.png"
  }'

素材上传和认证本身不计视频生成费用；后续视频任务按模型计费。已上传素材不会自动附加到新任务，每次请求都要显式传入素材引用。

多素材参考 ​

json
{
  "model": "seedance-2.5-cl",
  "prompt": "保持 @人物 的外观，参考 @动作 的镜头节奏，并融合 @音乐。",
  "references": [
    { "media_type": "image", "role": "reference_image", "url": "Asset://asset_image_xxx", "alias": "人物" },
    { "media_type": "video", "role": "reference_video", "url": "Asset://asset_video_xxx", "alias": "动作" },
    { "media_type": "audio", "role": "reference_audio", "url": "Asset://asset_audio_xxx", "alias": "音乐" }
  ],
  "duration": 8,
  "aspect_ratio": "16:9",
  "size": "720p",
  "generate_audio": true
}

音频参考必须和图片或视频参考一起提交，不能单独提交音频输入。每个素材的 role 应明确填写，alias 在同一请求内应唯一。

参数 ​

字段类型说明
modelstring必填，seedance-2.5-cl。
promptstring视频描述，可用 @alias 指代参考素材。
references[]array图片、视频或音频参考；条目使用 media_type、role、url 和可选 alias。
durationinteger4 - 30 秒。
aspect_ratio / ratiostring画面比例；具体可用值以模型能力为准。
size / resolutionstring480p、720p 或 1080p。
generate_audioboolean是否生成音轨，省略时默认 true。
watermarkboolean是否添加水印。
callback_urlstring可选回调地址。

查询结果 ​

创建响应只代表任务已提交。请保存 id 或 task_id，并继续查询任务状态；只有 status=succeeded 时才读取最终视频地址。失败时请读取 error，不要把失败响应中的 URL 当作成品。

bash
curl https://moonapix.com/v1/videos/{task_id} \
  -H "Authorization: Bearer <MOONAPIX_API_KEY>"

相关页面 ​