Poe 网页版免费试用：每日赠送积分调用多家大模型

先明确一个定位：Poe 面向普通用户的产品是网页版与客户端聊天界面，官方并未向所有人开放通用的 OpenAI 兼容接口。如果只是想「试一下某个模型是什么样」，直接在网页里对话就够了；开发者要做程序化调用，一般是两种做法：一是使用创作者平台的 Bot 能力（需要自己创建 Bot，接口形式与权限以官方文档为准），二是通过第三方提供的 OpenAI 兼容中转，把 Poe 侧的模型包装成标准接口。下面的示例按第二种做法中的通用写法给出，base_url 一律从你所用服务商的控制台复制，不要凭猜测填写。

base_url 与模型名

OpenAI 兼容中转的 base_url 形态通常是 https://服务商域名/v1，具体主机名以控制台给出的为准，创建密钥的页面一般会同时给出 base_url 和可用模型列表。模型名并不统一：网页端看到的 GPT、Claude、Gemini 等只是展示名，接口里要填中转方自己定义的模型标识，可通过模型列表接口或控制台文档获取。常见标识风格类似 gpt-4o-mini、claude-sonnet 这类写法，但实际填什么必须以列表为准。

一次对话补全调用

先把地址与密钥放进环境变量，避免把密钥写死在代码里。变量名可以自行替换，下面以常用的两个为例：

export POE_PROXY_BASE_URL="从服务商控制台复制的地址"
export POE_PROXY_API_KEY="从服务商控制台创建的密钥"

下面是最小可用的 curl 调用。关键参数有：model 模型标识，messages 对话数组（每项含 role 与 content），temperature 随机性，max_tokens 输出长度上限，stream 是否流式返回。

curl "$POE_PROXY_BASE_URL/chat/completions" \
  -H "Authorization: Bearer $POE_PROXY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "服务商控制台列出的模型标识",
    "messages": [
      {"role": "user", "content": "用一句话说明什么是积分制"}
    ],
    "temperature": 0.7,
    "max_tokens": 256,
    "stream": false
  }'

用 Python 时，把官方 SDK 的 base_url 指向中转地址即可，调用方式与其他兼容服务一致：

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["POE_PROXY_API_KEY"],
    base_url=os.environ["POE_PROXY_BASE_URL"],
)

resp = client.chat.completions.create(
    model="服务商控制台列出的模型标识",
    messages=[{"role": "user", "content": "你好，做个自我介绍"}],
    temperature=0.7,
    max_tokens=256,
)
print(resp.choices[0].message.content)

参数上有几个注意点：max_tokens 只限制输出长度，不限制输入，长上下文照样按输入计入消耗；stream 为 true 时返回的是增量片段，需要逐块拼接；不要把多个互相冲突的采样参数一起传，容易直接报参数错误。

额度耗尽与限流的典型表现

• 网页端：积分见底后发送按钮变灰或提示额度不足，对话无法继续，刷新规则以页面显示为准。
• 接口侧：返回 401 或 403 多为密钥无效、缺失或未带 Authorization 头；返回 429 多为请求频率或额度触顶；返回 400 通常是模型标识写错或参数不被支持。

排查顺序建议如下：先确认环境变量是否真的注入、密钥首尾有没有多余空格；再用只带 model 和一条 messages 的最小请求体复测；然后核对模型标识与控制台列表是否完全一致；接着查看响应体里的错误字段和重试等待时间；最后再考虑降低并发、缩短上下文或换成消耗更低的模型。如果错误信息指向服务商侧余额，需要回到控制台确认额度状态。