API endpoint https://northerninference.ca/v1 Use this as the base URL in every integration.

NI Commands (in-chat)

Drive routing from inside any chat client: ni-help, ni-models, ni-map-model, and more

Some coding harnesses (Claude Code, certain IDE plugins) let you set the API base URL and key, but pin the model name and will not let you change it. That makes it hard to choose which Northern Inference route your traffic uses.

NI commands solve this. You type a command as your prompt, and the gateway answers directly with a normal assistant message. These commands never call a model and are never billed. They act only on your own account.

Commands

CommandWhat it does
ni-helpLists the available commands.
ni-modelsLists the model routes your key can call, numbered.
ni-map-modelLists routes, then you reply to pick one to map your pinned model to.
ni-map-model 2Maps your current (pinned) model to route number 2 from the list.
ni-map-model <route-id>Maps your current model to an exact route id.
ni-unmapRemoves the mapping for your current model.
ni-statusShows your active model mappings.

How to map a model

  1. In your harness, send ni-map-model as the prompt. You get back a numbered list

of routes your key can call.

  1. Reply with ni-map-model <number> (for example ni-map-model 3), or paste an

exact route id with ni-map-model bedrock/us.anthropic.claude-haiku-4-5-20251001-v1:0-us.

  1. The gateway confirms the mapping is saved. From then on, every request your

harness sends with its pinned model name is routed to the route you chose. No change to the harness config is needed.

To undo it, send ni-unmap. To see what is mapped, send ni-status.

Notes

the account for that pinned model name.

prompt that merely mentions a command is not intercepted.

as normal text.


Source: tests/user_run_tests/integrations/ni-commands.md. Spot a problem? Let us know.