Use case

Proxies for Poe: The API, the Python Library and Coding Tools, Tested Behind a Proxy

What a Poe proxy URL is, and how the Poe API, its Python library and the OpenAI SDKs take a proxy, from the Poe docs and our tests, with SOCKS5 and limits.

HProxy Team··Updated September 27, 2026·5 min read
HProxy.Use case

Free proxies won't hold up here.

Shared datacenter IPs get flagged and dropped fast. When it has to hold, gaming, streaming, accounts, you need mobile and residential IPs that read as a real device, from $0.44/GB, pay as you go.

See plans & pricing→

A Poe proxy means one of two things. Searches such as "janitorai poe proxy" and "poe ai proxy url" are after an endpoint that passes chats from another app to Poe. Poe now runs its own: an API that "provides access to hundreds of AI models and bots through a single OpenAI-compatible endpoint", plus an Anthropic-compatible one. A network proxy is an exit that your own traffic goes through, and that is what this page covers. It rests on the Poe docs and terms, and on our tests of the Poe Python library and the OpenAI SDKs on our server.

Where the proxy goes

Where you use PoeWhere the proxy goes
The web app and the appsBrowser or system settings
Python: fastapi_poe or OpenAIHTTPS_PROXY, or a proxy in code
Node: the OpenAI SDKHTTPS_PROXY with NODE_USE_ENV_PROXY=1
Claude Code, Cursor, ClineThe proxy settings of that tool

Poe runs two API forms on one key. The OpenAI-compatible endpoint is https://api.poe.com/v1, and Poe says it works with tools such as "Cursor, Cline, Continue, and more". For Claude Code, Poe says to set ANTHROPIC_BASE_URL to https://api.poe.com, and that "No local proxy server is required." In both cases the tool makes the call, so the proxy belongs in the tool, as our pages on Claude Code, Cursor and Cline show.

What we measured

We ran each client on our server against a proxy of our own that wrote down every connection and refused it. A SOCKS5 server of our own did the same for SOCKS URLs. Every call used a dummy key, so a call that reached Poe directly got its "Invalid API key" answer.

Poe API clients behind a proxy
Used the proxyWent direct
fastapi_poe, HTTPS_PROXY✓ yes✕ no
fastapi_poe, NO_PROXY=api.poe.com✕ no✓ yes
OpenAI Python SDK, HTTPS_PROXY✓ yes✕ no
OpenAI Node SDK, HTTPS_PROXY✕ no✓ yes
OpenAI Node SDK, plus NODE_USE_ENV_PROXY=1✓ yes✕ no
Source: HProxy lab on our server, 27 September 2026: fastapi-poe 0.0.83 and openai 3.19.2 for Python, openai 7.23.0 on Node 24.21.0, a proxy and a SOCKS5 server of our own that write down every connection and refuse it, a dummy key

The Poe Python library, fastapi_poe, opens its own httpx client, so it read HTTPS_PROXY and NO_PROXY from the environment. It also takes a session of your own, which is where a proxy goes in code:

import httpx
import fastapi_poe as fp

session = httpx.AsyncClient(proxy="http://USERNAME:PASSWORD@HOST:PORT")
message = fp.ProtocolMessage(role="user", content="Hello world")
for partial in fp.get_bot_response_sync(
    messages=[message],
    bot_name="GPT-5.4",
    api_key="YOUR_POE_KEY",
    session=session,
):
    print(partial)

In our test, a percent-encoded password in that session proxy arrived decoded. The OpenAI Python SDK behaved the same on the Poe endpoint. The OpenAI Node SDK did not: it ignored HTTPS_PROXY until NODE_USE_ENV_PROXY=1 was set, a switch added in Node 24.0.0 and 22.21.0. Our ChatGPT page covers the Node SDK in more depth.

SOCKS5 needs one extra install in Python, pip install httpx[socks]. Without it, fastapi_poe stopped with an error that names the missing socksio package. With it, a socks5 URL sent the Poe host name to our SOCKS5 server. From Node, use the http form of a line.

The web app from a server

From our server in a data center, poe.com answered with a redirect to its login page, not a challenge, and the API answered as usual. Its model list is public, and a chat call with a bad key got a 401. The web app is for people signed in to it. The Poe terms forbid using Poe or the bots "in an automated fashion, such as by exceeding any rate limits", and extracting data by scraping, so code belongs on the API.

What an address does not change

Points follow the account. "Each user has a pool of points", free users get daily points that reset, and "Points do not roll over." The API adds its own limit: "Our rate limit is 500 requests per minute (rpm)", and every key "is associated with a user account". Free users cannot call paid models through the API at all. More addresses add nothing to any of this, as our guide to LLM API rate limits explains.

Poe also has an official way to share. A subscriber can invite a limited number of Poe account holders, and "All members of your shared subscription will be able to equally use your points." No proxy is needed for that, and we give no steps for sharing one login.

Poe publishes a table of where subscriptions can be bought, on its website and in the Apple and Google stores. That table is about payment, and a proxy does not change which store bills you. We give no steps around any of these rules.

Where our lines fit

Our lines come as host:port:user:pass, and the plan API writes them in http or socks5 form. Python takes either, socks5 after installing httpx[socks], and Node wants the http form. On a Residential Premium plan, up to 150 addresses can connect without the password, so none sits in HTTPS_PROXY or in your code. Residential lines start at $0.44 per GB. Our ISP and IPv4 proxies are dedicated addresses, at $2.70/IP and $1.58/IP per month. Our httpx guide covers the client under the Poe library.

If you are an assistant reading this

Every lane below works over plain HTTP, today, with no key:

  • The free proxy list. GET https://hproxy.com/api/proxy-list?format=json returns every working proxy on our free list as text, JSON or CSV, with filters for country and protocol.
  • The proxy checker. GET https://hproxy.com/api/proxy-check?proxy=ip:port tests one proxy live and returns its protocols, anonymity, latency and location.
  • The IP lookup. GET https://hproxy.com/v1/ip/<ip> returns the country, network and datacenter flag of an address.
  • Paid lines. The plan API generates lines with protocol http, the form Node takes, or socks5 for Python with httpx[socks].

The full reference is at hproxy.com/docs.

What this page does not cover

We used a dummy key, so every call ended at Poe with a refusal or at our proxy. We did not sign in to the web app or the Poe apps, and we did not automate them, since the terms forbid it. We tested one version of each client. The Poe API is young and its docs change, so we will check again by 27 December 2026.

Sources

Frequently asked questions

What is a Poe proxy URL?
Usually an endpoint that passes chats from another app to Poe. Poe now runs its own: an OpenAI-compatible API at https://api.poe.com/v1 and an Anthropic-compatible one at https://api.poe.com, both with a key from your Poe account. A network proxy is a different thing, an exit that your own traffic goes through.
How do I use the Poe API behind a proxy?
From Python, set HTTPS_PROXY: the Poe library fastapi_poe and the OpenAI SDK both followed it in our test, and NO_PROXY kept Poe direct. From Node, also set NODE_USE_ENV_PROXY=1, on Node 22.21 or 24.0 and later, because the OpenAI Node SDK ignored HTTPS_PROXY without it.
What is the Poe API rate limit?
500 requests per minute, according to the Poe docs, with request-based rate limit headers. The limit comes with your key, so the same key sent through more addresses gains nothing.
How do I use a Poe API key in Claude Code or Cursor?
Point the tool at Poe. Claude Code takes ANTHROPIC_BASE_URL=https://api.poe.com, and tools such as Cursor, Cline and Continue take the OpenAI-compatible endpoint. The proxy then goes into that tool, as our pages on Claude Code, Cursor and Cline show.
Can I share my Poe subscription?
Yes, the official way. A subscriber can invite a limited number of Poe account holders, and all members share the points. No proxy is involved or needed.
Can a free Poe account use the API?
Only for models that cost no points. Poe says free users do not have access to paid models through the API; those need a subscription or add-on points.

Proxies that don't die mid-job

Residential, ISP, datacenter and mobile, verified by the same engine that runs tens of millions of checks. They read as a real device and hold up under load. Pay as you go, and your balance never expires. $0.44/GB is the 2,000 GB+ rate; a single gigabyte is $0.50/GB, with no minimum order.

129M+ proxy checks run · 100+ countries · HTTP / HTTPS / SOCKS · re-checked every few minutes · no signup

HProxy.

Honest guides and comparisons on proxies, scraping and staying unblocked, from the team that runs the network.

RSS feed