Introduction

The Blon API runs Blon’s image, video and audio models from your server. You submit a job, Blon runs it on the model’s provider, and you read the finished files from the same job.

Ways to use Blon

API key

Server-to-server calls with a blon_api_ key. Amounts are in US dollars.

CLI and Skills

The blon command and Skills for coding agents. Sign in with your Blon account; spends your credits.

MCP

Connect an AI client over OAuth. Spends your credits.

This documentation follows the API key path. The CLI and MCP pages cover the other two.

Base URL

https://api.blon.ai/v1

Conventions

Requests and responses are JSON.
Field names are snake_case.
Times are RFC 3339 in UTC, for example 2026-10-30T08:00:00.000Z.
Amounts are decimal strings, for example "0.48", never floats.
Every response carries an X-Request-Id header. Include it when you contact support.

Make a request

Check that your key works by reading the balance:

curl https://api.blon.ai/v1/balance \
  -H "Authorization: Bearer $BLON_API_KEY"

{
  "currency": "USD",
  "available": "18.425",
  "held": "0.0042",
  "usage_this_month": "1.5708",
  "spend_limit": {
    "amount": "50.00",
    "spent": "1.5708",
    "window": "month",
    "resets_at": "2026-11-01T00:00:00.000Z"
  }
}

Quickstart

Estimate, submit a job and read its result.

OpenAPI document

The API reference tab is generated from this document; load it into your own tools too.

Get started

Concepts

How-to

Models

Help

Introduction

Ways to use Blon

API key

CLI and Skills

MCP

Base URL

Conventions

Make a request

Quickstart

OpenAPI document

​Ways to use Blon

API key

CLI and Skills

MCP

​Base URL

​Conventions

​Make a request

Quickstart

OpenAPI document

Ways to use Blon

Base URL

Conventions

Make a request