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": "gemini-3.1-flash-lite-image",
    "prompt": "赛博朋克风格的城市夜景，霓虹灯闪烁",
    "size": "16:9",
    "resolution": "1K",
    "n": 1
  }'

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

curl --request POST \
  --url https://api.apimart.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gemini-3.1-flash-lite-image",
    "prompt": "赛博朋克风格的城市夜景，霓虹灯闪烁",
    "size": "16:9",
    "resolution": "1K",
    "n": 1
  }'

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

​
Autorisierung

​
Authorization
string
erforderlich
Alle API-Endpunkte erfordern eine Authentifizierung per Bearer TokenAPI-Schlüssel erhalten:Besuchen Sie die Seite zur Verwaltung von API-Schlüsseln, um Ihren API-Schlüssel zu erhaltenFügen Sie ihn dem Anfrage-Header hinzu:
Authorization: Bearer YOUR_API_KEY

​
Body

​
model
string
Standard:"gemini-3.1-flash-lite-image"
erforderlich
Name des BildgenerierungsmodellsVerwenden Sie fest diesen Modellnamen: gemini-3.1-flash-lite-image (Nano Banana Lite)
Dieses Modell ist direkt an den offiziellen Gemini-Kanal angebunden, es gibt keine -official-Variante und der Fallback-Parameter official_fallback wird nicht unterstützt.
​
prompt
string
erforderlich
Textbeschreibung für die Bildgenerierung
​
size
string
Seitenverhältnis des BildesUnterstützte Seitenverhältnisse:
  • auto – Seitenverhältnis automatisch wählen
  • 1:1 – Quadrat, Avatare, soziale Medien
  • 3:2 / 2:3 – Standardfotos
  • 4:3 / 3:4 – Klassisches Bildschirmverhältnis
  • 16:9 / 9:16 – Breitbild / Cover für vertikale Videos
  • 5:4 / 4:5 – Bilder für Instagram
  • 21:9 – Ultrabreites Banner
Bei Text-zu-Bild ist der Standardwert 1:1 oder 16:9, wenn size auf auto gesetzt ist; bei Bild-zu-Bild richtet sich das Seitenverhältnis nach der Antwort der vorgelagerten Quelle. (Wir empfehlen, ein Seitenverhältnis explizit anzugeben.)
​
resolution
string
Standard:"1K"
Auflösung des AusgabebildesUnterstützte Werte:
  • 1K – ~1024px, Standardauflösung (Lite unterstützt nur diese Stufe)
Lite unterstützt nur 1K. Bei Übergabe von 2K / 4K / 0.5K erfolgt eine stille Herabstufung auf 1K, ohne Fehler und ohne tatsächliche Ausgabe in hoher Auflösung. Die Frontend-UI muss keine Auflösungsoption anzeigen.
​
n
integer
Standard:"1"
Anzahl der zu generierenden BilderWertebereich: 1 ~ 4, Standard 1Bei n>1 sendet das Backend mehrere gleichzeitige Anfragen an die vorgelagerte Quelle und rechnet nach der tatsächlichen Anzahl erfolgreich generierter Bilder ab. Wir empfehlen, im Frontend fest 1 zu übergeben (Fortschritt bildweise anzeigen, transparentere Abrechnung).⚠️ Hinweis: Es muss eine reine Zahl übergeben werden (z. B. 1), keine Anführungszeichen verwenden, sonst tritt ein Fehler auf
​
image_urls
array
Liste der URLs von Referenzbildern für die Bild-zu-Bild-GenerierungEs werden zwei Formate 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
  • Es muss das vollständige Data-URI-Format verwendet werden
  • Format: data:image/{format};base64,{base64data}
  • Unterstützte Bildformate: jpeg, png, webp
  • Beispiel: data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAYABg...
  • ⚠️ Hinweis: Das Präfix data:image/jpeg;base64, muss enthalten sein
Einschränkungen:
  • Maximal 14 Referenzbilder (empfohlen: bis zu 10 Objektreferenzen + 4 Charakterreferenzen)
  • Größe eines einzelnen Bildes: maximal 10 MB
  • Unterstützte Formate: jpeg, png, webp
​
webhook
string
Callback-Adresse der Aufgabe (base)Bei Erfolg / Fehlschlag der Aufgabe ruft diese Plattform webhook + /callback auf (kein Weiterleiten an die vorgelagerte Quelle). Die Übergabe dieses Parameters kann das Polling deutlich reduzieren; wir empfehlen dennoch, das Polling als Absicherung beizubehalten.
Wichtige Hinweise zur Nutzung von Lite
  • google_search / google_image_search werden nicht unterstützt: Lite verwendet den interactions-Endpunkt der Developer API, die vorgelagerte Quelle stellt das Search-Tool nicht bereit (gibt “Search as tool is not enabled for this model” zurück), und der Plattform-Adapter sendet diesen Parameter nicht weiter. Bei Übergabe tritt kein Fehler auf, das Bild wird wie gewohnt generiert, jedoch ohne jegliche Sucherweiterung. Wenn Sie eine Sucherweiterung benötigen, verwenden Sie stattdessen gemini-3.1-flash-image-preview.
  • mask_url für lokales Inpainting wird nicht unterstützt (die Gemini-Reihe arbeitet mit aspect ratio + Referenzbildern, nicht mit Masken).
  • Abrechnung nach Token (im Unterschied zum festen Preis pro Bild bei flash/pro): Input ca. 0.25/MillionToken,Bildausgabeca.0.25/Million Token, Bildausgabe ca. 30/Million Token, ein 1K-Bild ≈ 1120 output token ≈ $0.0336/Bild. Der tatsächliche Preis richtet sich nach der Multiplikator-Konfiguration im Backend.
  • Alle generierten Bilder enthalten Googles unsichtbares SynthID-Wasserzeichen (Verhalten der vorgelagerten Quelle, kann nicht deaktiviert werden).

​
Response

​
code
integer
Statuscode der Antwort
​
data
array
Array mit Antwortdaten