众扬汇 AI 开放平台 API 文档

对接教程

官方文档

本文档为节选说明，未必与最新接口同步。对接时请以平台接口文档为准，并把请求域名与 API Key 换成众扬汇AI开放平台提供的值：Base URL https://api.allyang.cn。

更新日志

2025.1.7

视频生成

  • 【视频生成】V1.6 模型上线
  • model_name 取 kling-v1-6 可用：文生视频 STD、图生视频 STD 与 PRO 两种模式 受限：尾帧、运动笔刷、运镜等控制类能力暂不可用

字段命名统一：原 model 更名为 model_name，之后请用它指定模型版本。 同时保留向前兼容——沿用旧字段 model 不会报错，其行为等同于 model_name 未填时的默认值（即走 V1）。

2024.12.9

视频生成

  • V1.5 模型开放 STD 调用，可用图生视频；文生视频暂缺
    • 仅标准模式
    • 尾帧控制不可用
    • 其余参数不受影响

2024.11.15

视频生成

  • 可灵 V1.5 开放调用，可用图生视频；文生视频暂缺
    • model_name 取 kling-v1-5
    • 仅高品质模式
    • 尾帧控制不可用
    • 其余参数不受影响
  • 新增：视频延长
    • 可对 V1.0 产出的视频直接延长，每次加 4-5s
    • 涉及创建任务、查询任务（单个/列表）三组接口
  • 其他
    • 新增 external_task_id：创建时自定义任务 ID，查询时同样可用该 ID 定位视频

2024.10.25

  • 明确模型产物（图片/视频）的存储时长
    • 出于信息安全考虑，产物保留 30 天后清理，请及时转存

2024.9.19

视频生成相关API

  • 创建任务的正/负向提示词（prompt / negative_prompt）长度上限调整为 2500 字符
  • “AI虚拟试穿”相关 API（kolors-virtual-try-on）正式可用

API 请求参数说明

请求头字段

字段名 值 描述
Content-Type application/json 数据交换格式
Authorization 鉴权信息，参考接口鉴权 鉴权信息，参考接口鉴权

请求体字段

字段名 类型 必填 默认值 描述
model_name string 可选 kling-v1 模型名称
● 枚举值：kling-v1、kling-v1-5、kling-v1-6
prompt string 必须 无 正向文本提示词
● 不能超过 2500 个字符
negative_prompt string 可选 空 负向文本提示词
● 不能超过 2500 个字符
cfg_scale float 可选 0.5 生成视频的自由度；值越大模型自由度越小，与输入提示词的相关性越强
● 取值范围：[0, 1]
mode string 可选 std 生成视频的模式
● 枚举值：std、pro
● std：标准模式，基础模式，性价比高
● pro：专家模式，高品质，生成质量更佳
camera_control object 可选 空 控制摄像机运动的协议（未指定时由模型根据文本/图片智能匹配）
截止 20241115：仅 kling-v1 模型 5s 且 std 标准模式下支持镜头控制，其他情况不支持

camera_control

字段名 类型 必填 默认值 描述
type string 可选 无 预定义的运镜类型
● 枚举值："simple"、"down_back"、"forward_up"、"right_turn_forward"、"left_turn_forward"
● simple：简单运镜，此类型下可在 "config" 中六选一进行运镜
● down_back：镜头下压并后退 ➡️ 下移拉远，此类型下无需填写 config
● forward_up：镜头前进并上仰 ➡️ 推进上移，此类型下无需填写 config
● right_turn_forward：先右旋再前进 ➡️ 右旋推进，此类型下无需填写 config
● left_turn_forward：先左旋再前进 ➡️ 左旋推进，此类型下无需填写 config

config

字段名 类型 必填 默认值 描述
horizontal float 可选 无 水平运镜：摄像机沿 x 轴的平移量
● 取值范围：[-10, 10]，负值向左，正值向右
vertical float 可选 无 垂直运镜：摄像机沿 y 轴的平移量
● 取值范围：[-10, 10]，负值向下，正值向上
pan float 可选 无 水平摇镜：摄像机绕 y 轴的旋转量
● 取值范围：[-10, 10]，负值向左旋转，正值向右旋转
tilt float 可选 无 垂直摇镜：摄像机沿 x 轴的旋转量
● 取值范围：[-10, 10]，负值向下旋转，正值向上旋转
roll float 可选 无 旋转运镜：摄像机的滚动量（绕 z 轴）
● 取值范围：[-10, 10]，负值逆时针，正值顺时针
zoom float 可选 无 变焦：改变焦距以影响视野远近
● 取值范围：[-10, 10]，负值焦距变长、视野变小，正值焦距变短、视野变大
字段名 类型 必填 默认值 描述
aspect_ratio string 可选 16:9 生成视频的画面宽高比
● 枚举值：16:9、9:16、1:1
duration string 可选 5 生成视频时长，单位 s
● 枚举值：5、10
callback_url string 可选 无 本次任务结果回调通知地址；配置后服务端会在状态变更时主动通知
● 通知的 schema 见「Callback协议」
external_task_id string 可选 无 自定义任务 ID
● 传入不会覆盖系统生成的任务 ID，但可用该 ID 查询任务
● 请注意：单用户下需保证唯一性
上一篇简介下一篇Callback协议