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 account access from one place.

Model Access

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

Status

Status checks publish uptime and incident updates.

Billing

Subscriptions, checkout, and invoices run through Stripe.

Privacy

Standard account views do not expose prompt or output bodies.

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.