Skip to content

Firered Image Edit

Integrate

Model id firered-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/firered-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",
    "images": [
      "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.033 33 API credits Run it on this page

Get API key
Xiaohongshu Image Editing #image-editing#firered

Instruction-based image editor that accepts several reference images and English or Chinese prompts

Xiaohongshu · 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-editing request written in English or Chinese, specifying the changes to apply.

•required image_urls
Drop a file, or

Supply image URLs for either editing one image or using several images as references. Reference-based tasks include virtual try-on and transferring a reference image's style.

image_size

Image dimensions, with None retaining the input dimensions instead of specifying a new output size.

num_images default 1

Image count requested for generation.

Advanced negative_prompt · output_format · acceleration · num_inference_steps · guidance_scale · seed · enable_safety_checker
default

Negative prompt used during generation.

output_format default png

File format for the resulting image.

acceleration default regular

Acceleration setting for optimizing inference speed.

default 30

Inference step count, which can be increased to obtain generally better-quality results.

default 4

Prompt adherence controlled through classifier-free guidance: raising this scale makes generation conform more closely to the prompt.

Seed for reproducible images: an identical prompt and seed produce an identical image when the model version is unchanged.

POST /run/firered-image-edit?wait=20 quote → $0.033
# 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/firered-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",
    "images": [
      "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 Firered Image Edit

Edits one or more images from a written instruction in `prompt`, in English or Chinese. `image_urls` can hold several references for tasks like virtual try-on or style transfer. You can set `num_images` from 1 to 4, `num_inference_steps` from 2 to 50, `guidance_scale` from 1 to 10, and output as png or jpeg.

Parameters

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

NameType DefaultAllowed Description
promptrequired
Typestring
Image-editing request written in English or Chinese, specifying the changes to apply.
image_sizeoptional
Typeobject
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Image dimensions, with None retaining the input dimensions instead of specifying a new output size.
num_inference_stepsoptional
Typeinteger
Default30
2 – 50
Inference step count, which can be increased to obtain generally better-quality results.
seedoptional
Typeinteger | null
Seed for reproducible images: an identical prompt and seed produce an identical image when the model version is unchanged.
guidance_scaleoptional
Typenumber
Default4
1 – 10
Prompt adherence controlled through classifier-free guidance: raising this scale makes generation conform more closely to the prompt.
num_imagesoptional num_outputs
Typeinteger
Default1
1 – 4
Image count requested for generation.
enable_safety_checkeroptional
Typeboolean
Defaulttrue
Safety checking, which returns black images in place of any images flagged unsafe. A value of true enables checking; false disables it only for authorized accounts, while requests without authorization are checked regardless.
output_formatoptional
Typeenum
Defaultpng
jpegpng
File format for the resulting image.
image_urlsrequired images
Typeurl[] · image
Supply image URLs for either editing one image or using several images as references. Reference-based tasks include virtual try-on and transferring a reference image's style.
negative_promptoptional
Typestring
Default
Negative prompt used during generation.
accelerationoptional
Typeenum
Defaultregular
noneregularhigh
Acceleration setting for optimizing inference speed.
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": "firered-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": 33,
    "usd": "0.033",
    "charged": 33,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "image_urls": [
      "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}File information for the resulting edited images.
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.

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