开发指南
模型与协议怎么选:ID、规格、能力和成本
从实际任务、账户权限、协议、上下文及计费单位选择模型,避免将展示名或媒体规格当作文本模型配置。
从任务开始选择#
写周报或总结材料,先选择文本模型;生成图片选择图像模型;视频、语音和音乐分别选择对应类别。任务类别不同,请求字段、计费单位与结果形态也不同。
不要按品牌名直接推断所有能力。相同品牌的不同模型可能有不同上下文、工具调用、图像输入和协议要求。
以账户模型中心为准#
在模型中心查看当前账户可用的模型。公开目录不代表全部账户授权;密钥白名单还可能进一步限制可调用范围。
| 需要复制或核对 | 作用 |
|---|---|
| 精确 Model ID | 请求时匹配实际模型 |
| 类别与协议 | 决定接入接口和工具选项 |
| 规格 | 图像分辨率、生成方式或视频时长 |
| 计费单位 | 区分 Token、秒、张、任务等 |
| 账户授权 | 判断是否真正允许调用 |
先验证普通文本,再验证高级能力#
工具接入通常先用短文本测试路径和密钥。之后单独验证长上下文、图像输入、流式响应、工具调用和思考模式,避免一次打开所有能力后难以定位问题。
普通文本成功并不证明 Agent 工具调用或所有多模态功能均兼容。
控制质量与成本#
相同提示词在两个已授权模型中进行小样本比较,观察事实准确性、格式稳定性、响应时间和费用。写作改写可以先用短输入;长材料整理应明确输出结构并限制长度。
文本费用不仅与输出上限有关,也与输入长度和缓存维度有关。媒体任务还需要核对分辨率、时长或字符数,不能只比较单价数字大小。
模型不可用时的替代策略#
先检查授权和错误码,再选择同类别、同协议、满足关键能力的另一个模型。任务不确定执行时,不要仅因切换模型就再次提交相同付费任务。
保留原请求或任务 ID,可帮助客服判断是否已经生成与结算。
准备好开始了吗?
在控制台选择账户可用模型,先用一条简单请求验证配置。