permute.sh

Documentation

API reference.

The API is OpenAI-compatible. Authentication, model discovery, and requests use the public `/v1/*` routes.

API Access

Create API keys in the console and call OpenAI-compatible routes.

Account

Manage keys, billing, and request history from one place.

Model Access

Permute manages model routing, availability, and pricing behind the API.

OpenStatus

Status checks publish uptime and incident updates.

Billing

Subscriptions, checkout, and invoices run through Stripe.

30-Day History

Prompts and outputs are not shown in request history.

chat.sh

curl https://api.permute.sh/v1/chat/completions \
  -H "Authorization: Bearer pm_..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-flash",
    "messages": [{"role": "user", "content": "Hello"}]
  }'

image.sh

curl https://api.permute.sh/v1/images/generations \
  -H "Authorization: Bearer pm_..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-image",
    "prompt": "A clean product render"
  }'

API Endpoints

GET/v1/models

List available text and image models

POST/v1/chat/completions

OpenAI-compatible chat completion

POST/v1/images/generations

OpenAI-compatible image generation

Authentication and Request Shape

AUTHAuthorization: Bearer pm_...

Create API keys in the Console, then send them as standard bearer tokens.

JSONContent-Type: application/json

Chat and image routes follow the OpenAI request and response conventions used by common SDKs.

MODELSUse Permute model names

Use the same model names shown in the console and models page.