Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.runflow.io/llms.txt

Use this file to discover all available pages before exploring further.

Pricing: $0.03/megapixel. Endpoint: POST /v1/models/alibaba/qwen-image-edit-2511/runs.
Advanced image editing model from Alibaba. Qwen Image Edit 2511 delivers superior text editing capabilities, multi-image support, and precise visual modifications through natural language instructions. Supports style transfer, object editing, and creative compositions.

​
Overview

​
Pricing

  • Base price: $0.03/megapixel
  • Note: Default price

​
Qwen Image Edit 2511 API

Endpoint: POST /v1/models/alibaba/qwen-image-edit-2511/runs

​
Run the model

​
Python

import requests

response = requests.post(
    "https://api.runflow.io/v1/models/alibaba/qwen-image-edit-2511/runs",
    headers={"Authorization": "Bearer RUNFLOW_API_KEY"},
    json={
        "input": {
            "prompt": "Move this person to a Mars colony habitat...",
            "image_urls": [
                "https://public.runflow.io/images/models/_shared/base-engineer.png"
            ]
        },
        "callback_url": "https://your-server.com/webhook"
    },
)

data = response.json()
print(data)

​
Node.js

const response = await fetch(
  "https://api.runflow.io/v1/models/alibaba/qwen-image-edit-2511/runs",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer RUNFLOW_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
        "input": {
            "prompt": "Move this person to a Mars colony habitat...",
            "image_urls": [
                "https://public.runflow.io/images/models/_shared/base-engineer.png"
            ]
        },
        "callback_url": "https://your-server.com/webhook"
    }),
  }
);

const data = await response.json();
console.log(data);

​
cURL

curl -X POST https://api.runflow.io/v1/models/alibaba/qwen-image-edit-2511/runs \
  -H "Authorization: Bearer $RUNFLOW_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
    "input": {
        "prompt": "Move this person to a Mars colony habitat...",
        "image_urls": [
            "https://public.runflow.io/images/models/_shared/base-engineer.png"
        ]
    },
    "callback_url": "https://your-server.com/webhook"
}
JSON

​
Request parameters

ParameterTypeRequiredDescription
inputobjectrequiredModel input parameters. See “Input schema” below.
callback_urlstring | nulloptionalWebhook URL - POSTed when the run reaches a terminal state.
metadataobject | nulloptionalArbitrary key-value pairs attached to the run.

​
Input schema

FieldTypeRequiredAllowed valuesDescription
promptstringrequiredAnyThe prompt to edit the image with.
num_imagesintegeroptionalAnyThe number of images to generate.
accelerationstringoptionalnone, regular, highThe acceleration level to use.
image_sizestringoptionalAnyThe size of the generated image. If None, uses the input image dimensions.
enable_safety_checkerbooleanoptionalAnyIf set to true, the safety checker will be enabled.
output_formatstringoptionaljpeg, png, webpThe format of the generated image.
sync_modebooleanoptionalAnyIf True, the media will be returned as a data URI.
guidance_scalefloatoptionalAnyThe guidance scale to use for the image generation.
seedintegeroptionalAnyThe same seed and the same prompt given to the same version of the model will output the same image every time.
image_urlsimage_listrequiredAnyThe URLs of the images to edit.
negative_promptstringoptionalAnyThe negative prompt to generate an image from.
num_inference_stepsintegeroptionalAnyThe number of inference steps to perform.

​
Output schema

FieldTypeDescription
outputsjsonUnified output array - one entry per generated artifact with url/type/width/height/duration/etc.
seedjsonSeed of the generated Image. It will be the same value of the one passed in the input or the randomly generated that was used in case none was passed.
model_datajsonModel-specific extra fields (prompt, description, actual_prompt, masks, etc.) keyed by field name.
nsfw_detectedjsontrue if the provider flagged output as NSFW, false if cleared, null if not checked.
timingjsonProvider timing info (inference_ms etc.), or null.

​
Callback payload

When you provide a callback_url, Runflow POSTs to it once the run reaches a terminal state.
FieldTypeDescription
eventstringEvent type: “run.completed”, “run.failed”, or “run.cancelled”.
run_idstringThe unique identifier of the run.
statusstringTerminal status: “succeeded”, “failed”, or “cancelled”.
outputobject | nullThe run output. Null if the run failed or was cancelled.
duration_msnumber | nullTotal run duration in milliseconds.
created_atstring | nullISO 8601 timestamp when the run was created.
completed_atstring | nullISO 8601 timestamp when the run reached terminal state.
metadataobject | nullThe metadata object passed at run creation, if any.
  • Retries: 3 attempts with exponential backoff (1s, 2s). Retries on 5xx / network errors only.
  • Headers: Runflow-Request-Id is always sent. Runflow-Signature is sent if a signing secret is configured.

​
Additional Resources

Browse all models

Browse the catalog.

Run lifecycle

Callbacks, polling, statuses.

Callbacks

Handle async results.

Pricing

How requests bill out.