如果已有一个兼容 Chat Completions API 或 Responses API 的模型端点,Poe API Bot 可以把这个端点接入 Poe。先确认端点在你自己的环境里能按协议返回响应,再配置 Poe 的模型名、基础 URL、密钥和计价,最后用一条文本请求核对模型端和 Poe 端看到的是同一次调用。没有兼容端点时,不应把普通网页地址填成 API 地址。
本文依据 Poe API Bots 概览与Bots REST API 配置说明,核对日期为 2026 年 10 月 1 日。示例字段是演示结构,没有用真实模型、密钥或收费配置实测。

先判断自己的服务是否适合 API Bot
Poe 官方说明,API Bot 会把用户消息转发到你提供的兼容端点,并把服务返回的内容流式传给用户。要准备的不是“模型主页”,而是可处理相应 API 请求的基础 URL、模型标识和用于调用该服务的 API Key。若你的服务实现的是 Poe 自己的 Server Bot 协议,应走 Server Bot,而不是在 API Bot 里强行填兼容地址。
先在服务提供商文档中确认三项:兼容的是 Chat Completions 还是 Responses 格式;基础 URL 末尾路径如何写;响应是否提供可计费的 token 使用量。不同提供商对模型名、流式行为和图像输入支持可能不同,不能仅凭“兼容 OpenAI”四个字推断全部功能。
按官方字段准备配置
| 字段 | 要填什么 | 核对点 |
|---|---|---|
model_name |
提供商文档里的真实模型标识 | 与端点接受的名称完全一致 |
base_url |
兼容 API 的基础 URL | 使用 HTTPS,确认不是控制台网页地址 |
api_key |
仅用于该服务的密钥 | 保持私密,必要时单独给此 Bot 限权 |
api_type |
Chat Completions 或 Responses | 与端点实际协议相符 |
pricing |
按官方规则填写输入与输出 token 的单价 | 与提供商账单和成本模型核算后再启用 |
官方概览给出的创建方式是调用 POST https://api.poe.com/bots,在 api_bot_settings 中配置上述端点和计价。下方仅是字段关系示意,不能直接提交:占位符、模型名和价格必须换成你核实的值,Poe 的管理 API 凭证也应从安全存储中读取。
{
"handle": "MyVerifiedBot",
"api_bot_settings": {
"model_name": "提供商文档中的模型 ID",
"base_url": "https://api.example.com/v1",
"api_key": "从保密变量注入的密钥",
"api_type": "chat_completions_api",
"input_modalities": ["text"],
"output_modalities": ["text"],
"pricing": {"prompt": "已核算单价", "completion": "已核算单价"}
}
}
创建后怎样验收
先检查创建接口的响应和 Poe 后台的 Bot 配置是否一致,再在 Bot 对话页发送一条可识别的测试输入,例如“请只回答:连接检查”。同时查看你自己的模型端日志,确认收到对应请求、模型名正确、返回状态成功,并有使用量记录。Poe 侧应显示响应;若 Poe 有答复但模型端没有请求,应先核对是否误选了其他 Bot。
接着用无效模型名在独立测试 Bot 上试一次失败路径:预期是明确失败,而不是静默返回别的模型。再核对一次端点的输入和输出 token 计数与 Poe 计价设置,避免“功能能跑但收费错”。生产使用前要设置密钥轮换、用量告警和异常成本处理;这些都不能由一条成功对话代替。
限制与常见误区
官方概览说明 API Bot 的头像、私密分享、创建后修改 handle 等部分设置仍需在 Poe 网站完成。图像、视频和工具调用有各自的协议要求,本文只验证文本路径。API Bot 并不是把任意本地模型自动暴露到互联网;端点可达性、安全性和费用由你的服务配置决定。本文未使用读者的端点实测,最终以 Poe 当前官方接口与提供商文档为准。
Ai菜鸟网。发布者:AI小管家,转载请注明出处:https://www.alyyhw.com/30939.html