本文描述的是 kapon 对外接口,不是阿里云控制台直连接口。默认服务地址示例为
https://models.kapon.cloud,请替换为你的平台实际域名。读者范围
开发者接入路径
认证
Base URL 与 SDK
最小验收探针
接口矩阵
与百炼官方入口的关系
本文档中的kapon 接口 是平台开发者使用的稳定契约;百炼上游路径 只用于解释后台渠道如何转发和排障。业务代码不要直接拼接百炼上游路径,也不要把百炼 API Key 放入业务服务。
官方文档核对
以下链接用于解释 kapon 后台为什么采用对应上游协议。平台开发者的业务代码仍以本页的 kapon 对外契约为准。
最后核查日期:2026-08-27。
平台开发者契约
Usage 与缓存计费字段
文本、视觉理解和 Embedding 响应会尽量保留 OpenAI 兼容 usage 字段。百炼缓存相关字段主要影响输入 token 的计费方式,开发者可以把它们用于成本解释和对账,不应自行按这些字段扣费。协议兼容边界
SDK 接入
OpenAI SDK
base_url 与 Token。不同 SDK 对平台视频扩展字段的支持不完全一致;如果 SDK 类型不接受扩展字段,可以改用原始 HTTP 请求。
Anthropic SDK
anthropic-version、anthropic-beta、thinking、tool、媒体输入和 cache_control 等 Messages 字段,并保留上游返回的缓存 usage 字段。复杂 tool 结果、多轮 thinking、媒体输入与缓存组合仍建议按模型做真实上游抽样。
Chat Completions
非流式
流式
图像理解
Responses
"stream": true。
Anthropic Messages
Embeddings
图像生成
Qwen Image 3.0 可使用qwen-image-3.0-pro 或 qwen-image-3.0;两者都支持生成与编辑。
url 与 b64_json。当请求 b64_json 但上游只返回 URL 时,平台会尝试下载结果并转成 base64。
图像编辑
视频生成
百炼视频为异步任务。创建任务返回video_id 后,需要查询任务状态,完成后再下载文件。
Wan 3.0 使用 wan3.0-video 或 wan3.0-video-prime,支持 480P/720P/1080P、2-30 秒、audio 和 adaptive。duration=-1、文件参考和网页参考不在当前平台契约内,会在调用上游前返回 HTTP 400。
提交参考视频或参考音频时,必须同时提供数量一致的 video_durations 或 audio_durations,用于在调用上游前校验单类素材合计不超过 15 秒;输入视频与输出视频合计不得超过 30 秒。最终结算仍只采用百炼终态 usage,不采用客户端申报时长。
HappyHorse 1.1 系列包含
happyhorse-1.1-t2v、happyhorse-1.1-i2v 和 happyhorse-1.1-r2v。官方参数默认 1080P,国内默认价为 720P ¥0.90 / 秒、1080P ¥1.20 / 秒;如需按 720P 成本生成,请显式传入 "resolution": "720p"。如果模型支持固定随机种子,请将
seed 作为 JSON 数字传入,例如 "seed": 12345。不要传字符串形式的 "12345";平台会拒绝非数字或超出 0-2147483647 范围的 seed。文生视频
图生视频
参考视频生成
wan2.7-r2v 仍兼容视频参考加图片参考:
查询与下载
completed,结果 URL 会带 expires_at 过期信号。客户端也建议兼容本地异步任务口径中的 success。
异步任务状态
视频任务创建阶段只代表上游接受任务,不代表最终成功。对账和扣费应以终态成功结果为准。
视频参考输入规则
失败与排查
错误响应遵循平台统一格式,常见字段如下: