多模型 API 接入：先核对协议、模型与账单

接入前，先对齐模型、协议和参数

API 接入不只是替换一个地址。先确定要调用的模型，再确认它使用的协议、鉴权方式、请求字段和返回格式。

API 工作台对应 /api，独立文档入口对应 /doc，接入形式涉及 OpenAI、Anthropic、Gemini 三类协议。三类协议兼容解决的是接入形式；具体模型是否支持某个字段，仍要看自己的模型文档。

模型广场按聊天、生图、视频和音频组织能力，可以从模型条目进入文档。即使对外显示名称变化，也可按原厂商名称检索；文档有中英文方向。

准备接入时，把程序现有协议、模型标识和必须使用的参数列在一起，再逐项对照文档。先完成一个最小任务，确认结果形式以后，再扩展更多输入和输出条件。

异步任务不是一次请求直接拿到完整文件。可以按四个环节理解：提交任务、保存任务标识、轮询状态、完成后读取结果。

提交后保留原任务标识。如果响应超时或状态不明确，先查原任务，再按文档判断是否重试。这样任务记录能够连续，也更容易分辨一次生成和重复提交。

密钥可以分别设置综合最优、价格优先、速度优先、成功率优先或圈定线路等策略；导出多把密钥的账单时可带上名称。项目分别命名和记录用量，有助于把费用对应到具体工作。

密钥属于调用环境的凭据，放在服务器或本地受控环境，不放进公开网页和文章。团队协作时，先把项目与负责人分清，再讨论怎样分配调用方式。

图片、视频结果可以预览；密钥、用量和任务日志则提供另一组判断依据。检查响应是否符合预期，也要查看这次任务是否有对应的用量与账单记录。

如果出现格式不匹配或用量异常，保存模型、协议、任务标识和响应线索，更容易缩小问题范围。端点、具体字段与重试规则以模型文档为准。

先用自己的输入做一个最小任务，确认响应、状态、结果和用量四件事。都能对应以后，再扩展成多项目或批量工作流。把接入步骤和异常线索保存下来，后续切换型号时就不必从零重新猜。