跳到正文
九维AI开放平台使用文档

开发指南

多模态 API 路由与计价参数:Veo、Grok、Kling、Wan 等

列出九维 AI 多模态公开路由和选价字段,区分计价修复、上游错误与尚未验证的接口能力。

成都九维数创科技有限公司 · 文档团队更新于 约 8 分钟阅读
本页目录
  1. 先区分模型目录、接口和价格
  2. 已实现的价格选择路由
  3. 图片接口的画布比例
  4. 暂未承诺通过九维 AI 调用
  5. 特殊失败如何分层

先区分模型目录、接口和价格#

GET /v1/models 返回当前密钥可见的模型目录。模型或价格出现在目录中,不代表每一种上游动作都已由九维 AI 验证。不要把模型展示名直接猜成 API ID,也不要把 rate_id 当作视频任务创建路径。

多模态异步请求使用 Authorization: Bearer $U9AI_API_KEY。创建后按对应 V2 任务查询地址获取最终状态和结果;只有成功状态且结果中含可访问资源地址,才算有可下载成品。超时或 5xx 后先查请求记录,避免重复创建和重复扣费。

已实现的价格选择路由#

下表说明九维 AI 根据请求路径和规格字段选择价格行的规则。它说明的是我方计价映射,不等于每个模型、输入模式和参数组合都已经完成真实上游生成验收。字段之外的供应商参数请对照对应模型文档。

模型/动作创建路径九维 AI 价格选择字段
VEO 3.1POST /api/v2/open/aigc/veo-3.1model: lite、fast、quality;清晰度使用 resolution。
Grok Imagine 图像/视频POST /api/v2/open/aigc/grokgenType: 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.0POST /api/v2/open/aigc/kling-3.0sound 区分有声/无声;mode=std/pro/4K 分别对应 720p/1080p/4K,也可显式传 resolution。
Kling 3.0 Motion ControlPOST /api/v2/open/aigc/kling-3.0-motion-controlmode 或 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-overseamodelName=wan3.0-video 为标准版;modelName=wan3.0-video-prime 为高速版;另按 resolution、duration 匹配。
DAMO-SRPOST /api/v2/open/aigc/damo-srmodel 选 standard/pro;清晰度传 targetResolution 或 resolution;fps 按不高于 30、60、120 三档计价。
Topaz 放大POST /api/v2/open/aigc/topaz-upscaletype=image/video;upscaleFactor 选择 2x 或 4x。计价匹配不代表上游任务处理成功。
MiniMax Speech 2.8POST /api/v2/open/aigc/minimax-speech-2.8-hd 或 ...-turboHD/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 或私人素材。

准备好开始了吗?

在控制台选择账户可用模型,先用一条简单请求验证配置。

打开 Playground