Outpaint API

fal.ai Image Apps V2 outpainting. Expand an image beyond its original edges. Integrate this model via REST with endpoint docs, parameters, and code examples.

Image Generation

Credit Cost

1 credit

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/outpaint/run

LLM.txt

AI-Ready

For AI assistants

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

/llm/outpaint.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
`image_url` required	url	Reference image URL.	-
`expand_left`	number	Pixels to expand the image on the left side.	-
`expand_right`	number	Pixels to expand the image on the right side.	-
`expand_top`	number	Pixels to expand the image on the top.	-
`expand_bottom`	number	Pixels to expand the image on the bottom.	-
`zoom_out_percentage`	number	Convenience shortcut — expand all four sides by this percentage of the original dimensions (e.g. 25 = expand 25% in every direction).	-
`prompt`	string	Text instruction describing what to generate or edit.	-
`num_images`	integer	Number of output images. min: 1 \| max: 4	`1`
`output_format`	enum	Output file format. `pngjpegwebp`	`png`

Example Outputs

Real outputs generated by this model

View Details

a thrilling action sequence of a woman trying to find her favorite candy. The candy wrapper is purple with a pixelated dragon and reads "Pixel Dojo". The woman says "Gotta have that pixel dojo candy. with over 60 ai tools, it's basically zero calories."

1 credits

29.2s

View Details

1 credits

19.2s

Code Examples

Copy and paste to get started

bash

curl -X POST "https://pixeldojo.ai/api/v1/models/outpaint/run" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A beautiful mountain landscape at golden hour",
    "aspect_ratio": "1:1"
  }'

Response Format

Submit Response (202 Accepted)

json

{
  "jobId": "job_abc123...",
  "status": "pending",
  "statusUrl": "https://pixeldojo.ai/api/v1/jobs/job_abc123...",
  "creditCost": 1,
  "creditsRemaining": 95,
  "expiresAt": "2025-01-23T12:00:00Z"
}

Completed Response

json

{
  "jobId": "job_abc123...",
  "status": "completed",
  "output": {
    "images": [
      "https://temp.pixeldojo.ai/pixeldojotemp/1705930123-456789.png"
    ]
  },
  "creditCost": 1,
  "expiresAt": "2025-01-23T12:00:00Z"
}

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