viduq2-pro API 模型解析指南
快速结论
- 支持 prompt 驱动文生图，适合营销、电商和创意素材场景。
- 支持参考图工作流，可提升风格一致性与可控性。
- 建议先在模型页收敛参数，再迁移到生产 API。
核心能力
- 高质量生图：通过统一接口快速生成可交付视觉素材。
- 参考图一致性：支持参考图输入以稳定风格与构图。
- 参数化调优：围绕比例、数量与采样参数进行质量/成本平衡。
适用场景
- 需要快速生成营销、电商、社媒视觉素材时。
- 需要在参考图约束下做风格一致性输出时。
不适用场景
- 需要长时视频生成与镜头编排时。
- 需要复杂多轮推理对话时。
运行特性
- 统一调用图片生成接口，通常返回任务状态并异步完成。
- 建议通过任务状态接口轮询并在完成后下载结果。
最小请求示例
{
"model": "viduq2-pro",
"prompt": "高级产品海报，柔和光线，真实质感，极简背景",
"size": "1:1"
}
最小响应示例
{
"id": "task_img_xxxxxxxx",
"object": "generation.task",
"model": "viduq2-pro",
"status": "queued",
"progress": 0
}
关键参数
| 参数 | 类型 | 必填 | 默认值 | 范围 | 说明 |
|---|
| model | string | 是 | viduq2-pro | - | 模型标识，使用 ToAPIs 真值。 |
| prompt | string | 是 | - | - | 图像描述文本。 |
| size | string | 否 | 1:1 | - | 输出宽高比，按模型能力可选。 |
| n | integer | 否 | 1 | - | 单次请求生成数量。 |
| reference_images | file[] | 否 | - | - | 参考图数组，用于风格一致性控制。 |
常见错误
| HTTP | Code | 触发条件 | 修复建议 | 重试策略 |
|---|
| 400 | invalid_request_error | 请求体字段缺失或类型不合法。 | 校验 model/prompt/size 等参数格式。 | 修复参数后重试。 |
| 401 | authentication_error | API Key 缺失或无效。 | 检查 Authorization 头与密钥权限。 | 修复鉴权后重试。 |
FAQ
- viduq2-pro 适合什么生图场景？
适合高频创意素材生成、风格一致性迭代和参数化图像工作流。
- 图像视频模型报错：invalid apitype: -1
这类错误通常说明接口走错了。图像和视频模型一般不走 chat 接口，而是按对应文档发起 HTTP 任务请求，并通过任务状态接口轮询结果。排查时建议先看用户的实际请求代码、请求地址和请求体。
- 用户进行生成图片/视频的任务时出现任务失败，但是扣款
先让用户提供任务日志或截图，重点看是否出现了输入或输出 token 统计。如果有这类 token 记录，大概率是用户把图片/视频模型走成了 chat 接口；这不是正确用法。图片和视频模型通常是异步任务接口，需要通过 HTTP 请求先提交任务，再拿到任务 ID 轮询状态，详细以对应文档为准。
相关 API
