Fooocus Inpainting Serverless API
Fooocus Inpainting is a powerful image generation model that allows you to selectively edit and enhance images.
POST /v2/focus-inpaint · submit + poll 1# pip install "segmind>=1.1.0"
2# export SEGMIND_API_KEY="YOUR_API_KEY"
3import segmind
4
5# Async (v2): submit to the queue and block until COMPLETED.
6# run() returns the final result dict (600s deadline, 1.0s poll by default).
7result = segmind.run(
8 "focus-inpaint",
9 prompt="Photo of a car on a road in a hill station",
10 negative_prompt="lowquality, badquality, sketches",
11 steps=30,
12 samples=1,
13 styles=["Fooocus V2", "Fooocus Sharp", "Fooocus Enhance"],
14 aspect_ratios="1024*1024",
15 seed=354849415,
16 guidance_scale=4,
17 scheduler="karras",
18 base_model="juggernaut_v8",
19 sampler="dpmpp_2m_sde_gpu",
20 input_image="https://segmind-sd-models.s3.amazonaws.com/display_images/focus-inpaint-input.jpg",
21 input_mask="https://segmind-sd-models.s3.amazonaws.com/display_images/focus-inpaint-mask.jpg",
22 inpaint_erode_or_dilate=1,
23 inpaint_respective_field=0.618,
24 inpaint_strength=1,
25 invert_mask_checkbox="false",
26 mixing_image_prompt_and_inpaint="true",
27 faceswap_cn_stop=0.9,
28 faceswap_cn_weight=0.8,
29 imageprompt_cn_stop=0.5,
30 imageprompt_cn_weight=0.6,
31 pyracanny_cn_stop=0.5,
32 pyracanny_cn_weight=1,
33 cpds_cn_stop=0.5,
34 cpds_cn_weight=1,
35 base64=False,
36)
37print(result["status"]) # COMPLETED
38print(result.get("output")) # model output (e.g. media URL)
39print(result["metrics"]["inference_time"]) # server compute seconds
40
41# --- Or submit + poll manually (track request_id, control the cadence) ---
42from segmind import SegmindClient, InferenceFailed, InferenceTimeout
43
44client = SegmindClient() # reads SEGMIND_API_KEY
45payload = {
46 "prompt": "Photo of a car on a road in a hill station",
47 "negative_prompt": "lowquality, badquality, sketches",
48 "steps": 30,
49 "samples": 1,
50 "styles": ["Fooocus V2", "Fooocus Sharp", "Fooocus Enhance"],
51 "aspect_ratios": "1024*1024",
52 "seed": 354849415,
53 "guidance_scale": 4,
54 "scheduler": "karras",
55 "base_model": "juggernaut_v8",
56 "sampler": "dpmpp_2m_sde_gpu",
57 "input_image": "https://segmind-sd-models.s3.amazonaws.com/display_images/focus-inpaint-input.jpg",
58 "input_mask": "https://segmind-sd-models.s3.amazonaws.com/display_images/focus-inpaint-mask.jpg",
59 "inpaint_erode_or_dilate": 1,
60 "inpaint_respective_field": 0.618,
61 "inpaint_strength": 1,
62 "invert_mask_checkbox": "false",
63 "mixing_image_prompt_and_inpaint": "true",
64 "faceswap_cn_stop": 0.9,
65 "faceswap_cn_weight": 0.8,
66 "imageprompt_cn_stop": 0.5,
67 "imageprompt_cn_weight": 0.6,
68 "pyracanny_cn_stop": 0.5,
69 "pyracanny_cn_weight": 1,
70 "cpds_cn_stop": 0.5,
71 "cpds_cn_weight": 1,
72 "base64": False,
73}
74job = client.submit_async("focus-inpaint", **payload)
75print(job.request_id) # available immediately
76try:
77 result = job.wait(timeout=600, interval=1.0)
78except InferenceTimeout as e:
79 print("still running:", e.request_id)
80except InferenceFailed as e:
81 print("failed:", e.detail) 1# pip install "segmind>=1.1.0"
2# export SEGMIND_API_KEY="YOUR_API_KEY"
3import segmind
4
5# Async (v2): submit to the queue and block until COMPLETED.
6# run() returns the final result dict (600s deadline, 1.0s poll by default).
7result = segmind.run(
8 "focus-inpaint",
9 prompt="Photo of a car on a road in a hill station",
10 negative_prompt="lowquality, badquality, sketches",
11 steps=30,
12 samples=1,
13 styles=["Fooocus V2", "Fooocus Sharp", "Fooocus Enhance"],
14 aspect_ratios="1024*1024",
15 seed=354849415,
16 guidance_scale=4,
17 scheduler="karras",
18 base_model="juggernaut_v8",
19 sampler="dpmpp_2m_sde_gpu",
20 input_image="https://segmind-sd-models.s3.amazonaws.com/display_images/focus-inpaint-input.jpg",
21 input_mask="https://segmind-sd-models.s3.amazonaws.com/display_images/focus-inpaint-mask.jpg",
22 inpaint_erode_or_dilate=1,
23 inpaint_respective_field=0.618,
24 inpaint_strength=1,
25 invert_mask_checkbox="false",
26 mixing_image_prompt_and_inpaint="true",
27 faceswap_cn_stop=0.9,
28 faceswap_cn_weight=0.8,
29 imageprompt_cn_stop=0.5,
30 imageprompt_cn_weight=0.6,
31 pyracanny_cn_stop=0.5,
32 pyracanny_cn_weight=1,
33 cpds_cn_stop=0.5,
34 cpds_cn_weight=1,
35 base64=False,
36)
37print(result["status"]) # COMPLETED
38print(result.get("output")) # model output (e.g. media URL)
39print(result["metrics"]["inference_time"]) # server compute seconds
40
41# --- Or submit + poll manually (track request_id, control the cadence) ---
42from segmind import SegmindClient, InferenceFailed, InferenceTimeout
43
44client = SegmindClient() # reads SEGMIND_API_KEY
45payload = {
46 "prompt": "Photo of a car on a road in a hill station",
47 "negative_prompt": "lowquality, badquality, sketches",
48 "steps": 30,
49 "samples": 1,
50 "styles": ["Fooocus V2", "Fooocus Sharp", "Fooocus Enhance"],
51 "aspect_ratios": "1024*1024",
52 "seed": 354849415,
53 "guidance_scale": 4,
54 "scheduler": "karras",
55 "base_model": "juggernaut_v8",
56 "sampler": "dpmpp_2m_sde_gpu",
57 "input_image": "https://segmind-sd-models.s3.amazonaws.com/display_images/focus-inpaint-input.jpg",
58 "input_mask": "https://segmind-sd-models.s3.amazonaws.com/display_images/focus-inpaint-mask.jpg",
59 "inpaint_erode_or_dilate": 1,
60 "inpaint_respective_field": 0.618,
61 "inpaint_strength": 1,
62 "invert_mask_checkbox": "false",
63 "mixing_image_prompt_and_inpaint": "true",
64 "faceswap_cn_stop": 0.9,
65 "faceswap_cn_weight": 0.8,
66 "imageprompt_cn_stop": 0.5,
67 "imageprompt_cn_weight": 0.6,
68 "pyracanny_cn_stop": 0.5,
69 "pyracanny_cn_weight": 1,
70 "cpds_cn_stop": 0.5,
71 "cpds_cn_weight": 1,
72 "base64": False,
73}
74job = client.submit_async("focus-inpaint", **payload)
75print(job.request_id) # available immediately
76try:
77 result = job.wait(timeout=600, interval=1.0)
78except InferenceTimeout as e:
79 print("still running:", e.request_id)
80except InferenceFailed as e:
81 print("failed:", e.detail)API Endpoint
https://api.segmind.com/v1/focus-inpaintParameters
input_imagerequiredstring (uri)Input image
input_maskrequiredstring (uri)Input Mask
promptrequiredstringPrompt to render
aspect_ratiosoptionalstringOutput image aspect ratio
"1024*1024""704*1408""704*1344""768*1344""768*1280""832*1216""832*1152""896*1152""896*1088""960*1088""960*1024"+16 morebase_modeloptionalstringBase model for inference
"juggernaut_v8""juggernaut_v8""Unstable_diffusers_v11""protovisionxl""realism_engine_v3"base64optionalbooleanBase64 encoding of the output image.
falsecpds_cn_stopoptionalnumberControlnet stop value
0.5Range: 0 - 1.5cpds_cn_weightoptionalnumberControlnet weight value
1Range: 0 - 1.5cpds_imgoptionalstring (uri)CPDS image
faceswap_cn_stopoptionalnumberFace swap stop value
0.9Range: 0 - 1.5faceswap_cn_weightoptionalnumberFace swap weight value
0.8Range: 0 - 1.5faceswap_imgoptionalstring (uri)Face image for swapping
guidance_scaleoptionalnumberScale for classifier-free guidance
4Range: 1 - 25imageprompt_cn_stopoptionalnumberIp controlnet stop value
0.5Range: 0 - 1.5imageprompt_cn_weightoptionalnumberIp controlnet weight
0.6Range: 0 - 1.5imageprompt_imgoptionalstring (uri)Image prompt image
inpaint_additional_promptoptionalstringAdditional Prompt for Inpainting
inpaint_erode_or_dilateoptionalnumberErode or Dilate values. Negative implies Erode and vice versa
1Range: -50 - 50inpaint_respective_fieldoptionalnumberInpaint Respective Field
0.618Range: 0 - 1inpaint_strengthoptionalnumberInpaint strength
1Range: 0 - 1invert_mask_checkboxoptionalbooleanInvert mask checkbox
"false"mixing_image_prompt_and_inpaintoptionalbooleanMixing image prompt and inpaint
"true"negative_promptoptionalstringPrompts to exclude, eg. bad anatomy, bad hands, missing fingers
pyracanny_cn_stopoptionalnumberControlnet stop value
0.5Range: 0 - 1.5pyracanny_cn_weightoptionalnumberControlnet weight value
1Range: 0 - 1.5pyracanny_imgoptionalstring (uri)Pyracanny image
sampleroptionalstringType of sampler
"dpmpp_2m_sde_gpu""euler""euler_ancestral""heun""heunpp2""dpm_2""dpm_2_ancestral""lms""dpm_fast""dpm_adaptive""dpmpp_2s_ancestral"+8 moresamplesoptionalintegerNumber images to generate.
1Range: 1 - 4scheduleroptionalstringType of scheduler.
"karras""normal""karras""exponential""sgm_uniform""simple""ddim_uniform"seedoptionalintegerSeed for image generation.
-1Range: -1 - 999999999999999stepsoptionalintegerNumber of denoising steps.
30Range: 20 - 100stylesoptionalstring[]Style selection
Fooocus V2optionalanyRandom StyleoptionalanyDefault (Slightly Cinematic)optionalanyFooocus EnhanceoptionalanyFooocus SharpoptionalanyFooocus MasterpieceoptionalanyFooocus PhotographoptionalanyFooocus NegativeoptionalanySAI 3D ModeloptionalanySAI AnimeoptionalanySAI CinematicoptionalanySAI Digital ArtoptionalanySAI Fantasy ArtoptionalanySAI IsometricoptionalanySAI LowpolyoptionalanySAI PhotographicoptionalanySAI Pixel ArtoptionalanySAI TextureoptionalanyMRE Cinematic DynamicoptionalanyMRE Dark DreamoptionalanyMRE Gloomy ArtoptionalanyMRE Surreal PaintingoptionalanyMRE Elemental ArtoptionalanyMRE Space ArtoptionalanyMRE Brave ArtoptionalanyMRE Heroic FantasyoptionalanyMRE Dark CyberpunkoptionalanyMRE MangaoptionalanyAds AdvertisingoptionalanyAds AutomotiveoptionalanyAds Fashion EditorialoptionalanyAds Food PhotographyoptionalanyArtstyle AbstractoptionalanyArtstyle CubistoptionalanyArtstyle ExpressionistoptionalanyArtstyle GraffitioptionalanyArtstyle HyperrealismoptionalanyArtstyle ImpressionistoptionalanyArtstyle PsychedelicoptionalanyArtstyle WatercoloroptionalanyFuturistic CyberneticoptionalanyFuturistic Sci FioptionalanyMisc DreamscapeoptionalanyMisc HorroroptionalanyResponse Type
Returns: Media File
Asynchronous requests (v2)
Use Async for video, long-running (>~60s), or high-concurrency workloads; Sync is simplest for fast image & LLM calls. Async submits a request and you poll it to completion.
- 1
POST /v2/focus-inpaintSubmit — returns request_id, status_url, response_url
- 2
GET /v2/requests/{id}/statusPoll — until COMPLETED or FAILED
- 3
GET /v2/requests/{id}Result — final response body
Status states
- A FAILED request is served as HTTP 422 — the body still carries the error detail.
- An unknown or expired request_id returns HTTP 404.
- Results are retained for 1 hour, then expire.
- Content / RAI blocks surface as FAILED, not a separate state.
- Track completion by polling the status endpoint.
Common Error Codes
The API returns standard HTTP status codes. Detailed error messages are provided in the response body.
Bad Request
Invalid parameters or request format
Unauthorized
Missing or invalid API key
Forbidden
Insufficient permissions
Not Found
Model or endpoint not found
Insufficient Credits
Not enough credits to process request
Rate Limited
Too many requests
Server Error
Internal server error
Bad Gateway
Service temporarily unavailable
Timeout
Request timed out