How to hit the Poe API

Poe's API at https://api.poe.com/v1 is OpenAI-compatible and reaches every model and bot on Poe with one key, billed from your Poe points. The model list is public.

Authentication

Get a key at poe.com/api/keys. Send it as Authorization: Bearer <key>. Listing models needs no key. In the examples it's written {{POE_API_KEY}}.

Full reference: https://creator.poe.com/docs/external-applications/openai-compatible-api

List models

No key needed.

curl https://api.poe.com/v1/models
Run in PostTaco
Example response (trimmed)
{
  "object": "list",
  "data": [
    {
      "id": "assistant",
      "object": "model",
      "created": 1694610718936,
      "owned_by": "Poe",
      "root": "assistant",
      "architecture": {
        "input_modalities": [
          "text",
          "image"
        ],
        "output_modalities": [
          "text"
        ],
        "modality": "text,image,video->text"
      },
      "supported_features": [
        "web_search",
        "tools"
      ],
      "supported_endpoints": [
        "/v1/responses",
        "/v1/chat/completions"
      ],
      "pricing": null,
      "context_window": {
        "context_length": 400000,
        "max_output_tokens": 128000
      },
      "context_length": 400000,
      "metadata": {
        "display_name": "Assistant",
        "image": {
          "url": "https://qph.cf2.poecdn.net/main-thumb-pb-3002-200-vcmrcgoloaktppabmdfsgeczaixswmxt.jpeg",
          "alt": "Assistant model icon",
          "width": 200,
          "height": 200
        },
        "url": "https://poe.com/assistant"
      },
      "reasoning": {
        "budget": null,
        "required": false,
        "supports_reasoning_effort": true
      },
      "parameters": []
    },
    {
      "id": "grok-4.7",
      "object": "model",
      "created": 1790012963916,
      "description": "Grok 4.7 is xAI’s frontier model for coding and professional knowledge work, built to handle longer, harder tasks and check its work more carefully. In xAI’s xhigh evaluations, it scored 46.3% on CursorBench 4.0 and 1,695 Elo on GDPval.",
      "owned_by": "XAI",
      "root": "grok-4.7",
      "architecture": {
        "input_modalities": [
          "text",
          "image"
        ],
        "output_modalities": [
          "text"
        ],
        "modality": "text,image->text"
      },
      "supported_features": [
        "web_search",
        "tools"
      ],
      "supported_endpoints": [
        "/v1/chat/completions",
        "/v1/messages"
      ],
      "pricing": {
        "prompt": "0.0000020202",
        "completion": "0.0000060606",
        "image": null,
        "request": null,
        "input_cache_read": "0.0000005051",
        "input_cache_write": null
      },
      "context_window": {
        "context_length": 500000,
        "max_output_tokens": null
      },
      "context_length": 500000,
      "metadata": {
        "display_name": "Grok-4.7",
        "image": {
          "url": "https://qph.cf2.poecdn.net/main-thumb-pb-7137951-200-iustawktcftkprbulrpaelkoiazoflwj.jpeg",
          "alt": "Grok-4.7 model icon",
          "width": 200,
          "height": 200
        },
        "url": "https://poe.com/grok-4.7"
      },
      "reasoning": null,
      "parameters": [
        {
          "name": "web_search",
          "default_value": true
        },
        {
          "name": "reasoning_effort",
          "default_value": "high"
        }
      ]
    }
  ]
}

Chat completion

Any id from the model list.

curl https://api.poe.com/v1/chat/completions \
  -H "Authorization: Bearer {{POE_API_KEY}}" \
  -H "Content-Type: application/json" \
  -d '{"model": "claude-opus-4.8", "messages": [{"role": "user", "content": "Explain HTTP caching in one paragraph."}]}'
Run in PostTaco