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": "doubao-seedance-4-0",
    "prompt": "A cute panda playing in a bamboo forest",
    "size": "1:1",
    "resolution": "2K",
    "n": 1,
    "image_urls": [
      "https://cdn.apimart.ai/doc/1761215838466614297_9852.png"
    ]
  }'

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

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": "doubao-seedance-4-0",
    "prompt": "A cute panda playing in a bamboo forest",
    "size": "1:1",
    "resolution": "2K",
    "n": 1,
    "image_urls": [
      "https://cdn.apimart.ai/doc/1761215838466614297_9852.png"
    ]
  }'

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

​
Autorisierung

​
Authorization
string
erforderlich
Alle API-Endpunkte erfordern eine Bearer-Token-AuthentifizierungAPI-Key abrufen:Besuchen Sie die API-Key-Verwaltungsseite, um Ihren API-Key zu erhaltenFügen Sie ihn dem Request-Header hinzu:
Authorization: Bearer YOUR_API_KEY

​
Body

​
model
string
Standard:"doubao-seedance-4-0"
erforderlich
Name des BildgenerierungsmodellsUnterstützte Modelle: doubao-seedance-4-0, doubao-seedream-4.0, doubao-seedream-4-0, Doubao-Seedream-4.0Beispiel: "doubao-seedance-4-0"
​
prompt
string
erforderlich
Textbeschreibung für die BildgenerierungMaximal 1000 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
  • 21:9 – Ultrabreit
  • 9:21 – Ultrahoch
  • auto – Automatische Anpassung an das Referenzbild-Seitenverhältnis (erfordert image_urls)
​
resolution
string
Standard:"2K"
BildauflösungUnterstützte Auflösungen:
  • 1K – Basisauflösung
  • 2K – Standardauflösung (Standard)
  • 4K – Hochauflösend
Referenzgrößen für Auflösungen:
AuflösungGröße 1:1Größe 16:9
1K1024x10241280x720
2K2048x20482560x1440
4K4096x40965404x3040
​
n
integer
Anzahl der zu generierenden BilderBereich: 1–15 (Minimum 1, Maximum 15)Standard: 1Hinweis:
  • Geben Sie eine einfache Zahl ein (z. B. 1), verwenden Sie keine Anführungszeichen, da dies sonst zu einem Fehler führt
Die Gebühren werden im Voraus auf Basis der Anzahl abgebucht
Die Anzahl der Referenzbilder in image_urls + die durch n angegebene endgültige Anzahl generierter Bilder muss ≤ 15 sein.
​
image_urls
array
Liste der Referenzbild-URLs für Bild-zu-Bild oder BildbearbeitungZwei Formate werden unterstützt:1. Vollständige Bild-URL
  • Öffentlich zugängliche Bild-URL (http:// oder https://)
  • Beispiel: https://example.com/image.jpg
2. Base64-kodiertes Format
  • Muss das vollständige Data-URI-Format verwenden
  • Format: data:image/{format};base64,{base64-data}
  • Unterstützte Bildformate: jpeg, png
  • Beispiel: data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAYABg...
  • Hinweis: Der Präfix data:image/jpeg;base64, ist erforderlich
Einschränkungen:
  • Bildformate: jpeg, png
  • Seitenverhältnis (Breite/Höhe): [1/3, 3]
  • Breite und Höhe (px) > 14
  • Größe: maximal 10 MB
  • Gesamtpixel: maximal 6000×6000 px
Die Anzahl der Referenzbilder in image_urls + die durch n angegebene endgültige Anzahl generierter Bilder muss ≤ 15 sein.
​
optimize_prompt_options
string
Standard:"standard"
Modus zur Prompt-Optimierung
  • standard: Standardmodus, erzeugt hochwertigere Inhalte mit längerer Verarbeitungszeit
  • fast: Schnellmodus, erzeugt Inhalte in kürzerer Zeit mit normaler Qualität
Standard: standard
​
sequential_image_generation
string
Standard:"disabled"
Sequenzieller Bildgenerierungsmodus (Doubao-spezifische Funktion)Steuert, ob mehrere Bilder generiert werden:
  • disabled: Sequenziellen Modus deaktivieren, generiert auch bei mehreren Referenzbildern nur 1 Bild (Standard)
  • auto: Sequenziellen Modus aktivieren, kann mehrere Bilder generieren
Nutzungshinweise:
  • image_urls muss angegeben werden – mindestens 1 Referenzbild erforderlich
  • Setzen Sie n: 3 oder verwenden Sie sequential_image_generation: "auto" + max_images: 3
  • Dadurch werden 3 verschiedene Bilder basierend auf Referenzbildern generiert
  • Wenn n > 1, wird automatisch auf auto gesetzt
Einschränkungen:
  • Reines Text-zu-Bild (ohne image_urls) kann keine mehreren Bilder generieren – dies ist eine Einschränkung der Doubao-API
​
sequential_image_generation_options
object
Optionen für die sequenzielle BildgenerierungVerfügbar, wenn sequential_image_generation auf auto gesetzt istEigenschaften:
  • max_images (integer): Anzahl der zu generierenden Bilder, Bereich: 1–15
Beispiel:
"sequential_image_generation": "auto",
"sequential_image_generation_options": {
  "max_images": 3
}
​
watermark
boolean
Standard:"false"
Ob ein Wasserzeichen zum generierten Bild hinzugefügt werden soll
  • true: Wasserzeichen hinzufügen
  • false: Kein Wasserzeichen (Standard)

​
Response

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