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": "z-image-turbo",
    "prompt": "Ink painting style landscape scenery"
  }'

{
  "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": "z-image-turbo",
    "prompt": "Ink painting style landscape scenery"
  }'

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

​
Unterstützte Modelle

ModellBeschreibungBilder pro AnfragePreis
z-image-turboLeichte und schnelle Bildgenerierung, unterstützt Chinesisch und EnglischFest 1 BildFestpreis

​
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
  • z-image-turbo – Leichte und schnelle Bildgenerierung, unterstützt Chinesisch und Englisch
​
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
​
prompt_extend
boolean
Standard:"false"
Intelligente Prompt-UmschreibungWenn aktiviert, optimiert die KI den Prompt automatisch für bessere Ergebnisse, wobei die Kosten steigen.
  • false – Deaktiviert (Standard)
  • true – Aktiviert

​
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

​
Anwendungsbeispiele

Einfaches Text-zu-Bild (minimale Anfrage) 
{
  "model": "z-image-turbo",
  "prompt": "Ink painting style landscape scenery"
}
Verhältnis und Auflösung angeben 
{
  "model": "z-image-turbo",
  "prompt": "Minimalist style cafe interior design",
  "size": "16:9",
  "resolution": "2K"
}
Intelligente Prompt-Umschreibung aktivieren 
{
  "model": "z-image-turbo",
  "prompt": "A cat",
  "prompt_extend": true
}

​
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. Feste Anzahl: Z-Image-Turbo generiert genau 1 Bild pro Anfrage, der Parameter n wird nicht unterstützt