Nano Banana
Nano Banana (Gemini 2.5 Flash Image) asynchronous image generation and editing with up to 14 reference images.
Preis
$0.008/ 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",
"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-2.5-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:9resolutionAngeforderte Ausgabeauflösung.
1KnimagesOptional 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",
"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
79 % günstiger als offiziellPreis pro Anfrage
$0.008/ Aufruf
$0.039
Preisstufen
Grundpreis $0.008
Preisstufen — der endgültige Preis hängt von den angefragten Optionen ab. Nicht aufgeführte Stufen werden zum Grundpreis abgerechnet.
- 16:9×1$0.008
- 1:1×1$0.008
- 21:9×1$0.008
- 2:3×1$0.008
- 3:2×1$0.008
- 3:4×1$0.008
- 4:3×1$0.008
- 4:5×1$0.008
- 5:4×1$0.008
- 9:16×1$0.008
- auto×1$0.008
- 1k×1$0.008
Der hier angezeigte Preis ist genau das, was Ihnen berechnet wird — fehlgeschlagene Aufrufe werden automatisch erstattet.
Ähnliche Modelle