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:
  • Die tatsächliche Anzahl der generierbaren Bilder wird sowohl von diesem Parameter als auch von der Anzahl der eingegebenen Referenzbilder beeinflusst. Die Summe aus Referenzbildern und generierten Bildern muss ≤ 15 sein
  • 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
​
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:
  • Maximal 10 Bilder
  • 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
​
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