Image & Video Generation
for AI Agents

Generate images and videos from 40+ AI models with a simple REST API. Built for AI agents, LLMs, and automation pipelines.

TypeScript

// npm install @pixeldojo/sdk
import { PixelDojoClient } from "@pixeldojo/sdk";

const pd = new PixelDojoClient({ apiKey: "pd_your_api_key" });
const job = await pd.generate("flux-1.1-pro", {
  prompt: "A fantasy castle on a cliff at sunset"
});

// → job.assets[0].url

Get started in seconds

Copy the code, swap in your API key, run it.

quick start

import { PixelDojoClient } from "@pixeldojo/sdk";

const pd = new PixelDojoClient({ apiKey: "pd_your_api_key" });

// Generate an image and wait for the result
const job = await pd.generate("flux-1.1-pro", {
  prompt: "A fantasy castle on a cliff at sunset",
  aspect_ratio: "16:9",
});

console.log(job.assets[0].url);

Install the SDK

Typed client for Node.js, Deno, Bun, and any JavaScript runtime with fetch.

terminal

npm install @pixeldojo/sdk

Zero dependencies

Uses native fetch. No axios, no node-fetch.

Full type coverage

Every method, response, and error is typed.

ESM + CJS

Dual-format build. Works everywhere.

@pixeldojo/sdk on npm · No SDK? Use the REST API directly with any HTTP client.

Built for automation

Every detail is designed for machines that call APIs, not humans clicking buttons.

40+ AI Models

Image generation, video generation, upscaling, and editing — all from one API.

Async by Default

Submit a job, get a job ID. Poll the status URL or register a webhook.

Per-Model Schemas

Every model has a JSON schema endpoint. Your agent knows the exact request shape before calling.

No Browser Needed

Pure REST API. No UI scraping, no headless browser, no screenshots.

Credit-Based Pricing

Pay per generation with credits. No subscription required to use the API.

LLM Discovery

llm.txt, OpenAPI 3.1 spec, and AI plugin manifest for zero-config agent integration.

How it works

Three API calls. Schema in, image out.

Pick a model

List models or fetch the schema for a specific one.

GET /api/v1/models/flux-1.1-pro/schema

{
  "apiId": "flux-1.1-pro",
  "name": "Flux 1.1 Pro",
  "inputSchema": {
    "prompt": { "type": "string", "required": true },
    "aspect_ratio": { "type": "string", "default": "1:1" },
    "raw": { "type": "boolean", "default": false }
  }
}

Submit a job

POST with the prompt and parameters. You get a job ID back instantly.

POST /api/v1/models/flux-1.1-pro/run
{
  "prompt": "A fantasy castle on a cliff at sunset",
  "aspect_ratio": "16:9"
}

→ {
  "jobId": "job_abc123",
  "statusUrl": "https://pixeldojo.ai/api/v1/jobs/job_abc123",
  "status": "processing"
}

Get the result

Poll the status URL. When complete, grab the output URL.

GET /api/v1/jobs/job_abc123

{
  "status": "completed",
  "output": {
    "images": [
      "https://pixeldojo-prod.s3.amazonaws.com/generations/abc123.png"
    ]
  },
  "creditCost": 1,
  "model": "flux-1.1-pro"
}

Endpoint reference

Method	Endpoint	Description
`GET`	`/api/v1/models`	List all available models
`GET`	`/api/v1/models/{apiId}/schema`	Get the JSON schema for a model
`POST`	`/api/v1/models/{apiId}/run`	Submit a generation job
`GET`	`/api/v1/jobs/{jobId}`	Check job status and get output URLs
`POST`	`/api/v1/jobs/{jobId}/webhook`	Register a webhook for completion