Zum Hauptinhalt springen
POST
/
v1
/
images
/
generations
curl --request POST \
  --url https://api.apimart.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "qwen-image-2.0",
    "prompt": "A cute orange cat napping in the sunshine"
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01JGXYZ1234567890ABCDEF"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.apimart.ai/llms.txt

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

curl --request POST \
  --url https://api.apimart.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "qwen-image-2.0",
    "prompt": "A cute orange cat napping in the sunshine"
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01JGXYZ1234567890ABCDEF"
    }
  ]
}

​
Unterstützte Modelle

ModellBeschreibungMax. BilderPreis
qwen-image-2.0Standardversion, ausgewogene Qualität und Leistung6Festpreis
qwen-image-2.0-proPro-Version, stärkere Textwiedergabe, feinere realistische Texturen6Festpreis

​
Autorisierung

​
Authorization
string
erforderlich
Alle Endpunkte erfordern eine Bearer-Token-AuthentifizierungAPI-Key abrufen:Besuchen Sie die API-Key-Verwaltung, um Ihren API-Key zu erhaltenZum Request-Header hinzufügen:
Authorization: Bearer YOUR_API_KEY

​
Body

​
model
string
erforderlich
Modellname
  • qwen-image-2.0 – Standardversion, ausgewogene Qualität und Leistung
  • qwen-image-2.0-pro – Pro-Version, stärkere Textwiedergabe, feinere realistische Texturen
​
prompt
string
erforderlich
Textbeschreibung für die Bildgenerierung, bis zu 800 Zeichen
​
size
string
Standard:"1:1"
Seitenverhältnis des BildesUnterstützte Seitenverhältnisse:
  • 1:1 – Quadrat (Standard)
  • 4:3 – Querformat 4:3
  • 3:4 – Hochformat 3:4
  • 16:9 – Querformat Breitbild
  • 9:16 – Hochformat vertikal
  • 3:2 – Querformat 3:2
  • 2:3 – Hochformat 2:3
​
resolution
string
Standard:"1K"
Auflösungsstufe
  • 1K – Standardauflösung (Standard)
  • 2K – Hochauflösend
​
n
integer
Standard:"1"
Anzahl der zu generierenden BilderBereich: 1–6
​
negative_prompt
string
Negativer Prompt (Inhalt, der nicht erscheinen soll), bis zu 500 Zeichen
​
image_urls
array
Array von Referenzbild-URLs (Bild-zu-Bild-Modus)Einschränkungen:
  • Müssen öffentlich zugängliche URLs sein
  • Base64-Format wird nicht unterstützt

​
Auflösungs-Referenztabelle

Die Ausgabegröße wird durch die Kombination von size (Verhältnis) + resolution (Auflösungsstufe) gesteuert.
VerhältnisStufe 1KStufe 2K
1:11024×10242048×2048
4:31152×8642048×1536
3:4864×11521536×2048
16:91280×7202048×1152
9:16720×12801152×2048
3:21248×8322048×1360
2:3832×12481360×2048
  • Nur size → standardmäßig Stufe 1K: {"size": "16:9"} → 1280×720
  • size + resolution → angegebene Stufe: {"size": "16:9", "resolution": "2K"} → 2048×1152

​
Anwendungsbeispiele

Text-zu-Bild (minimale Anfrage) 
{
  "model": "qwen-image-2.0",
  "prompt": "A cute orange cat napping in the sunshine"
}
Verhältnis und Anzahl angeben 
{
  "model": "qwen-image-2.0-pro",
  "prompt": "Cyberpunk-style futuristic city nightscape with flickering neon lights",
  "size": "16:9",
  "n": 4
}
Hochauflösende 2K-Stufe 
{
  "model": "qwen-image-2.0-pro",
  "prompt": "Exquisite food photography, sushi platter",
  "size": "4:3",
  "resolution": "2K",
  "n": 2
}
Bild-zu-Bild (Referenzbild + Textbeschreibung) 
{
  "model": "qwen-image-2.0",
  "prompt": "Change the background to a seaside sunset",
  "image_urls": ["https://example.com/my-photo.jpg"]
}

​
Response

​
code
integer
Antwort-Statuscode
​
data
array
Antwortdaten-Array

​
Hinweise

  1. Asynchrone Verarbeitung: Nach dem Senden wird eine task_id zurückgegeben. Fragen Sie /v1/tasks/{task_id} ab, um die Ergebnisse zu erhalten
  2. Bildspeicherung: Generierte Bilder werden auf das Plattform-CDN gespiegelt und sind langfristig gültig
  3. Abrechnungsregeln: Abrechnung pro erfolgreich generiertem Bild, keine Gebühr bei Fehlern
  4. Anforderungen an Bild-URLs: Eingabebilder müssen öffentlich zugängliche URLs sein, base64 wird nicht unterstützt