Skip to content

Fooocus Upscale or Vary

Integrate

Model id fooocus/upscale-or-vary
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/fooocus/upscale-or-vary?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "uov_image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

This request: ≈$0.007 7 API credits · ≈ ₽0.75 Run it on this page

Get API key
Open model Upscale #upscaling#vary#stylized

Fooocus tool to upscale an image 1.5x or 2x, or create subtle or strong variations of it

Open model · Image

Your first result goes here

Build a request below and run it with your API key. Outputs are copied to our storage, kept forever or 7 days for free.

Build a request

Controls are generated from the model schema. The code and the price update as you change them.

default

Describe the image you want generated, using as much detail as possible to get the best results.

•required
Drop a file, or

Source image for upscaling or variation.

default 1024x1024

Output image dimensions, selected from presets or specified as custom width and height. Both custom dimensions must be divisible by 8.

num_images default 1

Image count to generate per request.

Advanced negative_prompt · performance · output_format · uov_method · refiner_model · guidance_scale · sharpness · refiner_switch · seed · mixing_image_prompt_and_vary_upscale · enable_safety_checker · styles · loras · image_prompt_1 · image_prompt_2 · image_prompt_3 · image_prompt_4
default

Negative prompt specifying image details to exclude, including colors, objects, scenery, or finer features. Examples include a moustache, blur, or low resolution.

performance default Extreme Speed

Performance choice: Speed or Quality.

output_format default jpeg

File format for the resulting image.

uov_method default Vary (Strong)

Method applied for upscaling or creating variations.

default None

Refiner selection: SDXL or SD 1.5.

default 4

Prompt-adherence strength for image selection, expressed as CFG (Classifier Free Guidance).

default 2

Sharpness setting for the output image. Increasing it makes both the image and its textures sharper.

default 0.8

Refiner switch value: use 0.4 with realistic SD1.5 models, 0.667 with anime SD1.5 models, and 0.8 with XL-refiners. Switching between two SDXL models permits any value.

Seed for reproducing images in Stable Diffusion. An image can be reproduced exactly on every run by keeping the model version, prompt, and seed unchanged.

default ["Fooocus Enhance","F...

Style applied during generation.

default [{"path":"https://hug...

LoRA selection merged for final image generation, limited to 5 LoRAs.

POST /run/fooocus/upscale-or-vary?wait=20 quote → $0.007
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/fooocus/upscale-or-vary?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "uov_image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Run this request

Your key stays in this browser: it is sent only to the Doitong API and saved (localStorage) only if you tick Remember. Get an API key

About Fooocus Upscale or Vary

Takes a source image as `uov_image_url` and applies `uov_method`: Vary (Subtle), Vary (Strong), Upscale (1.5x), Upscale (2x) or Upscale (Fast 2x). The default is Vary (Strong). A `prompt`, styles, LoRAs and optional image prompts can steer the result, and 1 to 4 images are returned.

Parameters

Send either the canonical name or the native name, not both. Canonical names

NameType DefaultAllowed Description
promptoptional
Typestring
Default
Describe the image you want generated, using as much detail as possible to get the best results.
negative_promptoptional
Typestring
Default
Negative prompt specifying image details to exclude, including colors, objects, scenery, or finer features. Examples include a moustache, blur, or low resolution.
stylesoptional
Typeenum[]
Default["Fooocus Enhance","Fooocus Sharp","Fooocus V2"]
Style applied during generation.
performanceoptional
Typeenum
DefaultExtreme Speed
SpeedQualityExtreme SpeedLightning
Performance choice: Speed or Quality.
guidance_scaleoptional
Typenumber
Default4
1 – 30
Prompt-adherence strength for image selection, expressed as CFG (Classifier Free Guidance).
sharpnessoptional
Typenumber
Default2
0 – 30
Sharpness setting for the output image. Increasing it makes both the image and its textures sharper.
aspect_ratiooptional
Typestring
Default1024x1024
Output image dimensions, selected from presets or specified as custom width and height. Both custom dimensions must be divisible by 8.
num_imagesoptional num_outputs
Typeinteger
Default1
1 – 4
Image count to generate per request.
lorasoptional
Typeobject[]
Default[{"path":"https://huggingface.co/stabilityai/stable-diffusion-xl-base-1.0/resolve/main/sd_xl_offset_example-lora_1.0.safetensors","scale":0.1}]
LoRA selection merged for final image generation, limited to 5 LoRAs.
loras[].pathrequired
Typestring
Location of the LoRA weights, specified as a URL or path.
loras[].scaleoptional
Typenumber
Default0.1
0 – 1
Multiplier applied to the LoRA weight before it is merged into the base model.
refiner_modeloptional
Typeenum
DefaultNone
NonerealisticVisionV60B1_v51VAE.safetensors
Refiner selection: SDXL or SD 1.5.
refiner_switchoptional
Typenumber
Default0.8
0 – 1
Refiner switch value: use 0.4 with realistic SD1.5 models, 0.667 with anime SD1.5 models, and 0.8 with XL-refiners. Switching between two SDXL models permits any value.
output_formatoptional
Typeenum
Defaultjpeg
pngjpegwebp
File format for the resulting image.
seedoptional
Typeinteger | null
Seed for reproducing images in Stable Diffusion. An image can be reproduced exactly on every run by keeping the model version, prompt, and seed unchanged.
uov_image_urlrequired
Typeurl · image
Source image for upscaling or variation.
uov_methodoptional
Typeenum
DefaultVary (Strong)
DisabledVary (Subtle)Vary (Strong)Upscale (1.5x)Upscale (2x)Upscale (Fast 2x)
Method applied for upscaling or creating variations.
image_prompt_1optional
Typeobject
image_prompt_1.typeoptional
Typeenum
DefaultImagePrompt
ImagePromptPyraCannyCPDSFaceSwap
image_prompt_1.image_urloptional
Typeurl · image
image_prompt_1.stop_atoptional
Typenumber
Default0.5
0 – 1
image_prompt_1.weightoptional
Typenumber
Default1
0 – 2
image_prompt_2optional
Typeobject
image_prompt_2.typeoptional
Typeenum
DefaultImagePrompt
ImagePromptPyraCannyCPDSFaceSwap
image_prompt_2.image_urloptional
Typeurl · image
image_prompt_2.stop_atoptional
Typenumber
Default0.5
0 – 1
image_prompt_2.weightoptional
Typenumber
Default1
0 – 2
image_prompt_3optional
Typeobject
image_prompt_3.typeoptional
Typeenum
DefaultImagePrompt
ImagePromptPyraCannyCPDSFaceSwap
image_prompt_3.image_urloptional
Typeurl · image
image_prompt_3.stop_atoptional
Typenumber
Default0.5
0 – 1
image_prompt_3.weightoptional
Typenumber
Default1
0 – 2
image_prompt_4optional
Typeobject
image_prompt_4.typeoptional
Typeenum
DefaultImagePrompt
ImagePromptPyraCannyCPDSFaceSwap
image_prompt_4.image_urloptional
Typeurl · image
image_prompt_4.stop_atoptional
Typenumber
Default0.5
0 – 1
image_prompt_4.weightoptional
Typenumber
Default1
0 – 2
mixing_image_prompt_and_vary_upscaleoptional
Typeboolean
Defaultfalse
Combines Image Prompt with Vary/Upscale.
enable_safety_checkeroptional
Typeboolean
Defaulttrue
Safety checker toggle; setting it to false disables checking.
required Canonical name, also accepted

File parameters take a public https:// URL, a data: URI up to 10 MB, or the file_url of an upload. Files

Output

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "fooocus/upscale-or-vary",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 7,
    "usd": "0.007",
    "charged": 7,
    "refunded": 0
  },
  "input": {
    "uov_image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "output": {
    "images": [
      {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200,
        "width": 1024,
        "height": 768
      }
    ],
    "timings": {},
    "has_nsfw_concepts": [
      false
    ]
  },
  "outputs": [
    {
      "type": "image",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "width": 1024,
      "height": 768,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Your files, your choiceEvery outputs[].url is a copy on our storage: kept forever (paid per GB-month) or 7 days for free, by your account setting or ?storage=.
Same shape on every modeltype, url, content_type, width, height and duration, for images, video and audio alike. output is the model’s own result object.
Fields of output
images
array of object {url, content_type, file_name, file_size, width, height}File information for the generated image.
timings
objectElapsed time for generation.
has_nsfw_concepts
array of booleanIndicates whether NSFW concepts appear in the generated images.

More models: Upscale

For AI agents: this page as Markdown is at https://doitong.com/en-US/developers/models/fooocus/upscale-or-vary.md. All models and guides: https://doitong.com/developers/llms.txt