开发指南
多模态 API 路由与计价参数:Veo、Grok、Kling、Wan 等
列出九维 AI 多模态公开路由和选价字段,区分计价修复、上游错误与尚未验证的接口能力。
先区分模型目录、接口和价格#
GET /v1/models 返回当前密钥可见的模型目录。模型或价格出现在目录中,不代表每一种上游动作都已由九维 AI 验证。不要把模型展示名直接猜成 API ID,也不要把 rate_id 当作视频任务创建路径。
多模态异步请求使用 Authorization: Bearer $U9AI_API_KEY。创建后按对应 V2 任务查询地址获取最终状态和结果;只有成功状态且结果中含可访问资源地址,才算有可下载成品。超时或 5xx 后先查请求记录,避免重复创建和重复扣费。
已实现的价格选择路由#
下表说明九维 AI 根据请求路径和规格字段选择价格行的规则。它说明的是我方计价映射,不等于每个模型、输入模式和参数组合都已经完成真实上游生成验收。字段之外的供应商参数请对照对应模型文档。
| 模型/动作 | 创建路径 | 九维 AI 价格选择字段 |
|---|---|---|
| VEO 3.1 | POST /api/v2/open/aigc/veo-3.1 | model: lite、fast、quality;清晰度使用 resolution。 |
| Grok Imagine 图像/视频 | POST /api/v2/open/aigc/grok | genType: t2i、i2i、t2v、i2v;视频另按 resolution、duration 匹配。 |
| Grok Imagine 1.5 视频 | POST /api/v2/open/aigc/grok-imagine-1.5-preview | 图生视频按 imageUrls、resolution、duration 选择价格。 |
| Kling 3.0 | POST /api/v2/open/aigc/kling-3.0 | sound 区分有声/无声;mode=std/pro/4K 分别对应 720p/1080p/4K,也可显式传 resolution。 |
| Kling 3.0 Motion Control | POST /api/v2/open/aigc/kling-3.0-motion-control | mode 或 resolution 选择清晰度;按动作控制类型价格匹配。 |
| Kling 4.0 / 关键帧 | POST /api/v2/open/aigc/kling-4.0、POST /api/v2/open/aigc/kling-4.0-keyframe | 按路径区分版本和关键帧;普通路径按 resolution 及是否有 videoUrls 选择价格。 |
| Wan 3.0 海外版 | POST /api/v2/open/aigc/wan3-oversea | modelName=wan3.0-video 为标准版;modelName=wan3.0-video-prime 为高速版;另按 resolution、duration 匹配。 |
| DAMO-SR | POST /api/v2/open/aigc/damo-sr | model 选 standard/pro;清晰度传 targetResolution 或 resolution;fps 按不高于 30、60、120 三档计价。 |
| Topaz 放大 | POST /api/v2/open/aigc/topaz-upscale | type=image/video;upscaleFactor 选择 2x 或 4x。计价匹配不代表上游任务处理成功。 |
| MiniMax Speech 2.8 | POST /api/v2/open/aigc/minimax-speech-2.8-hd 或 ...-turbo | HD/Turbo 由路径区分;计价按文本字符数。其他供应商字段以模型专属文档为准。 |
V2 任务查询使用 GET /api/v2/open/aigc/{taskId}。可用模型 ID 以当前密钥返回的 /v1/models 为准,任务字段以对应模型文档为准。计价失败的请求会在冻结余额前拒绝;请求已经到达上游后,则需根据 U9 request ID 和任务结果判断费用与失败阶段。
图片接口的画布比例#
图片创建地址为 POST /v1/images/generations。如果模型支持画布比例,size: "9:16" 表示竖屏比例,不是 9K、16K 清晰度,也不会被当成价格分辨率。模型 ID 和实际支持比例请以密钥的 /v1/models 与模型专属文档为准。
暂未承诺通过九维 AI 调用#
- Vidu Q4:虽有价格目录记录,九维 AI 到上游的创建与查询链路尚未完成核验;不要猜测 API slug 后提交。
- Gemini Omni Audio/Character:上游文档存在音频/人物档案创建能力,但九维 AI 尚未验证账户权限、素材映射和用量结算,不承诺
audioIds/characterIds可由九维 AI Key 创建。 - GPT Image 2 Official:目录计价单位为 token;九维 AI 尚未完成该模型的实际 token 成本读取与结算,不应通过固定价媒体路径调用。
特殊失败如何分层#
- 请求在余额预留前返回
model_not_available或official price not found:通常是模型路由、权限或计价规格未能唯一匹配;不应产生该请求的冻结金额。 - 请求已创建任务,查询时返回
failed/internal error:这是上游任务执行结果,单改九维 AI 的价格映射不能修复;凭 task ID 请求供应商核对失败阶段。 - 用户任务显示完成但看不到媒体:提供 U9 request ID 和任务 ID,由客服检查保存结果、媒体代理和浏览器播放链路。不要重新生成作为下载修复。
工单请提供模型、端点、规格、时间(含时区)、U9 request ID 和脱敏错误文本。不要发送 API Key、Authorization 头、Cookie 或私人素材。
准备好开始了吗?
在控制台选择账户可用模型,先用一条简单请求验证配置。