Poe.com API 配置教程：从零开始使用 Claude 模型（超详细，新手小白专用）

Poe.com API 配置教程：从零开始使用 Claude 模型（超详细，新手小白专用）

你好！你在问如何配置 Poe.com 的 API Key 来调用类似 Claude 的模型（尤其是用于代码相关任务，比如“Claude Code”风格的编程问题）。Poe.com 是一个聚合多个 AI 模型的平台（包括 Claude、GPT、Grok 等），它提供了 OpenAI 兼容的 API 接口，非常方便。

你给的 curl 示例基本正确，但模型名 "gpt-5.1-codex" 可能不对（Poe 上没有这个模型）。如果你想用 Claude 系列模型（Claude 特别擅长代码和逻辑推理），正确的模型名通常是像 "Claude-Opus-4.1"、"Claude-Sonnet-4" 或 "Claude-3.5-Sonnet" 这样的（具体以最新为准）。

这个教程从最基础开始，一步一步教你配置和使用，保证小白也能看懂。我们会覆盖：

1. 注册和获取 API Key
2. 设置 API Key
3. 用 curl 测试（像你给的例子）
4. 用 Python 代码调用（推荐，更方便）
5. 常见问题和注意事项

前提条件：

• 你需要一个 Poe.com 账号。
• API 使用需要 Poe 订阅（付费订阅，从几美元/月起）。免费账号目前无法生成 API Key。
• 电脑上最好有终端（Windows 用命令提示符或 PowerShell，Mac/Linux 用 Terminal）。

第一步：注册 Poe.com 账号并订阅

1. 打开浏览器，访问 https://poe.com
2. 点击右上角 “Sign up” 或 “Log in” 注册/登录（可以用 Google、Apple 或邮箱）。
3. 登录后，如果你还没有订阅：
   • 点击头像 → Settings → Subscription（或直接搜 “subscription”）。
   • 选择一个付费计划（最便宜的通常够用），支付后订阅生效。
   • 订阅后你会有“积分”（points），API 调用会消耗这些积分。

第二步：获取你的 Poe API Key

1. 登录 Poe.com 后，直接在浏览器地址栏输入：https://poe.com/api_key

2. 页面会显示你的 API Key（一长串字母数字，像 pk-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX）。

3. 点击 “Generate new key” 生成一个新的（旧的会失效）。

4. 复制这个 Key，保存到安全地方（比如记事本），千万不要泄露给别人！别人拿到就能用你的账号花钱。

   如果页面提示你没有权限，确认一下是否已经订阅了。

第三步：设置 API Key（推荐用环境变量，避免明文暴露）

方法1：临时设置（测试用）

• 在终端输入（替换成你的 Key）：
  • Mac/Linux：

    export POE_API_KEY="你的API_Key在这里"
    

  • Windows（PowerShell）：

    $env:POE_API_KEY="你的API_Key在这里"
    

  这只在当前终端窗口有效，关掉就没了。

方法2：永久设置（推荐）

• 把 Key 保存到环境变量里，这样每次都不用手动输入。
• Mac/Linux：编辑 ~/.bash_profile 或 ~/.zshrc，加一行：

  export POE_API_KEY="你的API_Key"
  

  保存后运行 source ~/.zshrc 生效。
• Windows：搜索“环境变量” → 系统变量 → 新建 → 变量名 POE_API_KEY，值填你的 Key。

设置好后，在终端输入 echo $POE_API_KEY（Mac/Linux）或 echo %POE_API_KEY%（Windows）检查是否能显示出来。

第四步：用 curl 测试调用（最简单，直接命令行）

你原来的例子已经很接近了！我们改成用 Claude 模型。

1. 打开终端。
2. 确保已经设置了 POE_API_KEY（第三步）。
3. 复制下面这条命令，粘贴运行（会问一个编程问题）：

curl "https://api.poe.com/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $POE_API_KEY" \
  -d '{
    "model": "Claude-Opus-4.1",   // 这里改成 Claude 模型，推荐 Opus 最强；也可以试 Claude-Sonnet-4（更快更便宜）
    "messages": [
      {
        "role": "user",
        "content": "写一个Python函数，要求在给定int数组的情况下返回最长严格递增子序列的长度。给出简单解和最优解。"
      }
    ]
  }'

• 运行后，你会看到一堆 JSON 返回，里面 choices[0].message.content 就是 Claude 的回答。
• 如果想用其他模型，改 "model" 那行：
  • Claude 最强："Claude-Opus-4.1"
  • Claude 平衡："Claude-Sonnet-4"
  • GPT 系列："GPT-4o"、"GPT-5" 等（看 Poe 上最新）
  • 想知道全部可用模型？运行下面这条 curl（会列出所有模型）：

curl "https://api.poe.com/v1/models" -H "Authorization: Bearer $POE_API_KEY"

第五步：用 Python 代码调用（推荐，适合写脚本）

Python 更方便，尤其是重复调用。

1. 安装 OpenAI 库（Poe API 完全兼容 OpenAI）：

   pip install openai
   

2. 新建一个 Python 文件（比如 poe_test.py），复制下面代码：

import os
from openai import OpenAI

# 从环境变量读取 API Key（最安全）
client = OpenAI(
    api_key=os.getenv("POE_API_KEY"),  # 自动读取你设置的 POE_API_KEY
    base_url="https://api.poe.com/v1"  # 关键！改成 Poe 的地址
)

# 调用 Claude 模型
response = client.chat.completions.create(
    model="Claude-Opus-4.1",  # 改成你想要的模型，比如 Claude-Sonnet-4 更快
    messages=[
        {"role": "user", "content": "写一个Python函数，要求在给定int数组的情况下返回最长严格递增子序列的长度。给出简单解和最优解。"}
    ],
    temperature=0.7,  # 可选：控制创造性，0-2 之间
    max_tokens=1000   # 可选：最大输出长度
)

# 打印回答
print(response.choices[0].message.content)

3. 在终端运行：

   python poe_test.py
   

你就会看到 Claude 的完整回答！

如果想流式输出（像 ChatGPT 一样一行一行显示）：

stream = client.chat.completions.create(
    model="Claude-Opus-4.1",
    messages=[{"role": "user", "content": "你的问题"}],
    stream=True
)

for chunk in stream:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

常见问题和注意事项

• 报错 “Invalid API key”：检查 Key 是否复制全了，是否已订阅。
• 报错 “Insufficient points”：积分不够了，去 Poe.com 充值或买更多订阅。
• 模型名不对：用上面列模型的 curl 查最新名单。Claude 系列通常以 Claude- 开头。
• 想专门用“代码”模型：Claude 本身就很擅长代码，直接用 Claude-Opus-4.1 或 Claude-Sonnet-4 就行，不需要特殊“codex”。
• 费用：每次调用消耗 Poe 积分，Claude Opus 最贵但最强，Sonnet 性价比高。
• 安全：永远不要把 API Key 写死在代码里上传 GitHub！
• 更多文档：官方文档 https://creator.poe.com/docs （很详细）。

跟着这个教程一步步来，绝对能成功！加油！🚀