Zum Hauptinhalt springen
POST
/
v1
/
images
/
generations
qwen-image-edit-plus Schnittstelle
curl --request POST \
  --url https://api.evolink.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "qwen-image-edit-plus",
  "prompt": "Replace the background of this image"
}
'
{
  "created": 1757156493,
  "id": "task-unified-1757156493-imcg5zqt",
  "model": "qwen-image-edit-plus",
  "object": "image.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 30
  },
  "type": "image",
  "usage": {
    "billing_rule": "per_call",
    "credits_reserved": 1,
    "user_group": "default"
  }
}

Autorisierungen

​
Authorization
string
header
erforderlich

##Alle APIs erfordern Bearer-Token-Authentifizierung##

API-Schlüssel erhalten:

Besuchen Sie die API-Schlüsselverwaltungsseite, um Ihren API-Schlüssel zu erhalten

Zum Anfrage-Header hinzufügen:

Authorization: Bearer YOUR_API_KEY

Body

application/json
​
model
enum<string>
Standard:qwen-image-edit-plus
erforderlich

Modellname

Verfügbare Optionen:
qwen-image-edit-plus
Beispiel:

"qwen-image-edit-plus"

​
prompt
string
erforderlich

Prompt, der das zu generierende Bild beschreibt oder wie das Eingabebild bearbeitet werden soll, begrenzt auf 2000 Token

Maximum string length: 2000
Beispiel:

"Replace the background of this image"

​
image_urls
string<uri>[]
erforderlich

Referenzbild-URL-Liste

Hinweis:

  • Maximale Anzahl von Eingabebildern pro Anfrage: 3 Bilder
  • Bildbreite und -höhe müssen im Bereich von [384-3072] Pixeln liegen
  • Unterstützte Dateiformate: .jpg, .jpeg, .png, .bmp, .webp, .tiff
  • Bild-URLs müssen direkt vom Server abrufbar sein oder die Bild-URL sollte beim Zugriff direkt heruntergeladen werden (typischerweise enden diese URLs mit Bilddateiendungen wie .png, .jpg)
Beispiel:
[
  "https://example.com/image1.png",
  "https://example.com/image2.png"
]
​
n
integer
Standard:1

Gibt die Anzahl der zu generierenden Bilder an, unterstützt jeden ganzzahligen Wert zwischen [1,6]

Hinweis:

  • Jede Anfrage wird basierend auf dem Wert von n vorbelastet, die tatsächliche Abrechnung basiert auf der Anzahl der generierten Bilder
Erforderlicher Bereich: 1 <= x <= 6
Beispiel:

1

​
negative_prompt
string

Negativer Prompt zur Beschreibung von Inhalten, die Sie nicht im Bild sehen möchten, wird zur Einschränkung der Ausgabe verwendet

Hinweis:

  • Unterstützt Chinesisch und Englisch, maximale Länge von 500 Zeichen, jedes chinesische Zeichen/jeder Buchstabe zählt als ein Zeichen, Überschuss wird automatisch abgeschnitten
Maximum string length: 500
Beispiel:

"low resolution, error, worst quality, low quality, mutilated, extra fingers, bad proportions"

​
size
string

Größe des generierten Bildes, unterstützt Pixel-Format:

  • Breite x Höhe, wie z.B.: 1024x1024, 1024x1536, 1536x1024 und andere Werte innerhalb des Bereichs
  • Breiten- und Höhenbereich: [512, 2048] Pixel
  • Wenn nicht festgelegt, behält das Ausgabebild ein Seitenverhältnis ähnlich dem Originalbild bei, nahe der 1024x1024 Auflösung

Hinweis:

  • Dieser Parameter ist nur verfügbar, wenn die Anzahl der Ausgabebilder n gleich 1 ist, andernfalls wird ein Fehler zurückgegeben
Beispiel:

"1024x1024"

​
prompt_extend
boolean
Standard:true

Ob die intelligente Prompt-Umschreibung aktiviert werden soll. Bei Aktivierung wird ein großes Modell zur Optimierung des positiven Prompts verwendet, was die Ergebnisse für einfache oder unzureichend beschreibende Prompts erheblich verbessert. Standardwert ist true

Beispiel:

true

​
watermark
boolean
Standard:false

Ob ein "Qwen-Image"-Wasserzeichen in der unteren rechten Ecke des Bildes hinzugefügt werden soll. Standardwert ist false

Beispiel:

false

​
seed
integer

Zufalls-Seed, Bereich [0, 2147483647], die Verwendung desselben Seed-Werts kann den generierten Inhalt relativ stabil halten

Hinweis:

  • Wenn nicht angegeben, verwendet der Algorithmus automatisch einen zufälligen Seed
  • Der Modellgenerierungsprozess ist probabilistisch, selbst mit demselben Seed können die Ergebnisse nicht garantiert jedes Mal vollständig identisch sein
Erforderlicher Bereich: 0 <= x <= 2147483647
Beispiel:

12345

​
callback_url
string<uri>

HTTPS-Callback-Adresse nach Aufgabenabschluss

Callback-Zeitpunkt:

  • Wird ausgelöst, wenn die Aufgabe abgeschlossen, fehlgeschlagen oder abgebrochen wurde
  • Wird nach Abschluss der Abrechnungsbestätigung gesendet

Sicherheitsbeschränkungen:

  • Nur HTTPS-Protokoll wird unterstützt
  • Callback an interne IP-Adressen ist verboten (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x, usw.)
  • URL-Länge darf 2048 Zeichen nicht überschreiten

Callback-Mechanismus:

  • Timeout: 10 Sekunden
  • Maximal 3 Wiederholungsversuche bei Fehler (Wiederholung nach 1 Sekunde/2 Sekunden/4 Sekunden)
  • Das Format des Callback-Antwortkörpers entspricht dem Antwortformat der Aufgabenabfrage-API
  • Ein 2xx-Statuscode der Callback-Adresse gilt als erfolgreich, andere Statuscodes lösen eine Wiederholung aus
Beispiel:

"https://your-domain.com/webhooks/image-task-completed"

Antwort

Bildaufgabe erfolgreich erstellt

​
created
integer

Zeitstempel der Aufgabenerstellung

Beispiel:

1757156493

​
id
string

Aufgaben-ID

Beispiel:

"task-unified-1757156493-imcg5zqt"

​
model
string

Tatsächlich verwendeter Modellname

Beispiel:

"qwen-image-edit-plus"

​
object
enum<string>

Spezifischer Aufgabentyp

Verfügbare Optionen:
image.generation.task
​
progress
integer

Aufgabenfortschritt in Prozent (0-100)

Erforderlicher Bereich: 0 <= x <= 100
Beispiel:

0

​
status
enum<string>

Aufgabenstatus

Verfügbare Optionen:
pending,
processing,
completed,
failed
Beispiel:

"pending"

​
task_info
object

Asynchrone Aufgabeninformationen

​
type
enum<string>

Aufgaben-Ausgabetyp

Verfügbare Optionen:
text,
image,
audio,
video
Beispiel:

"image"

​
usage
object

Nutzungs- und Abrechnungsinformationen