Image Generation

Portrait Upscaler API

Crystal Upscaler via Replicate. Face-detail preserving upscale, cost scales with output megapixels. Integrate this model via REST with endpoint docs, parameters, and code examples.

Compare image models Use cases

Img2Img

Credit Cost

6 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/face-enhance/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/face-enhance.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` required	url	URL of the portrait to upscale. We read its pixel size before charging: the output (width x height x scale_factor²) is billed by tier, 1.5 credits up to 4.4 MP, 3 up to 8.8 MP, 6 up to 17.6 MP, 12 up to 27.5 MP, 24 up to 55 MP, 48 up to 110 MP and 96 above that. An image we cannot read is refused, uncharged.	-
`scale_factor`	number	Upscale multiplier, 1 to 8. A 4x upscale of a 1 megapixel portrait is a 16 MP output: 6 credits. min: 1 \| max: 8	`4`

Use saved characters (@Name)

This model takes no reference images, so @Name of a saved character is refused (400) before anything is charged. A saved location, prop or style with a description is inserted as text. For saved characters, use a model that takes reference images, such as Nano Banana Pro or Seedream 5 for images, or Seedance 2.5 or WAN 3.0 for video.

Example Outputs

Real outputs generated by this model

View Details

2 credits

25.4s

Code Examples

Upscale 4x: copy and paste to get started

bash

curl -X POST "https://pixeldojo.ai/api/v1/models/face-enhance/run" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://...",
    "scale_factor": 4
  }'

Response Format

Submit Response (202 Accepted)

json

{
  "jobId": "job_abc123...",
  "status": "pending",
  "statusUrl": "https://pixeldojo.ai/api/v1/jobs/job_abc123...",
  "creditCost": 6,
  "creditsRemaining": 95,
  "expiresAt": "2026-10-30T11:02:14Z"
}

Completed Response

json

{
  "jobId": "job_abc123...",
  "status": "completed",
  "output": {
    "images": [
      "https://temp.pixeldojo.ai/pixeldojotemp/1705930123-456789.png"
    ]
  },
  "creditCost": 6,
  "expiresAt": "2026-10-30T11:02:14Z"
}

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