Developer Platform

xMode API
for Developers

Powerful AI photo processing in a single API call. Integrate identity-locked image generation into your apps, websites, and pipelines in minutes.

REST · JSON Webhooks Async 202

POST /v1/generations

curl -X POST https://api.xmode.ai/v1/generations \
  -H "Authorization: Bearer $XMODE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "xSD4.5",
    "prompt": "studio portrait, soft light",
    "size": "1024x1024"
  }'

Built for creators on

Core Technology

The Identity Engine

Send one or multiple images in a single API call and get back amazing scenes with consistent identity, realism, and style — fully driven by your prompt.

Send one or multiple reference images per request
Generate unlimited scenes with consistent identity
Full control over prompt, style, and composition
Re-run, refine, or remix results anytime via API

Get your API token

Input

Output

API Capabilities

Everything you can build

A focused set of REST endpoints covering the full content pipeline — from request to delivery.

Image Generation (xSD4.5)

POST /v1/generations

Poll status

GET /v1/generations/:id

List generations

GET /v1/generations

xTokens balance

GET /v1/balance

End-user management

/v1/end-users/*

Video generation (xSV1.0)Soon

POST /v1/generations

Integration

Up and running in minutes

Three steps from zero to your first generated image.

Get your token

Call the endpoint

POST to /v1/generations with your prompt and model.

Poll or webhook

Receive a 202, then poll pollUrl or get a signed webhook.

Request

curl

curl -X POST https://api.xmode.ai/v1/generations \
  -H "Authorization: Bearer xm_live_<your-key>" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "xSD4.5",
  "prompt": "cinematic portrait, golden hour",
  "size": "1024x1024",
  "n": 1
}'

Response

JSON

{
  "requestId": "req_01HW8X...",
  "model": "xSD4.5",
  "status": "queued",
  "pollUrl": "https://api.xmode.ai/v1/generations/req_01HW8X...",
  "createdAt": 1735689600
}

View full API documentation

Advantages

Why xMode API

What makes xMode the right backbone for your AI image pipeline.

Uncensored & creator-friendly

Built for adult and creator-economy use cases. No restrictive content filters, no surprise bans, no hidden moderation rules.

Pay-as-you-go xTokens

Same token system as the web app. Buy xTokens when you need them, get volume discounts at scale, and never pay for unused capacity.

Async-by-design, high throughput

Async pipeline returns 202 + pollUrl in milliseconds. Long generations never hold your TCP connection; webhooks deliver final results.

Pricing

Pay as you generate

One-time top-ups in crypto. xTokens never expire. No subscription, no surprises.

Starter

$149one-time

1,000xTokens$149.00 per 1,000 tokens

No expiry on purchased xTokens
Pay in BTC, ETH, USDT or other crypto
Best for trying out the API

Get started

Questions, answered

Everything you need to know before integrating.

All requests use a Bearer token in the Authorization header. Generate and rotate API keys from your dashboard profile.

Per-tenant rate limiting is applied. Contact us if you need higher throughput for production traffic — limits can be raised case by case.

Yes. The API is async-by-design: POST /v1/generations returns 202 + pollUrl. If you pass webhookUrl in the request, we deliver a signed callback when the job completes. Signature header: X-XMode-Signature: v1=<HMAC-SHA256(secret, "<ts>.<body>")> plus X-XMode-Timestamp (5-minute replay window).

xMode is uncensored and creator-friendly. We block only content that is illegal under applicable law (CSAM, non-consensual depictions of real people, etc.). See the Acceptable Use section in the docs for the full policy.

Standard accounts target high availability. Enterprise contracts include written SLAs with credits for downtime, dedicated support channels, and custom infrastructure options.

Uploads and generated assets are encrypted at rest and in transit. By default, generated images are stored on R2 with a default retention window — you can configure shorter retention if needed. Training data is never used to improve shared models.

Failed generations do not consume xTokens — the debit is refunded automatically. The API returns a structured error response with a retry hint. Persistent failures can be escalated to support.

See full docs →

Start building today

Get your API token, drop in a few lines of code, and ship identity-locked AI image generation this week.

xMode APIfor Developers