Skip to content

Boogu Image · Edit

Integrate

Model id boogu-image/edit
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/boogu-image/edit?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "image": "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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

This request: ≈$0.08 80 API credits Run it on this page

Get API key
Open model Image Editing

Instruction-based image editing from an input image, with separate text and image guidance strengths

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.

•required

Image transformation instructions written in either of Boogu-Image's supported languages, English or Chinese.

•required image_url
Drop a file, or

URL pointing to the image that will be edited.

image_size

Edited-image dimensions, defaulting to dimensions that preserve the input's proportions and stay within the model's native limit of 2K.

num_images default 1

Count of edited images to produce.

Advanced negative_prompt · output_format · num_inference_steps · guidance_scale · image_guidance_scale · cfg_range_start · cfg_range_end · seed · enable_safety_checker
default

Content to exclude from the edited image through classifier-free guidance. An empty value turns off negative text guidance.

output_format default jpeg

File format for the resulting image.

default 30

Count of denoising iterations to run.

default 4

Text guidance strength for editing: increase it to make the edit adhere more closely to the instruction.

default 1

Reference-image guidance strength, with stronger preservation of the input at higher settings and no image CFG at 1.0.

default 0

Starting point, expressed as a timestep fraction, for applying CFG.

default 1

Ending point, expressed as a timestep fraction, for applying CFG.

Seed for repeatable image generation: an image can be reproduced exactly by reusing its seed alongside the original prompt, input image, and model version.

POST /run/boogu-image/edit?wait=20 quote → $0.08
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/boogu-image/edit?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "image": "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.com/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 Boogu Image · Edit

Edits the image at `image_url` according to a text `prompt` written in English or Chinese. If `image_size` is omitted, the output follows the input aspect ratio within the 2K native limit. `guidance_scale` controls prompt adherence, while `image_guidance_scale` (1 to 8) preserves more of the input as it increases. Returns 1 to 4 edited images as jpeg or png.

Parameters

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

NameType DefaultAllowed Description
promptrequired
Typestring
Image transformation instructions written in either of Boogu-Image's supported languages, English or Chinese.
image_urlrequired image
Typeurl · image
URL pointing to the image that will be edited.
negative_promptoptional
Typestring
Default
Content to exclude from the edited image through classifier-free guidance. An empty value turns off negative text guidance.
image_sizeoptional
Typeobject
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Edited-image dimensions, defaulting to dimensions that preserve the input's proportions and stay within the model's native limit of 2K.
num_inference_stepsoptional
Typeinteger
Default30
20 – 50
Count of denoising iterations to run.
guidance_scaleoptional
Typenumber
Default4
1 – 8
Text guidance strength for editing: increase it to make the edit adhere more closely to the instruction.
image_guidance_scaleoptional
Typenumber
Default1
1 – 8
Reference-image guidance strength, with stronger preservation of the input at higher settings and no image CFG at 1.0.
cfg_range_startoptional
Typenumber
Default0
0 – 1
Starting point, expressed as a timestep fraction, for applying CFG.
cfg_range_endoptional
Typenumber
Default1
0 – 1
Ending point, expressed as a timestep fraction, for applying CFG.
num_imagesoptional num_outputs
Typeinteger
Default1
1 – 4
Count of edited images to produce.
seedoptional
Typeinteger | null
Seed for repeatable image generation: an image can be reproduced exactly by reusing its seed alongside the original prompt, input image, and model version.
enable_safety_checkeroptional
Typeboolean
Defaulttrue
Safety-check control covering input images as well as generated images; only authorized accounts may disable checking, and all other requests are checked regardless of this setting. A true value enables checking, with unsafe images replaced by black images.
output_formatoptional
Typeenum
Defaultjpeg
jpegpng
File format for the resulting image.
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": "boogu-image/edit",
  "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": 80,
    "usd": "0.08",
    "charged": 80,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "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",
        "width": 1024,
        "height": 768,
        "content_type": "image/jpeg"
      }
    ],
    "timings": {},
    "seed": 42,
    "has_nsfw_concepts": [
      false
    ],
    "prompt": "string"
  },
  "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.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/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, width, height, content_type}Images produced by the model.
timings
object
seed
integerImage-generation seed, including the randomly chosen value if the input omitted a seed; otherwise, it repeats the supplied value.
has_nsfw_concepts
array of booleanIndicates whether NSFW concepts appear in the generated images.
prompt
stringPrompt used during image generation.

More models: Image Editing

For AI agents: this page as Markdown is at https://doitong.com/developers/models/boogu-image/edit.md. All models and guides: https://doitong.com/developers/llms.txt