API Reference v1

Pixza API

Integrate AI image, video, and 3D generation into your website, app, WordPress site, or Shopify store. One API. All models.

Image Generation

Video Generation

3D Models

< 3s avg response

REST API

API Key Auth

Base URL

https://pixzaai.com/api/v1

Authentication

API Keys

All API requests require a Bearer token in the Authorization header.

Get your key

Keep it secret

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

Rate limits

Free: 10 req/min · Pro: 60 req/min · Agency: 300 req/min

http

Authorization: Bearer pk_live_YOUR_API_KEY

Coming soon: API keys are not yet available. Sign up to get notified when the API launches. Join waitlist →

Endpoints

Generate

The core endpoint for all AI generation — images, videos, and 3D models.

POST/api/v1/generateCore

Generate an image, video, or 3D model from a prompt

GET/api/v1/generate/{id}

Get the status and result of a generation

GET/api/v1/generations

List your recent generations

GET/api/v1/models

List all available models

GET/api/v1/credits

Get your current credit balance

Request Body

Parameter	Type	Required	Description
`type`	string	Yes	Generation type: "image" \| "video" \| "3d"
`prompt`	string	Yes	Text description of what to generate
`model`	string	No	Model ID (default: "flux-schnell")
`input_image`	string	No	URL of input image for img2img or video
`width`	integer	No	Output width in pixels (default: 1024)
`height`	integer	No	Output height in pixels (default: 1024)
`steps`	integer	No	Inference steps (default: model-specific)
`seed`	integer	No	Random seed for reproducibility
`webhook_url`	string	No	URL to POST result to when complete

Code Examples

bash

curl -X POST https://pixzaai.com/api/v1/generate \
  -H "Authorization: Bearer pk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "image",
    "prompt": "A luxury product on marble surface, cinematic lighting",
    "model": "flux-pro",
    "width": 1024,
    "height": 1024
  }'

Response

json

{
  "id": "gen_abc123xyz",
  "status": "completed",
  "type": "image",
  "model": "flux-pro",
  "prompt": "A luxury product on marble surface, cinematic lighting",
  "output_url": "https://cdn.pixzaai.com/gen/abc123.jpg",
  "width": 1024,
  "height": 1024,
  "credits_used": 4,
  "created_at": "2026-05-11T12:00:00Z"
}

Models

Available Models

All models are billed in credits. 1 credit ≈ ₹0.10.

Model ID	Type	Credits	Description
`flux-schnell`	image	1	Fastest image generation — 4 steps
`flux-dev`	image	2	Balanced quality and speed
`flux-pro`	image	4	Highest quality FLUX model
`flux-kontext`	image	4	Image-to-image editing with FLUX
`seedream`	image	3	ByteDance Seedream 4.5
`gemini-imagen-4`	image	3	Google Imagen 4 via Gemini
`veo-3-fast`	video	50	Google Veo 3 Fast — text to video
`wan-i2v`	video	20	Image to video animation

Errors

Error Codes

All errors return a JSON body with a message field.

401

Unauthorized

Missing or invalid API key

402

Insufficient Credits

Your account has run out of credits

422

Validation Error

Invalid request parameters

429

Rate Limited

Too many requests — slow down

500

Server Error

Something went wrong on our end

json

{
  "error": "insufficient_credits",
  "message": "Your account has 0 credits remaining. Upgrade your plan to continue.",
  "credits_remaining": 0
}

Integrations

SDKs & Plugins

Official integrations for popular platforms. More coming soon.

JavaScript / Node.js

Coming Soon

Official npm package for Node.js and browser environments.

npm install @pixzaai/sdk

WordPress Plugin

Coming Soon

Add AI generation to any WordPress site. Gutenberg block + shortcode support.

Search: Pixza AI in WP Plugin Directory

Shopify App

Coming Soon

Generate product images and backgrounds directly from your Shopify admin.

Search: Pixza AI in Shopify App Store

Python

Coming Soon

Python SDK for data science, automation, and backend integrations.

pip install pixzaai

REST API

Available

Use the raw REST API from any language or platform.

https://pixzaai.com/api/v1

Webhooks

Coming Soon

Get notified when async generations complete via HTTP POST.

POST { "id": "gen_xxx", "status": "completed" }

Ready to build?

Get API Key Try Studio first