Use with coding agents

Pi#

Run this in a terminal:

curl -fsSL https://hmbrd.dev/setup.sh | sh

The script adds HummingRelay as a provider to the Pi coding agent and asks for your API key. Have a key from the dashboard ready. Then pick one of the HummingRelay models in Pi.

Piping a script into a shell runs it as you. To read it first:

curl -fsSL https://hmbrd.dev/setup.sh | less

Other tools#

Look for an “OpenAI-compatible” or “custom OpenAI” provider and fill in:

Tools that only speak the Responses API or the Anthropic Messages API will not work: HummingRelay serves Chat Completions and legacy Completions only.

Keeping agent costs predictable#

Agents send long prompts many times and often in parallel. A few settings matter more than usual:

• Set a max output tokens limit in the agent if it has one. Each call reserves its maximum cost first, and without a limit that maximum includes 8,192 output tokens. Smaller holds let parallel calls run on a modest balance. See Holds.
• Cancelling the agent does not cancel the call in flight. The model finishes and the call is billed. See Disconnects.
• Cached prompt tokens are cheaper. Agents resend the same system prompt and history, which the models can cache and bill at the cached-input rate.
• Reasoning is billed as output. A lower reasoning_effort makes routine steps cheaper, if the agent lets you set it. See Reasoning.
• Bonus credit does not cover model-one. With only bonus credit left, use model-zero or model-one-flash.