Skip to main content
本文面向平台开发者,说明阿里百炼北京站渠道在 phanedge 中暴露的 API 契约。开发者只需要使用 phanedge Token 和模型名;百炼 API Key、DashScope BaseURL、渠道路由和成本对账由平台管理员维护。
本文描述的是 phanedge 对外接口,不是阿里云控制台直连接口。默认服务地址示例为 https://models.phanedge.cloud,请替换为你的平台实际域名。

读者范围

业务服务不要保存或透传阿里云百炼 API Key。平台开发者只使用 phanedge Token;百炼 Key 仅配置在后台渠道中。

开发者接入路径

认证

所有接口统一使用 Bearer Token:
建议先调用模型列表确认当前 Token 可见模型:

Base URL 与 SDK

如果你在业务侧把 base_url 写成 https://dashscope.aliyuncs.com,请求会绕过 phanedge,无法获得平台路由、统一计费、请求 ID、错误清洗和审计日志。

最小验收探针

接口矩阵

与百炼官方入口的关系

本文档中的 phanedge 接口 是平台开发者使用的稳定契约;百炼上游路径 只用于解释后台渠道如何转发和排障。业务代码不要直接拼接百炼上游路径,也不要把百炼 API Key 放入业务服务。
百炼官方文档会按模型和地域更新参数。业务开发者优先遵循本页的 phanedge 对外契约;需要确认某个模型的上游特性时,再参考百炼官方文档并通过平台验收。

官方文档核对

以下链接用于解释 phanedge 后台为什么采用对应上游协议。平台开发者的业务代码仍以本页的 phanedge 对外契约为准。 最后核查日期:2026-06-15。

平台开发者契约

Usage 与缓存计费字段

文本、视觉理解和 Embedding 响应会尽量保留 OpenAI 兼容 usage 字段。百炼缓存相关字段主要影响输入 token 的计费方式,开发者可以把它们用于成本解释和对账,不应自行按这些字段扣费。
缓存字段是上游返回的用量信号。最终消费以平台日志和账单为准;如果响应 usage 与消费记录不一致,请带上 X-Oneapi-Request-Id 或错误体中的 request_id 排查。

协议兼容边界

本页描述的是 phanedge 对外 API 契约。不要把 DashScope 原生请求体直接发送到 phanedge,除非对应字段已经在本文或通用 OpenAI/Claude 文档中声明。

SDK 接入

OpenAI SDK

Responses、Embeddings、Images 和 Videos 入口也使用同一个 base_url 与 Token。不同 SDK 对非官方视频扩展字段的支持不完全一致;如果 SDK 类型不接受扩展字段,可以改用原始 HTTP 请求。

Anthropic SDK

百炼 Anthropic 入口会透传 anthropic-versionanthropic-beta、thinking、tool、媒体输入和 cache_control 等 Messages 字段,并保留上游返回的缓存 usage 字段。复杂 tool 结果、多轮 thinking、媒体输入与缓存组合仍建议按模型做真实上游抽样。

Chat Completions

非流式

流式

图像理解

Responses

流式调用时加入 "stream": true

Anthropic Messages

该入口透传 Anthropic Messages 字段,但最终可用性仍取决于百炼账号权限和具体模型。涉及 thinking、tool、媒体输入与缓存组合时,请保留请求 ID 并按模型抽样验收。

Embeddings

图像生成

百炼图像结果支持 urlb64_json。当请求 b64_json 但上游只返回 URL 时,平台会尝试下载结果并转成 base64。

图像编辑

视频生成

百炼视频为异步任务。创建任务返回 video_id 后,需要查询任务状态,完成后再下载文件。
HappyHorse 1.1 系列包含 happyhorse-1.1-t2vhappyhorse-1.1-i2vhappyhorse-1.1-r2v。官方参数默认 1080P,国内默认价为 720P ¥0.90 / 秒、1080P ¥1.20 / 秒;如需按 720P 成本生成,请显式传入 "resolution": "720p"
如果模型支持固定随机种子,请将 seed 作为 JSON 数字传入,例如 "seed": 12345。不要传字符串形式的 "12345";平台会拒绝非数字或超出 0-2147483647 范围的 seed

文生视频

图生视频

参考视频生成

查询与下载

任务成功后通常返回 completed,结果 URL 会带 expires_at 过期信号。客户端也建议兼容本地异步任务口径中的 success

异步任务状态

视频任务创建阶段只代表上游接受任务,不代表最终成功。对账和扣费应以终态成功结果为准。

视频参考输入规则

参考素材 URL 需要能被百炼上游访问。视频 URL 建议使用 .mp4.mov 后缀;图片 URL 建议使用公开 HTTPS 地址。

失败与排查

错误响应遵循平台统一格式,常见字段如下:
更多错误格式、请求 ID 和对账说明请参考 错误处理请求 ID账单对账