API Reference

Zekron AI

A simple REST API to generate photorealistic images from text prompts. Transparent per-image pricing with Telegram-native payments.

Base URL

api.zekron.codes

Auth

Bearer (zk_...)

Format

JSON

Authentication

All requests require an API key in the Authorization header as a Bearer token. Get your key via the Telegram Bot.

API key format

zk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Header

Authorization: Bearer zk_your_api_key_here

Security: Never expose your API key in client-side code or public repos.

Quick start

Generate your first image in under a minute.

bash

curl -X POST https://api.zekron.codes/api/v1/zekron-image-1:image-preview \
  -H "Authorization: Bearer zk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A futuristic city at night",
    "options": { "size": "1024x1024" }
  }'

API reference

POST/api/v1/zekron-image-1:image-preview

Generate an image from a text prompt. Balance is deducted based on model and prompt length.

Parameters

promptrequired

string

Text description of the image.

model

string

Model ID. Defaults to zekron-image-1.

options.size

string

1024x1024 (default), 512x512, 256x256.

options.negative_prompt

string

Elements to exclude from the image.

Request body

request.json

{
  "prompt": "A futuristic city at night, neon lights, 8k",
  "model": "zekron-image-1:image-preview",
  "options": {
    "size": "1024x1024",
    "negative_prompt": "blurry, low quality"
  }
}

Response

response.json

{
  "success": true,
  "data": {
    "id": "img_abc123xyz",
    "url": "https://api.zekron.codes/storage/img_abc123.png",
    "model": "zekron-image-1:image-preview",
    "cost": 0.026,
    "created_at": "2026-01-01T12:00:00Z"
  }
}

Models

Choose from multiple models based on quality and budget.

Model

Status

Max size

Price

Zekron Image v0.1.1

zekron-image-1:image-preview

Flagship photorealistic model.

2048x2048

$0.025–$0.028

Zekron XL

zekron-xl

Balanced speed and quality.

Preview

1024x1024

$0.02–$0.025

Zekron Flash

zekron-flash

Fast, high-throughput.

Beta

1024x1024

$0.015–$0.02

Zekron Art

zekron-art

Artistic stylized outputs.

Preview

1024x1024

$0.02–$0.025

Pricing

Pay per image. No monthly fees. Price depends on model and prompt length.

Model

Min

Max

Zekron Image v0.1.1

$0.025

$0.028

Zekron XL

$0.020

$0.025

Zekron Flash

$0.015

$0.020

Zekron Art

$0.020

$0.025

New accounts receive $5.00 bonus credit with their first deposit of $30 or more.

Rate limits

Rate limits are per API key. Exceeding returns 429 with a Retry-After header.

Requests per minute60

Window60 seconds

ScopePer API key

Errors

All errors return a JSON body with an error object.

error response

{
  "error": {
    "type": "unauthorized",
    "message": "Invalid API key",
    "suggestion": "Check your API key."
  }
}

Status

Code

Description

400

bad_request

Invalid request body

401

unauthorized

Invalid or missing API key

402

payment_required

Insufficient balance

404

not_found

Endpoint not found

429

rate_limit_exceeded

Too many requests (60/min)

500

server_error

Internal server error

Payments

Top up via the Telegram Bot. Two methods are supported:

Telegram Stars

Pay with Telegram Stars inside the bot. Instant, no fees.

Instant · No fees

USDT on TON

Send USDT on TON blockchain. 2% fee, 30-minute window.

2% fee · 30 min