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-seedream-5-0-lite",
    "prompt": "A golden retriever playing in a garden, sunny day, high-definition photography style",
    "size": "16:9",
    "resolution": "2K",
    "n": 1
  }'

{
  "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-seedream-5-0-lite",
    "prompt": "A golden retriever playing in a garden, sunny day, high-definition photography style",
    "size": "16:9",
    "resolution": "2K",
    "n": 1
  }'

{
  "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-seedream-5-0-lite"
erforderlich
Name des BildgenerierungsmodellsUnterstützte Modelle: doubao-seedream-5-0-lite, doubao-seedream-5.0-lite, Doubao-Seedream-5.0-liteBeispiel: "doubao-seedream-5-0-lite"
​
prompt
string
erforderlich
Textbeschreibung für die Bildgenerierung
​
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
  • auto – Automatische Anpassung an das Referenzbild-Seitenverhältnis (erfordert image_urls)
Hinweis: Seedream-5.0-Lite unterstützt das Seitenverhältnis 9:21 nicht
​
resolution
string
Standard:"2K"
BildauflösungUnterstützte Auflösungen:
  • 2K – Standardauflösung (Standard)
  • 3K – Hochauflösend
  • 4K – Ultra-hochauflösend
Hinweis: Seedream-5.0-Lite unterstützt die Auflösungen 2K, 3K und 4K, 1K wird nicht unterstützt
Referenzgrößen für Auflösungen:
AuflösungGröße 1:1Größe 16:9
2K2048x20482848x1600
3K3072x30724096x2304
4K4096x40965504x3040
​
n
integer
Anzahl der zu generierenden BilderBereich: 1–15Standard: 1Hinweis:
  • Wenn n > 1, wird der sequenzielle Generierungsmodus automatisch aktiviert
  • 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 die Bild-zu-Bild-GenerierungZwei 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-Daten}
  • 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 pro Bild
  • Gesamtpixel: maximal 6000×6000 px
Die Anzahl der Referenzbilder in image_urls + die durch n angegebene endgültige Anzahl generierter Bilder muss ≤ 15 sein.
​
output_format
string
Standard:"jpeg"
Format des Ausgabebildes
  • jpeg: JPEG-Format (Standard)
  • png: PNG-Format, geeignet für transparente Hintergründe und ähnliche Anwendungsfälle
Hinweis: Der Parameter output_format ist exklusiv für Seedream-5.0-Lite. Andere Bildmodelle ignorieren diesen Parameter.
​
sequential_image_generation
string
Standard:"disabled"
Sequenzieller BildgenerierungsmodusSteuert, ob mehrere Bilder generiert werden:
  • disabled: Sequenziellen Modus deaktivieren (Standard)
  • auto: Sequenziellen Modus aktivieren, kann mehrere Bilder generieren
Nutzungshinweise:
  • Wenn n > 1, wird automatisch auf auto gesetzt
​
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
Beispiel:
"sequential_image_generation": "auto",
"sequential_image_generation_options": {
  "max_images": 4
}
​
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