Generation Tools
Enhance / Upscale
Upscale and sharpen an existing photo — no scene or subject changes, purely a resolution/clarity pass.
toolId: "photo_enhance"
3 credits
deterministic
What it does
Fashio upscales and sharpens the photo you send in. Output preserves the input's aspect ratio and framing exactly, just at higher resolution and clarity — there's no prompt and no selectors, just the image.
Request body
| Field | Type | Description | |
|---|---|---|---|
toolId | string | required | Always "photo_enhance". |
images.user_photo | string | required | URL of the photo to enhance (from POST /v1/uploads or your own hosting). |
No pose, no ratio, no prompt fields — this is the simplest request body of any tool in the catalog.
Example request
curl -X POST https://api.fashiolabs.com/v1/generations \
-H "Authorization: Bearer fio_live_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"toolId": "photo_enhance",
"images": {
"user_photo": "https://your-cdn.com/photo.jpg"
}
}'
const res = await fetch("https://api.fashiolabs.com/v1/generations", {
method: "POST",
headers: {
Authorization: "Bearer " + process.env.FASHIO_API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({
toolId: "photo_enhance",
images: {
user_photo: "https://your-cdn.com/photo.jpg",
},
}),
});
const { id } = await res.json();
import os, requests
res = requests.post(
"https://api.fashiolabs.com/v1/generations",
headers={"Authorization": f"Bearer {os.environ['FASHIO_API_KEY']}"},
json={
"toolId": "photo_enhance",
"images": {
"user_photo": "https://your-cdn.com/photo.jpg",
},
},
)
job_id = res.json()["id"]
Response
202 Accepted
{ "success": true, "id": "8b1e...", "status": "processing" }Poll GET /v1/generations/:id (see Quickstart) until it completes:
200 · completed
{
"success": true,
"id": "8b1e...",
"status": "completed",
"resultUrls": ["https://.../result.jpg"],
"errorMessage": null
}Common errors
| Status | Meaning |
|---|---|
| 400 | photo_enhance: missing required image "user_photo" — required image field wasn't resolvable. |
| 402 | Insufficient diamonds. Required 3, have <n>. |
| 429 | Daily request cap reached for this key — see Rate Limits. |
Related tools
- Remove Background — another deterministic, no-prompt pass on an existing photo.
- Amateur to Professional — a heavier retouch pass beyond just resolution.