你将构建什么
你将向 CometAPI 兼容 OpenAI 的POST /v1/chat/completions 路由发送一个文本请求,打印 assistant 消息,并让请求结构可直接用于已使用 OpenAI SDK 的应用。
何时使用本页
当你的项目符合以下任一情况时,请使用本快速入门:- 你已经在使用 OpenAI SDK 或聊天补全请求结构。
- 你希望将 base URL 切换为 CometAPI。
- 你希望通过兼容 OpenAI API 的路由调用 CometAPI 的 model ID。
前置条件
- 已将 CometAPI API key 存储在
COMETAPI_KEY中 - 从模型页面获取一个文本 model ID
curl、Python 3.10+ 或 Node.js 18+
API key、base URL、认证
将 CometAPI base URL 与兼容 OpenAI 的客户端一起使用:代码示例
使用下面的选项卡,通过 cURL、Python 和 Node.js 发送相同的聊天补全请求。流程说明
所谓兼容 OpenAI,是指你的应用在保留聊天补全端点、请求体和 SDK 方法名的同时,仅将 base URL 和 model ID 替换为 CometAPI 的对应值。 该路由默认是同步的。API 会在一次 HTTP 响应中返回完整的响应对象,而你的应用读取choices[0].message.content。
如需增量输出,请将 stream 设为 true。响应将变为 Server-Sent Events,并以 data: [DONE] 结束。对于聊天界面和长响应,请使用流式输出(Streaming)。对于后台作业和简单测试,请保留同步形式。
常见参数
故障排查与常见问题
这是 OpenAI API 吗?
这是 OpenAI API 吗?
不是。这是 CometAPI 的 OpenAI 兼容 API 路由。你需要使用 CometAPI API key、CometAPI base URL,以及 CometAPI model ID。
请求返回 401
请求返回 401
请确认
COMETAPI_KEY 已在发送请求的同一个 shell 或运行时环境中设置。不要将真实 key 粘贴到源文件中。找不到模型
找不到模型
请使用支持文本或聊天请求的 CometAPI model ID。重试前请先检查 Models 页面。
SDK 仍然调用 OpenAI
SDK 仍然调用 OpenAI
请确认客户端在 Python 中将
base_url 或在 Node.js 中将 baseURL 设置为 https://api.cometapi.com/v1。后续步骤
- 阅读聊天补全 API 参考文档。
- 在使用 CometAPI 与 OpenAI SDK中配置 SDK 客户端。
- 通过列出可用的 CometAPI 模型查看可用模型。
- 通过错误代码与重试策略添加重试和限流处理。