01 / CAPABILITIES
开放功能
核心接口调用手册
2 个场景覆盖北京地域的兼容 Chat Completions 文本问答与 text-embedding-v4 文本向量。使用通用模型 Key 与业务空间专属域名;不包含 Token Plan、知识库和图像/语音接口。
文本生成与多模型推理
调用千问及平台提供的第三方大模型,完成问答、摘要、翻译、代码和业务文本处理,可使用兼容 OpenAI 的调用方式。
接入要求先选择目标地域及可用模型,使用匹配的 API Key、Base URL 和模型名称;兼容协议不代表所有厂商参数与能力完全一致。
使用兼容接口完成文本问答站内调用手册 · 参数、代码与排错→视觉理解与图像、视频生成
用支持的视觉模型分析图片,或调用图像、视频生成模型制作素材,适合多模态内容工具和视觉流程。
接入要求不同模型分别规定输入素材、输出分辨率、异步任务和地域;部分模型需先申请开通,不能把统一 API Key 理解为所有模型已授权。
语音识别、合成与实时对话
调用支持的语音模型,将音频转成文本、合成语音或构建实时语音交互。
接入要求按模型选择音频格式和调用协议;部分语音识别模型需要在业务空间单独开通权限,免费额度和计费方式也需单独确认。
向量与检索增强
调用文本或多模态向量模型,并结合知识库为问答应用检索私有资料;知识库与模型推理可以组合使用。
接入要求向量模型调用与知识库是不同服务。资料导入、检索权限、业务空间及知识库规格需分别配置,知识库运行和调用模型可能分别产生费用。
生成 text-embedding-v4 检索向量站内调用手册 · 参数、代码与排错→智能体、工作流与工具连接
通过可视化或高代码方式构建智能体和工作流,结合知识库、插件或 MCP,并发布到支持的应用入口。
接入要求应用构建功能依地域开放,不能把北京地域的应用功能套到所有海外地域;外部服务仍需独立授权和凭证。
模型调优、部署与评测
对支持的模型进行调优和评测,或部署为专享推理服务,以满足定制、性能和资源隔离需求。
接入要求模型、账号权限及地域需支持调优或部署;这些操作有独立资源及计费规则,普通模型调用免费额度不覆盖全部费用。
02 / REQUIREMENTS
接入条件
- 适用主体
- 个人开发者、AI 应用开发者、阿里云用户、企业研发与知识管理团队
- 接入方式
- 在目标地域和业务空间创建模型服务 API Key,服务端通过 Bearer 等接口规定方式鉴权 / RAM 用户需获得百炼及业务空间相应权限;API Key 可按模型或可访问 IP 限定范围
- 申请概况
- 阿里云账号;续用付费需实名,地域凭证独立
- 使用阿里云账号开通百炼并同意服务协议;北京地域的适用新人免费额度可在未实名认证时体验,额度用完后继续按量付费需完成实名认证并满足账户付费条件。
- 个人开发者和团队均应按自己的账号、用途及所选地域核对资格;不能把某一地域或套餐条件推广成所有账号全球通用。
- 在目标地域创建 API Key 并选择业务空间;每个地域的 Key、接入域名和模型列表独立,不能跨地域混用。
- 使用 RAM 子账号时,需由主账号或管理员授予控制台与业务空间权限;API Key 的模型范围和 IP 限制也会影响请求是否可用。
- 正式接入前确认模型是否需申请、地域功能、限额、余额及费用;使用专属套餐时须配置该套餐的专属凭证与地址,不能以普通调用测试代替套餐验证。
03 / GET STARTED
开通步骤
- 01
选择地域与用途
先确定使用模型推理还是知识库、应用或专享部署,再核对目标地域的模型和功能支持。
- 02
开通并创建密钥
通过阿里云主账号开通服务,在对应地域和业务空间创建 API Key;团队场景配置 RAM 与最小权限。
- 03
验证首个模型请求
按首次调用教程填写 Key、业务空间域名和模型名称,核对输出、错误响应和用量。
- 04
确认费用与上线配置
检查免费额度的模型、地域与有效期,按需要配置用完即停;独立评估知识库、存储和部署费用后再用于正式服务。
04 / COSTS & LIMITS
费用、边界与测试方式
费用概况区分模型推理和平台资源,按实际模型与地域的计费单位估算。
- 文本生成通常按输入和输出的每百万 Token 单价分别计费;部分模型按请求输入长度分档,缓存或批量调用可能有独立费率。
- 多媒体模型依产品按 Token、生成图片张数、字符数或音视频时长等计量;分辨率、模态和输出规格可能改变单价,不能统一按一次请求报价。
- 向量模型通常按输入 Token 计费;知识库另按所选规格与运行时长等计费,并可能另有模型调用费用。
- 调优、专享部署与存储等有独立计费项,普通实时推理免费额度不能用于抵扣所有这些费用。
- 当前新人模型免费额度限华北2(北京)且按模型独立,通常自开通、模型发布或申请通过的较晚时点起 90 天内有效;部分历史账号规则不同。未认证账号用尽后停止,已认证账号需检查是否开启免费额度用完即停。
- Token Plan 和 Coding Plan 是另外的订阅方案,有模型、用途和专属接入配置限制;不把套餐额度当作所有 API 的通用余额。
使用范围与限制
- 地域决定接入点和数据存储位置,服务部署范围影响推理位置;不能只凭地域名称推断全部计算都在同一国家或地区。
- 每个地域的模型、功能和价格可能不同;通用 API Key、Token Plan 或 Coding Plan 专属凭证与地址不能混用。
- 兼容 OpenAI 协议旨在方便迁移,不保证全部接口、参数、工具和模型行为与 OpenAI 相同。
- 模型可能产生不准确内容;知识库检索和工作流配置不能替代最终业务校验。
- 免费模型额度不等于知识库、调优、部署或外部 OSS 费用全部免费;已认证账号额度耗尽后可能转按量计费。
如何进行开发测试
- 控制台体验与代码调试:仍消耗适用的模型额度或产生实际费用,先确认当前地域和 Key。
- 试用接入域名:用于快速体验和功能验证,官方不建议用于生产;不能把试用域名理解为所有模型免费。
- 生产接入:官方推荐业务空间专属域名,按业务空间配置权限;地域、Key 与模型须匹配。
- 付费套餐:专属 API Key 和 Base URL 与通用按量通道分开配置,测试时检查实际扣费渠道。
接入前再确认
- 未登录账号或创建 API Key,个人与企业的实际地域资格、模型权限和配额需在自己的控制台确认。
- 试用、通用按量和专属套餐的地址与凭证应分别核对;免费额度适用范围和到期时间以账号显示为准。
- 未调用模型、开通知识库或部署资源,未验证实际生成质量、延迟和业务成本。
05 / OFFICIAL SOURCES
官方资料
以下资料用于核对本页内容。申请与使用时,请以对应接口的最新规则为准。
- 01
- 02
- 03
- 04
- 05
- 06
- 07
- 08
- 09
- 10
官方文档核对,未进行接口实测
最近核验 2026-10-15 · 查看核验说明