Nano Banana 2
Nano Banana 2 (Gemini 3.1 Flash Image Preview) asynchronous image generation and editing with up to 4K output, 14 reference images, and optional Google Search enhancement.
Preis
$0.0132/ Aufruf
Endpunkt
/images/tasks
Auslieferungsmuster
Lebenszyklus asynchroner Tasks
Verfügbarkeit
Jetzt verfügbar
API-Dokumentation
Anfrage erstellen und kopieren
Wählen Sie die Optionen, die dieses Modell akzeptiert. Der Code unten aktualisiert sich mit Ihrer Auswahl.
https://www.aisplice.store/v1/images/tasksBearer API keyAsynchroner TaskOptionenEs werden nur Optionen angezeigt, die für dieses Modell veröffentlicht sind.
# Requires curl and jq
API_KEY="${API_KEY:-YOUR_API_KEY}"
# 1. Submit once
SUBMITTED=$(curl --fail-with-body -sS https://www.aisplice.store/v1/images/tasks \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: model-docs-$(date +%s)-$$" \\
-d '{
"model": "Nano Banana 2",
"prompt": "A cinematic scene with careful composition",
"size": "auto",
"resolution": "1K",
"n": 1
}')
TASK_ID=$(printf '%s' "$SUBMITTED" | jq -r '.task_id // .id // empty')
if [ -z "$TASK_ID" ]; then
printf '%s\n' "$SUBMITTED" >&2
exit 1
fi
echo "task_id=$TASK_ID"
# 2. Poll until terminal
while true; do
STATUS_JSON=$(curl --fail-with-body -sS \
"https://www.aisplice.store/v1/images/tasks/$TASK_ID" \
-H "Authorization: Bearer $API_KEY")
STATUS=$(printf '%s' "$STATUS_JSON" | jq -r '.status // empty' | tr '[:upper:]' '[:lower:]')
echo "status=$STATUS"
case "$STATUS" in
completed|succeeded|success) break ;;
failed|failure|cancelled|canceled)
printf '%s\n' "$STATUS_JSON" | jq .
exit 1
;;
esac
sleep 3
done
# 3. Fetch the final result
curl --fail-with-body -sS \
"https://www.aisplice.store/v1/images/tasks/$TASK_ID/content" \
-H "Authorization: Bearer $API_KEY" | jq .- 1Task einreichen
- 2Status abfragen
- 3Inhalt abrufen
Für den Produktivbetrieb werden öffentliche Medien-URLs empfohlen. Laden Sie zuerst eine lokale Datei hoch und setzen Sie dann public_url in die Modellanfrage. Vermeiden Sie große Base64-Bodys.
Upload-Leitfaden lesenParameterreferenz
modelExakte Modellkennung für diese Anfrage.
gemini-3.1-flash-image-previewpromptAnweisung, die das gewünschte Ergebnis beschreibt.
sizeSeitenverhältnis oder Abmessungen der Ausgabe.
auto1:12:33:23:44:34:55:49:1616:921:91:44:11:88:1resolutionAngeforderte Ausgabeauflösung.
0.5K1K2K4KnimagesOptional reference images, up to 14.
Ablauf der Antwort
Task-Status, Endzustände und Beispiele für Ergebnisantworten.
Ablauf der Antwort
Task-Status, Endzustände und Beispiele für Ergebnisantworten.
{
"id": "task_xxx",
"task_id": "task_xxx",
"object": "image.task",
"model": "Nano Banana 2",
"status": "queued"
}{
"created": 1720000000,
"data": [
{
"url": "https://media.example/result.png"
}
]
}Wartet
queued · submitted · in_progress · processing
Erfolg
completed · succeeded · success
Fehlschlag
failed · failure · cancelled · canceled
Fehler und Produktion
Wiederholungsregeln, Idempotenz und die minimale Checkliste für die Produktion.
Fehler und Produktion
Wiederholungsregeln, Idempotenz und die minimale Checkliste für die Produktion.
400 / 422Korrigieren Sie die Anfragefelder oder die nicht unterstützte Option; wiederholen Sie die Anfrage nicht unverändert.
401Prüfen Sie, ob der API-Schlüssel vorhanden und aktiv ist und als Bearer-Token gesendet wird.
402Das Kontoguthaben reicht nicht aus.
409Der Idempotency-Key wird gerade verarbeitet oder wurde mit einem anderen Body wiederverwendet.
429Warten Sie vor einem erneuten Versuch gemäß Retry-After.
5xxWiederholen Sie mit exponentiellem Backoff und behalten Sie den ursprünglichen Idempotency-Key bei.
- Bewahren Sie API-Schlüssel bei öffentlichen Mobil- und Browser-Apps auf Ihrem Server auf.
- Setzen Sie für jede kostenpflichtige asynchrone Operation einen eindeutigen Idempotency-Key.
- Speichern Sie task_id, damit das Abfragen nach einem Neustart fortgesetzt werden kann.
- Setzen Sie für jede HTTP-Anfrage ein Timeout und geben Sie die Anfrage-ID in Support-Meldungen an.
- Lesen Sie aktuelle Modell-Metadaten, statt Preise und unterstützte Optionen fest im Code zu hinterlegen.
Preis und Stufen
80 % günstiger als offiziellPreis pro Anfrage
$0.0132/ Aufruf
$0.067
Preisstufen
Grundpreis $0.0132
Preisstufen — der endgültige Preis hängt von den angefragten Optionen ab. Nicht aufgeführte Stufen werden zum Grundpreis abgerechnet.
- 16:9×1$0.0132
- 1:1×1$0.0132
- 1:4×1$0.0132
- 1:8×1$0.0132
- 21:9×1$0.0132
- 2:3×1$0.0132
- 3:2×1$0.0132
- 3:4×1$0.0132
- 4:1×1$0.0132
- 4:3×1$0.0132
- 4:5×1$0.0132
- 5:4×1$0.0132
- 8:1×1$0.0132
- 9:16×1$0.0132
- auto×1$0.0132
- 1k×1$0.0132
- 2k×1.166666666667$0.0154
- 0.5k×1.25$0.0165
- 4k×1.5$0.0198
Der hier angezeigte Preis ist genau das, was Ihnen berechnet wird — fehlgeschlagene Aufrufe werden automatisch erstattet.
Ähnliche Modelle