Reve 2.1 API

Reve 2.1 — generate from text, edit a single image, or remix up to 8 reference images with frame-level prompt control. Integrate this model via REST with endpoint docs, parameters, and code examples.

Prompting guide Compare image models Use cases

Image Generation

Img2Img

Editing

Credit Cost

4 credits

Type

Image

Get API Key

Create auth keys for apps and agents

See Usage

Track requests, credits, and logs

Buy Credits

Top up prepaid API capacity

API Endpoint

POST

/api/v1/models/reve/run

Test This Model

Run a real request through the API pipeline and inspect the exact input and output your integration will handle. Uses your credits like any API call; failed runs are refunded automatically.

LLM.txt

AI-Ready

For AI assistants

Copy this model's documentation into Claude, GPT, or any AI for instant integration help.

/llm/reve.txt

OpenAPI Spec

Swagger compatible

Import into Postman, Swagger UI, or generate client SDKs in any language.

/api/openapi

Parameters

Input parameters accepted by this model

Parameter	Type	Description	Default
`prompt` required	string	Text description of the image. When reference images are provided, describes how to edit or combine them. Reference a specific image from the prompt with <frame>N</frame> (0-based position in reference_images).	-
`reference_images`	array	Ordered list of up to 8 image URLs to edit (1 image) or remix (2-8 images). Leave empty for text-to-image generation. Address individual images from the prompt with <frame>N</frame>.	-
`aspect_ratio`	enum	Desired aspect ratio of the generated image. Use 'auto' to let the model choose an appropriate ratio for the request. `auto4:13:121:92:1`+13 more	`auto`

Supported Aspect Ratios

1:1

16:9

9:16

4:3

3:4

3:2

2:3

21:9

Code Examples

Text → image — copy and paste to get started

bash

curl -X POST "https://pixeldojo.ai/api/v1/models/reve/run" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A serene mountain landscape at sunset with snow-capped peaks",
    "aspect_ratio": "3:2"
  }'

Response Format

Submit Response (202 Accepted)

json

{
  "jobId": "job_abc123...",
  "status": "pending",
  "statusUrl": "https://pixeldojo.ai/api/v1/jobs/job_abc123...",
  "creditCost": 4,
  "creditsRemaining": 95,
  "expiresAt": "2026-07-18T05:14:34Z"
}

Completed Response

json

{
  "jobId": "job_abc123...",
  "status": "completed",
  "output": {
    "images": [
      "https://temp.pixeldojo.ai/pixeldojotemp/1705930123-456789.png"
    ]
  },
  "creditCost": 4,
  "expiresAt": "2026-07-18T05:14:34Z"
}

LLM Documentation Try in Web UI Get API Key Usage Dashboard Buy Credits