Pixza Diffusion API

The Pixza API empowers developers to generate high-resolution imagery, perform spatial outpainting, and stream real-time latent denoising frames directly into applications with sub-second response times.

API v1.4 Active Base URL: https://api.pixza.ai/v1

Installation

Install the official client libraries for Python or Node.js:

Terminal (Shell) 
npm install @pixza/sdk
# or via Python:
pip install pixza-ai

Authentication

Authenticate all requests by including your secret API key in the Authorization bearer header.

HTTP Header 
Authorization: Bearer px_live_948201849204819203810

Generate Visual Image (POST /v1/images/generate)

Submit a prompt along with aspect ratio, model version, and diffusion guidance scale to generate a master render.

bash (cURL) 
curl -X POST https://api.pixza.ai/v1/images/generate \
  -H "Authorization: Bearer px_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "pixza-ultra-v4.8",
    "prompt": "A luminous ethereal garden of bioluminescent flora in violet twilight, 8k octane render",
    "aspect_ratio": "16:9",
    "steps": 32,
    "cfg_scale": 7.5,
    "seed": 849204
  }'

Response Example (200 OK)

json (application/json) 
{
  "id": "gen_849201a9b",
  "status": "completed",
  "created_at": 1727918400,
  "model": "pixza-ultra-v4.8",
  "data": [
    {
      "url": "https://cdn.pixza.ai/outputs/gen_849201a9b.webp",
      "resolution": "3840x2160",
      "seed": 849204,
      "latency_seconds": 0.82
    }
  ]
}

Interactive API Console

Live Sandbox

Test sending an inference payload directly to the simulated endpoint:

Ready: 200 OK