模型与能力

MoonApiX 按能力提供 OpenAI-compatible、多模态、视频、音乐、数字人和素材接口。公开文档只描述用户可直接调用的模型 ID、任务接口和素材接口。

能力	说明	主要入口
OpenAI-compatible	对话、Responses、Messages、Embeddings 和音频基础能力	/v1/*
图片	图片生成、编辑、变体和异步图片任务	/v1/images/*
视频	视频生成、查询、取消、内容读取、延展和 remix	/v1/videos、/v1/videos/{task_id}
数字人	形象素材、音色素材、语音和数字人视频合成	/v1/assets/uploads、/v1/tasks
音乐	音乐生成、歌词生成、音效、编辑和后处理	/v1/tasks
素材资源	上传、登记、分组和复用素材	/v1/assets/*、/v1/asset-groups/*

任务型模型

任务型模型通常通过 POST /v1/tasks 或对应能力入口提交。提交后保存 task_id，再使用 GET /v1/tasks/{task_id} 或能力专用查询接口读取状态。

本次新增模型入口

• Seedance SH 系列：seedance-2.0-sh、seedance-2.0-sh-fast、seedance-2.0-sh-mini、seedance-2.5-sh，入口为 /v1/videos 或 /api/v3/contents/generations/tasks。2.0 支持 4 - 15 秒、最多 9 图 + 3 视频 + 3 音频；2.5 支持 4 - 30 秒、最多 30 图 + 10 视频 + 10 音频。标准 2.0 支持 480P / 720P / 1080P / 4K，Fast/Mini 支持 480P / 720P，2.5 支持 480P / 720P / 1080P；具体参数与认证限制见独立页面。
• 图片异步模型：seedream-5.0、seedream-4.5、wan2.7-image-pro；已开通异步能力的 API Key 还可使用 gemini-3-pro-image-preview。入口为 /v1/images/generations/async，查询为 /v1/images/tasks/{task_id}。
• 视频模型：happyhorse-1.0、wan2.7，入口为 /v1/videos，查询为 /v1/tasks/{task_id} 或 /v1/videos/{task_id}。
• Seedance SG 系列：seedance-2.0-sg-mini、seedance-2.0-sg、seedance-2.0-sg-fast、seedance-2.5-sg，支持通用与官方兼容参数、单图及混合参考，按输出 Token 结算；2.0 标准版支持 480P / 720P / 1080P / 4K，Fast/Mini 支持 480P / 720P，2.5 支持 480P / 720P / 1080P。
• Seedance NT 系列：seedance-2.0-nt、seedance-2.0-nt-fast、seedance-2.0-nt-mini、seedance-2.5-nt，入口为 /v1/videos 或 /api/v3/contents/generations/tasks，2.0 标准版和 2.5 支持 720P/1080P，Fast/Mini 仅支持 720P；2.0 标准/Fast/Mini 支持 4 - 15 秒，2.5 支持 4 - 30 秒，按实际 usage.total_tokens 结算。
• Seedance-2 CL 轻量模型：seedance-2.0-cl-mini，入口为 /v1/videos，支持 480P / 720P、4 - 15 秒、文生视频、图生视频、视频参考和本模型线 Asset:// 素材引用。
• Seedance-2.5 CL：seedance-2.5-cl，入口为 /v1/videos，支持 4 - 30 秒、480P / 720P / 1080P、图片/视频/音频混合参考和按本模型准备的 Asset:// 认证素材。认证素材解析失败会直接返回错误，不会回退为公网 URL。
• Seedance-2 CL-B 系列：seedance-2.0-cl-b-fast、seedance-2.0-cl-b-mini，入口为 /v1/videos，并兼容 /api/v3/contents/generations/tasks 官方形状；参数、素材类型和能力边界分别与火山官方 Seedance 2.0 Fast / Mini 契约一致。
• Seedance-2 SZ 系列：seedance-2.0-sz、seedance-2.0-sz-fast、seedance-2.0-sz-mini、seedance-2.5-sz，入口为 /v1/videos；支持图片、视频和音频参考，按 Seedance 官方 Token 用量维度计费，具体能力以模型列表接口为准。
• Seedance-2 GL 系列：seedance-2.0-gl、seedance-2.0-gl-fast、seedance-2.0-gl-mini，入口为 /v1/videos。三个型号支持最多 9 张图片、3 个视频、3 个音频，参考素材合计最多 15 个，支持真人参考；标准版支持到 1080P，Fast 和 Mini 支持 480P / 720P。
• Seedance-2 原生系列：doubao-seedance-2-0-260128、doubao-seedance-2-0-fast-260128、doubao-seedance-2-0-mini-260615，入口为 /v1/videos，支持 4 - 15 秒以及图片、视频、音频参考；标准版支持到 1080P，Fast 和 Mini 支持 480P / 720P。
• Moon-2 WC 720P 系列：moon-2.0-wc-720p、moon-2.0-wc-b-720p、moon-2.0-wc-b-720p-fast、moon-2.0-wc-c-720p、moon-2.0-wc-d-720p、moon-2.0-wc-e-720p、moon-2.0-wc-f-720p，入口为 /v1/videos。七个型号均支持真人；基础、B 和 B Fast 最多支持 9 图 + 3 视频 + 3 音频和总计 12 个素材，其中 B / B Fast 不支持纯文本；F 支持纯文本、4 到 15 秒，最多 9 图 + 3 视频 + 3 音频，总计不超过 12 个素材且音频必须带图片；C 支持纯文本和最多 9 图，不支持视频/音频；D / E 支持纯文本或最多 4 图 + 3 视频 + 1 音频，禁止纯音频。
• Moon-2 GL 720P 系列：moon-2.0-gl-a-720p、moon-2.0-gl-a-720p-fast，入口为 /v1/videos。两个型号均支持纯文本、人物参考及最多 4 图 + 3 视频 + 1 音频，支持 4 到 15 秒和 16:9、9:16、1:1 比例，音频需搭配图片或视频。
• Moon-2.5 GL 系列：moon-2.5-gl-a，入口为 /v1/videos；支持文生视频、图片/视频/音频参考、480P / 720P、4 到 30 秒和 9:16、16:9、1:1、21:9、4:3、3:4 比例。参考素材最多 30 张图片、10 个视频、10 个音频，合计最多 50 个；音频参考需搭配图片或视频，按秒计费。
• Moon-2 AC 系列：moon-2.0-ac-a-480p、moon-2.0-ac-a-720p、moon-2.0-ac-b-720p-fast、moon-2.0-ac-c-720p、moon-2.0-ac-d-720p、moon-2.5-ac-a-480p、moon-2.5-ac-a-720p、moon-2.5-ac-b-720p、moon-2.5-ac-c-720p，入口均为 /v1/videos；这些是独立公开型号，分辨率、参考素材、时长和按次/按秒计费维度以具体型号页面及价格接口为准。
• Moon-2 LD 系列：当前公开型号为 moon-2.0-ld-a 和 moon-2.0-ld-b，入口为 /v1/videos；两个型号能力相同，支持 720P、5 至 15 秒、最多 9 张图片、3 个视频、3 个音频和总计 15 个参考素材。
• Moon-2 AM 720P Fast：moon-2.0-am-720p-fast，入口为 /v1/videos，支持 720P、文生视频、图生视频、图片/视频/音频参考和 references[] 公网 URL 组合。
• Moon-2 IL 720P：moon-2.0-il-720p，入口为 /v1/videos，支持 720P、4 到 14 秒、最多 9 张图片、3 个视频、3 个音频和总计 12 个参考素材，按秒计费。
• Moon-2 ME 系列：moon-2.0-me-a-720p、moon-2.0-me-b-720p、moon-2.0-me-a-fast，入口为 /v1/videos。三个型号支持 720P、5 / 10 / 15 秒和五种比例；A / A Fast 最多 9 张图片，B 最多 9 图 + 3 视频 + 3 音频，合计最多 15 个素材，音频必须和图片或视频一起提交。
• Grok 视频模型：grok-video-1.5 和 grok-image-video，入口为 /v1/videos，查询为 /v1/videos/{task_id}；其中 grok-video-1.5 当前接口行为要求 1 张参考图，grok-image-video 支持最多 5 张参考图。

结果读取

读取结果前必须先检查 status。成功后读取响应中的 URL 或结构化结果；失败时读取 fail_reason、error.code 和 error.message。