API 协议

模型专属场景与支持边界

预览指南

粘贴给 AI,帮助理解文档并完成接入。 仅包含文档与示例,不包含真实密钥。

预览指南

模型专属场景与支持边界

直接答案先确认模型广场中的模型与端点,再按本页迁移路径、请求字段和任务结果;不要把旧文档发布标签当作本站可用性保证。

更新 · 审核信息

按视频系列选择参数与场景

查看视频系列对比与完整示例,按 Wan、Kling、Seedance、HappyHorse、Gemini Omni、MiniMax 等系列查看参数表、素材角色、代码、轮询和下载。条件场景及未开放的示例会明确标注,避免跨模型套用字段。

先确定模型和协议

同一个 /v1/chat/completions 或 /v1/videos 路径可以承载不同模型;字段相同不代表可选值、时长、分辨率和价格相同。先选择模型广场中完整模型名、调用分组和有效端点,再查看当前模型的「复制接入指南」。本页记录 2026-11-08 的代码契约,不列未经读取的线上分组配置。

暂未发布的场景

Sora Remix 与 Qwen Omni 尚未完成本轮真实验收,接入文档与示例已撤下。请使用已发布的模型与协议说明。

Qwen Image 3.0:生成与编辑

对于经 Ali 适配器处理的 qwen-image-3.0 / qwen-image-3.0-*,代码约束如下;其他兼容渠道仍需确认自身限制。生成用 图片生成,上传本地文件用 multipart 编辑。

字段本站 Ali 转换规则
image不传为文生图;JSON 支持 URL 或 URL 数组,编辑最多 3 张参考图
n1–6 张输出;不要把该范围推广到其他图片模型
prompt_extend布尔值;显式 false 保留
prompt_extend_modedirect / agent;agent 仅允许无参考图的文生图
seed0–2147483647,显式 0 保留
size统一格式 widthxheight 转换为上游 width*height;面积 512²–2048²,宽高比 1:8–8:1
watermark、negative_prompt分别为布尔值与负向提示词;按所选渠道契约使用
{"model":"qwen-image-3.0","prompt":"保留主体,将背景改为海边","image":["https://example.com/input.png"],"n":1,"size":"1024x1024","prompt_extend":false,"prompt_extend_mode":"direct","seed":0,"watermark":false}

以上是发往 /v1/images/generations 的编辑场景 JSON 示例,须该模型路由支持参考图;不是把本地路径当作文件上传。成功后按响应读取 data[].url 或解码 b64_json,空结果不能视为成功。Ali multipart 路径还限制单图不超过 10 MiB;其他接入路径有各自请求体约束。

Veo、Seedance 与 MiniMax 的差异

模型族选路与限制
Veo统一视频端点中的参考模式、图片数量、时长、横竖屏和 4K 能力由具体型号及渠道 profile 决定。旧页中的 components、pro、4k 后缀不是可以自行拼出的本站模型名;按当前有效端点参数选择
Seedance文生视频、首尾帧、多模态参考与真人素材是不同流程。真人素材上传后需审核为 active,才能用于生成;见 真人素材指南
MiniMax-H3统一视频、Remix 与原生 /v2/video_generation、/v2/video_regeneration 请求不同;分辨率、源视频和上下文按 视频指南 对应段落填写
FLUX原生 /flux/v1/{model} 当前只接收 flux-3-image;异步任务需要可交付的 URL,不能把仅有 Base64 的响应当成已完成任务

高级文本参数与状态边界

Responses Reference 补充 instructions、previous_response_id、conversation、reasoning、store、context_management 等字段。类型可解析仅说明网关能承载,支持范围还由模型和渠道决定。不要同时提供 conversation 与 previous_response_id;跨渠道接续上游会话没有通用保证。service_tier 与 safety_identifier 可能被渠道设置过滤,store 可能被禁用。background 及后台查询/取消未实现,不列为可用能力。

最小请求通过后,再逐项启用模型专属参数。轮询需要总时限和退避,结束时检查成功或失败;本页的本地契约检查不等于已对付费上游完成真实验收。

适用场景

  • 迁移旧接口调用
  • 确认模型专属字段与支持边界

API 协议

  • /v1/chat/completions
  • /v1/videos
  • /suno/v2/music

常见问题

旧文档 released 是否表示本站可用?

不是。须确认本站路由、字段转换、渠道和模型分组支持。

迁移时只换 URL 可以吗?

不可以。还需核对鉴权、字段、提交响应、任务 ID、终态与结果格式。

这些结论是否代表所有模型都实测成功?

不代表。本页是代码与文档契约核对,没有全部付费模型的上游验收。

官方来源

  1. Tuzi legacy Apifox documentation (comparison source) 官方