Models

BlockRun provides access to models from multiple providers through a unified API.

List Models

GET https://blockrun.ai/api/v1/models

Returns a list of available models with pricing information. The response now includes extended metadata for each model.

Response Fields

Each model object in the response includes:

Only models that are currently available are returned — there is no available flag to check.

Example Response

{
  "object": "list",
  "data": [
    {
      "id": "openai/gpt-5.5",
      "object": "model",
      "created": 1700000000,
      "owned_by": "openai",
      "name": "GPT-5.5",
      "description": "OpenAI's flagship — first fully retrained base since GPT-4.5; 1M context, 128K output, native agent + computer use",
      "context_window": 1050000,
      "max_output": 128000,
      "categories": ["chat", "coding", "vision"],
      "billing_mode": "paid",
      "pricing": { "input": 5.00, "output": 30.00 }
    }
  ]
}

Available Models (chat / image / video / music / speech / sound effects)

All prices shown are provider rates — and, for per-token chat, also the billed rates: BlockRun adds no platform margin on chat tokens (we match OpenRouter), only the flat $0.001/request transaction fee. Media and Live Search still carry a 5% platform fee.

OpenAI GPT-5.6 Family

Released 2026-07-09 — three fixed tiers (Sol / Terra / Luna) replacing the single-model-plus-effort-knob line. Note: on /v1/chat/completions, GPT-5.6 accepts function tools only with reasoning_effort: "none" — the BlockRun gateway sets this automatically when tools are present, so no client change is needed.

OpenAI GPT-5.5 Family

Released 2026-04-23 — first fully retrained base since GPT-4.5.

OpenAI GPT-5.4 Family

OpenAI GPT-5 Family

OpenAI O-Series (Reasoning)

OpenAI GPT-4.1 / GPT-4o

Anthropic Claude

Google Gemini

Gemini Pro models (gemini-2.5-pro, gemini-3.1-pro) bill a long-context tier — 2x input, 1.5x output above 200K prompt tokens (mirrors Google's official pricing: gemini-2.5-pro is $2.50/M in · $15.00/M out, gemini-3.1-pro is $4.00/M in · $18.00/M out above the threshold). Flash / Flash-Lite are flat-priced.

xAI Grok

Grok bills a long-context tier at 2x the rates above once a request's prompt reaches 200K tokens (mirrors xAI's official pricing — e.g. Grok 4.5 is $5.00/M in · $18.00/M out above the threshold). Live Search adds $0.025 per source used. Grok Imagine image/video SKUs are listed under Image / Video Generation below.

DeepSeek

Z.AI

Moonshot

K3 is the current flagship — a 2.8-trillion-parameter open MoE with a 1M-token context window, image + text input, returning reasoning_content on completions. K2.7 (256K, adds video input) remains routable but superseded; K2.6 and K2.5 are earlier multi-modal generations, still routable.

MiniMax

Qwen (Alibaba)

Tencent

Xiaomi

Flat-priced (open-weight)

Open-weight models billed at a flat per-request price instead of per token — the request is the unit, whatever its length.

Free Tier (open-weight)

Open-weight models served free of charge (no x402 payment), subject to a small per-IP rate limit. The free tier auto-routes around any temporarily unavailable model, so the live set is best read from GET /api/v1/models (filter on billing_mode: "free"). There are 5 free models listed on mainnet.

Image Generation

Media prices below include the 5% media margin; the flat $0.001 transaction fee is added per call.

Video Generation

Seedance defaults to 720p with synced audio for text-to-video; pass resolution / generate_audio to override. See Video Generation API.

For character consistency across multiple Seedance videos, enroll a Virtual Portrait ($0.011 one-time, no KYC) for AI characters, or a RealFace ($0.011 one-time, no KYC, requires brief on-phone liveness check) for real people. Pass the returned ta_xxx as real_face_asset_id.

Model Categories

Each model includes a categories array in the API response. Categories indicate model capabilities:

• chat - General conversation
• reasoning - Complex problem-solving
• coding - Code generation and analysis
• vision - Image understanding

Filter models by category:

models = client.list_models()
reasoning_models = [m for m in models if "reasoning" in m.get("categories", [])]

Pricing

Prices are per 1 million tokens. Your actual cost depends on:

1. Input tokens - Length of your prompt and context
2. Output tokens - Length of the model's response
3. Transaction fee - a flat $0.001 per request; chat tokens carry no platform margin (media and Live Search carry 5%)

The SDK calculates the exact price before each request.

Want to save 84% automatically? ClawRouter routes each request to the cheapest model that can handle it.

Example

What's next?