MoonApiX Docs

简体中文

English

简体中文

English

外观

Seedance SH 系列 ​

SH 系列提供四个独立公开模型，使用 MoonApiX API Key 创建异步视频任务。支持 MoonApiX 统一通用参数和官方兼容参数；单次请求只选择一套字段。

如需明确选择本系列，请使用带 -sh 的公开模型名。官方模型名 doubao-seedance-2-0-260128、doubao-seedance-2-0-fast-260128、doubao-seedance-2-0-mini-260615、doubao-seedance-2-5-260628 可参与 MoonApiX 的共享模型调度，不能据此认定请求使用了 SH 系列。本页的真实验收使用 SH 公开模型名，未通过官方模型名定向验证本系列。

模型与能力边界 ​

公开模型分辨率整数目标时长图片 / 视频 / 音频上限素材总量上限
seedance-2.0-sh480P / 720P / 1080P / 4K4 - 15 秒9 / 3 / 315
seedance-2.0-sh-fast480P / 720P4 - 15 秒9 / 3 / 315
seedance-2.0-sh-mini480P / 720P4 - 15 秒9 / 3 / 315
seedance-2.5-sh480P / 720P / 1080P4 - 30 秒30 / 10 / 1050

表格表示当前接口校验范围，不代表每个组合都已完成生成验证。seedance-2.5-sh 已验证两套创建协议的纯文本、1080P、16:9、4 秒和生成音频组合；实际成品为 1920 × 1080，包含音轨，媒体时长约 4.064 秒。其他型号、分辨率、参考素材组合和高级功能本次尚未实测。

所有型号均接受 duration: -1 自动选择时长，duration: 0 无效。省略时长时默认目标为 5 秒，默认分辨率为 720P，默认比例为 adaptive。需要固定规格时应显式传入参数；实际媒体时长可能包含编码帧尾差异。

MoonApiX 统一通用参数 ​

bash
curl https://moonapix.com/v1/videos \
  -H "Authorization: Bearer <MOONAPIX_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5-sh",
    "prompt": "A small ceramic sculpture rotates slowly on a clean studio table. A steady camera captures the details, with gentle ambient sound.",
    "size": "1080p",
    "aspect_ratio": "16:9",
    "duration": 4,
    "generate_audio": true
  }'

也可以使用 /v1/video/generations。请保存创建响应中的公开 id 或 task_id，不要因创建请求超时就立即重复提交。

官方兼容参数 ​

两套协议使用相同的 MoonApiX 公开模型名和 API Key。不要同时提交 content[] 和 references[]，或重复提交提示词。

统一参数官方兼容参数
promptcontent[].type: "text" 与 text
references[].media_type 与 urlcontent[] 中的 image_url、video_url、audio_url
references[].role媒体条目的 role
sizeresolution
aspect_ratioratio
duration、generate_audio同名字段
bash
curl https://moonapix.com/api/v3/contents/generations/tasks \
  -H "Authorization: Bearer <MOONAPIX_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5-sh",
    "content": [
      {
        "type": "text",
        "text": "A small ceramic sculpture rotates slowly on a clean studio table. A steady camera captures the details, with gentle ambient sound."
      }
    ],
    "resolution": "1080p",
    "ratio": "16:9",
    "duration": 4,
    "generate_audio": true
  }'

content[] 也可用于 /v1/videos。参数形状兼容不表示所有官方高级功能均可使用；本页的已验证示例采用轮询。

通用参数也可放在 input 或 metadata 中，同一参数的优先级为顶层、input、metadata。同一层中互相冲突的字段或别名会被拒绝。显式 false 会被保留；建议将生成参数直接放在顶层，避免重复提交。

kwargs 仅接受 generate_audio、draft、draft_task_id、off_peak 四个键，也可放在 input.kwargs 或 metadata.kwargs 中。其中 generate_audio、draft、off_peak 为布尔值，draft_task_id 为公开草稿任务 ID 字符串。仍按顶层 > input > metadata 选择选项；同一层直接字段与 kwargs 中的同名字段必须一致，否则报错，未知 kwargs 键也会报错。推荐直接使用顶层字段。

生成选项请求契约与验收范围
generate_audio布尔值，控制生成音轨；本页纯文本示例的 true 已实测。
draft仅 2.5 支持的布尔值，true 请求草稿；2.0 系列必须省略此字段，包括 false。尚未实测。
draft_task_id仅 2.5 使用的公开草稿任务 ID，转正式规则见下文；尚未实测。
off_peak布尔值，选择错峰选项；尚未实测。
callback_url仅 /api/v3/contents/generations/tasks 接受，由 MoonApiX 处理；/v1/videos 不接受。本次未验证回调交付，示例使用轮询。

比例与参考素材 ​

比例可选 adaptive、21:9、16:9、9:16、4:3、3:4、1:1。adaptive 按输入与生成模式确定画面比例；固定输出比例请显式指定。

媒体角色规则
图片reference_image作为内容参考，不要求成为严格首帧。
图片first_frame严格首帧，最多一张。
图片last_frame严格尾帧，最多一张，必须与首帧一起提交。
视频reference_video作为视频参考；当前视频素材准备与引用生成尚未完成验证。
音频reference_audio作为音频参考，不等同于开启 generate_audio。

首尾帧不能与普通图片、视频或音频参考混用。seedance-2.5-sh 的严格首尾帧模式必须使用 aspect_ratio: "adaptive" 或 ratio: "adaptive"，也可省略比例；固定比例会被拒绝。

2.0 标准、Fast、Mini 的音频参考必须同时包含图片或视频。2.5 的接口校验允许独立音频输入，但该组合尚未完成生成验证。

需要参考素材时，优先使用你有权使用、可匿名直接获取的稳定公网媒体 URL，并通过 references[] 显式指定类型与角色。地址在任务完成前必须持续有效；不要使用登录页面、过期地址或仅预览页面。素材数量满足上限并不保证格式、内容安全及组合要求均已满足。

素材 ID 与准备状态 ​

SH 系列具有独立的素材准备范围。请保存 MoonApiX 的 asset_id / asset_ref，并按实际生成模型查询 Preparation；其他系列的准备结果不能直接证明 SH 可用。

  • 图片的 AIGC 素材准备已通过，但尚未验证使用该素材引用完成视频生成。
  • 视频的 AIGC 素材准备尚未完成成功验收，本页不承诺视频素材引用可用于生成；不要将其视为 generation_ready=true。
  • 音频没有独立的 AIGC 素材认证流程；输入可用性仍按所选模型与媒体要求判断。
  • SH 未开放人脸扫描、真人活体认证或对应的活体素材组流程。

asset.status=ready 仅表示素材身份可用；托管完成或图片准备成功都不能代替生成验收。使用 Asset://asset_xxx 前，按目标模型查询并同时确认：

text
asset.status = ready
preparation.status ∈ { ready, not_required }
preparation.generation_ready = true

查询素材是只读操作。准备失败不会删除已建立的素材身份，也不应触发自动重新创建；具体操作见上传素材和查询素材。

查询与下载 ​

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

官方兼容查询入口：

bash
curl https://moonapix.com/api/v3/contents/generations/tasks/{task_id} \
  -H "Authorization: Bearer <MOONAPIX_API_KEY>"

先检查 status 和 error，只有成功终态且没有错误时才读取 video_url、url 或 content.video_url。URL 出现本身不表示成功。请使用完整返回地址并及时下载，不要自行替换域名、拼接路径或删除查询参数。

若成功查询未提供可用结果地址，可使用 /v1/videos/{task_id}/content 兼容下载入口，HTTP 客户端应跟随重定向。完整状态与下载说明见查询视频任务。

计费与高级功能 ​

SH 系列按实际输出 Token 结算，用量口径为 usage.completion_tokens；价格档位区分分辨率与是否包含视频输入，不按固定秒数或固定次数报价。创建时可能预扣额度，成功后的实际输出用量用于结算；失败退款与最终金额以 MoonApiX 消费记录为准。当前价格请查询控制台或价格接口，不要由示例时长推算固定费用。

2.5 的草稿及由草稿生成正式视频、错峰参数、回调、长时长、首尾帧和混合参考组合本次尚未实测。不要将上述能力作为已验收的默认接入路径；当前示例使用纯文本与轮询。取消、Remix 和扩展视频不在 SH 支持范围内。

2.5 的草稿请求校验要求 draft: true 和显式 resolution: "480P"。转正式请求使用七天内成功、仍有转正式资格且属于当前用户的公开草稿任务，仅传 model、draft_task_id 和显式 resolution: "1080P"；提示词、素材、时长、比例和声音设置从草稿继承，不要重复提交，包括空值。该流程仅说明当前请求契约，尚未完成真实生成验收。

SH 请求不接受下列字段，即使值为 false、0 或空值也会拒绝：seed、frames、camera_fixed、watermark、return_last_frame、priority、execution_expires_after、safety_identifier、service_tier、tools、output_format、response_format、negative_prompt、system_prompt、omni_reference_task_type、file、files、file_url、file_urls、fps、n、width、height。不要直接复用其他系列包含这些字段的请求。

相关页面 ​