Qwen Image 2.1: Text-zu-Bild und Bildbearbeitung auf Models and API | RunComfy

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/qwen/qwen-image-2.1/edit \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "image_urls": [
      "https://playgrounds-storage-public.runcomfy.net/tools/7461/media-files/output-example1-4.webp"
    ],
    "prompt": "Change the background to a warm golden-hour studio and add soft rim lighting, keep the subject and clothing unchanged."
  }'

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/status \
  --header "Authorization: Bearer <token>"

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/result \
  --header "Authorization: Bearer <token>"

curl --request POST \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/cancel \
  --header "Authorization: Bearer <token>"

{
  "type": "object",
  "title": "Eingabeschema",
  "required": [
    "image_urls",
    "prompt"
  ],
  "properties": {
    "image_urls": {
      "title": "Eingabebild(er)",
      "description": "Ein bis zehn Referenzbilder. Die Reihenfolge entspricht dem Prompt (das erste Bild, das zweite Bild). JPEG, PNG oder WebP; jede Datei bis zu 30MB und 25MP. Halten Sie sich auf vier oder weniger, wenn die Identität scharf bleiben muss.",
      "type": "array",
      "items": {
        "type": "string",
        "format": "image_uri"
      },
      "minItems": 1,
      "maxItems": 10,
      "validations": [
        {
          "validation_rule": "file_size_mb<",
          "validation_value": 30,
          "validation_error": "File size must be less than 30 MB."
        }
      ],
      "default": [
        "https://playgrounds-storage-public.runcomfy.net/tools/7461/media-files/output-example1-4.webp"
      ]
    },
    "prompt": {
      "title": "Bearbeitungsanweisung",
      "description": "Beschreiben Sie die Änderung in einfacher Sprache: was hinzugefügt, entfernt, umgestaltet oder ersetzt werden soll. Zitieren Sie jeden Text, um ihn wörtlich wiederzugeben. Beschreiben Sie mit einer Maske, was im weißen Bereich erscheinen soll.",
      "type": "string",
      "default": "Change the background to a warm golden-hour studio and add soft rim lighting, keep the subject and clothing unchanged."
    },
    "mask_url": {
      "title": "Maskenbild",
      "description": "Optionale Schwarz-Weiß-Maske für lokale Bearbeitung. Weiß markiert den zu ändernden Bereich; Schwarz bleibt unverändert. Benötigt genau ein Referenzbild, kann nicht mit einem transparenten Hintergrund kombiniert werden und ignoriert das Seitenverhältnis sowie die Prompt-Neuschreibung.",
      "type": "string"
    },
    "aspect_ratio": {
      "title": "Seitenverhältnis (B:H)",
      "description": "Ausgabe-Seitenverhältnis. Auto verwendet die erste Referenz. Im Maskenmodus ignoriert.",
      "type": "string",
      "enum": [
        "auto",
        "1:1",
        "4:3",
        "3:4",
        "3:2",
        "2:3",
        "16:9",
        "9:16",
        "21:9",
        "9:21"
      ],
      "default": "auto"
    },
    "resolution": {
      "title": "Auflösung",
      "description": "Ausgabedetailebene. 1K ist schneller; 2K hat etwa viermal so viele Pixel und kostet mehr.",
      "type": "string",
      "enum": [
        "1K",
        "2K"
      ],
      "default": "1K"
    },
    "background": {
      "title": "Hintergrund",
      "description": "undurchsichtig für ein normales Foto. transparent schreibt einen echten Alphakanal — beschreibe nur das Motiv und verwende JPEG nicht. Kann nicht mit einer Maske kombiniert werden.",
      "type": "string",
      "enum": [
        "opaque",
        "transparent"
      ],
      "default": "opaque"
    },
    "output_format": {
      "title": "Ausgabeformat",
      "description": "PNG und WebP können einen Alphakanal enthalten. JPEG kann dies nicht, daher kann es nicht mit einem transparenten Hintergrund kombiniert werden.",
      "type": "string",
      "enum": [
        "png",
        "webp",
        "jpeg"
      ],
      "default": "png"
    },
    "enhance_prompt": {
      "title": "Prompt verbessern",
      "description": "Schreibe eine kurze Anweisung in eine ausführlichere Szene um, bevor du sie bearbeitest. Schalte aus, wenn die Anweisung bereits genau ist. Im Maskenmodus ignoriert.",
      "type": "boolean",
      "default": true
    },
    "seed": {
      "title": "Seed",
      "description": "Zufallssamen für Reproduzierbarkeit. Verwenden Sie -1 für einen zufälligen Samen bei jedem Lauf.",
      "type": "integer",
      "default": -1
    }
  }
}