Image Outpainting 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.

Compare image models Use cases

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

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/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 credit

29.2s

View Details

1 credit

19.2s

Code Examples

Outpaint an image — 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 '{
    "image_url": "https://...",
    "expand_bottom": 200
  }'

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": "2026-07-18T05:19:38Z"
}

Completed Response

json

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

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