API Playground

1. Submit a job (cURL)

curl -X POST https://api.upres.ai/v1/jobs \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://example.com/photo.jpg",
    "model": "flare",
    "scale": 4
  }'

Returns a job ID. Poll to check status.

2. Submit + wait (Python)

import requests, time

API = "https://api.upres.ai/v1"
KEY = "YOUR_API_KEY"

r = requests.post(f"{API}/jobs", headers={
    "Authorization": f"Bearer {KEY}",
    "Content-Type": "application/json"
}, json={
    "image_url": "https://example.com/photo.jpg",
    "model": "flare",
    "scale": 4
})
job = r.json()
print(f"Job: {job['id']}")

while True:
    r = requests.get(f"{API}/jobs/{job['id']}",
        headers={"Authorization": f"Bearer {KEY}"})
    if r.json()["status"] == "completed":
        print(f"Done: {r.json()['output_url']}")
        break
    time.sleep(3)

3. JavaScript SDK

import { UpRes } from "upres-cli";

const upres = new UpRes("YOUR_API_KEY");
const result = await upres.upscale({
  imageUrl: "https://example.com/photo.jpg",
  model: "flare",
  scale: 4
});
console.log(result.outputUrl);

4. CLI (one command)

npm install -g upres-cli
upres upscale photo.jpg --model flare --scale 4

5. MCP for AI agents

npx -y upres-cli mcp

Connects to Claude, Cursor, or any MCP-compatible agent.

Models