aisplice

Nach Fähigkeit

Bilder

Modell wählen, Anfrage kopieren, Bild erhalten. Alles Weitere unten richtet sich nach dem gewählten Modell.

#1. Modell wählen

gemini-nano-banana-2.1$0.029568 / AnfrageAsynchroner TaskLimits und Status

12 Modelle sind dafür online. Ein Wechsel ändert den Code unten.

#2. Anfrage kopieren

Ersetzen Sie YOUR_API_KEY durch Ihren Schlüssel und führen Sie die Anfrage aus. Angezeigt werden die Optionen, die dieses Modell akzeptiert.

POSThttps://www.aisplice.store/v1/images/tasksBearer API keyAsynchroner Task

OptionenEs 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.1",
  "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 .

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 lesen

Alle Parameter

Alle Felder, die dieses Modell akzeptiert, mit den zulässigen Werten.

model
stringerforderlich

Exakte Modellkennung für diese Anfrage.

gemini-nano-banana-2.1
prompt
stringerforderlich

Anweisung, die das gewünschte Ergebnis beschreibt.

size
stringoptional

Output aspect ratio. auto follows the reference image when one is given.

auto1:12:33:23:44:34:55:49:1616:921:91:44:11:88:1
resolution
stringoptional

Angeforderte Ausgabeauflösung.

1K2K4K
n
integeroptional
1234
images
string[]optional

Optional reference images (URLs or data URIs), up to 14, 20 MB each.

Ablauf der Antwort

Task-Status, Endzustände und Beispiele für Ergebnisantworten.

Einreichen
{
  "id": "task_xxx",
  "task_id": "task_xxx",
  "object": "image.task",
  "model": "Nano Banana 2.1",
  "status": "queued"
}
Inhalt
{
  "created": 1720000000,
  "data": [
    {
      "url": "https://media.example/result.png"
    }
  ]
}

Wartet

queued · submitted · in_progress · processing

Erfolg

completed · succeeded · success

Fehlschlag

failed · failure · cancelled · canceled

Alle Felder: /v1/images/tasks in der API-Referenz →

#3. Ergebnis abrufen

Der Einreichungsaufruf antwortet sofort mit einer task_id. Fragen Sie den Task alle paar Sekunden ab, bis status completed ist, oder übergeben Sie webhook_url, dann benachrichtigen wir Sie, sobald er fertig ist.

GET https://www.aisplice.store/v1/images/tasks/{task_id}

GET https://www.aisplice.store/v1/images/tasks/{task_id}/content

Nur bei Erfolg berechnet

Ein fehlgeschlagener oder abgebrochener Task wird automatisch erstattet. Das Anfrageprotokoll zeigt die endgültigen Kosten jedes Tasks.

Statuswerte und Abfragen →Callback statt Abfragen →

#Wenn etwas schiefgeht

  • 400 mit einem Feldnamen: Diese Option akzeptiert das Modell nicht; verwenden Sie die Werte aus Schritt 2.
  • Inhalt vom Modell abgelehnt: Formulieren Sie den Prompt um; abgelehnte Anfragen werden nicht berechnet.
  • 402: Das Guthaben deckt diese Anfrage nicht; laden Sie im Wallet auf und versuchen Sie es dann erneut.
  • 429: Langsamer werden und nach Retry-After Sekunden erneut versuchen.
  • 503 model_not_found: Der Modellname ist falsch oder das Modell ist offline; wählen Sie eines aus Schritt 1.

Andere Fehler nachschlagen →

#Referenzbilder

Übergeben Sie öffentliche Bild-URLs im Referenzbild-Feld aus Schritt 2. Eine lokale Datei laden Sie zuerst hoch und verwenden dann die erhaltene URL.

So laden Sie eine lokale Datei hoch →

In Ihr Produkt einbauenWelche Optionen Sie Ihren Nutzern zuerst zeigen und welche Sie für später aufheben.
Welche Optionen Sie Ihren Nutzern zuerst zeigenBeginnen Sie mit dem Prompt und einer Preis-Stellschraube; ergänzen Sie den Rest, sobald der Basisablauf funktioniert.+

Kreative Absicht

Felder wie prompt gehören in die UI, weil Nutzer das Ergebnis, das sie damit verändern, direkt verstehen.

Kostenmultiplikator

Felder wie duration, resolution, size und count sollten erst eingeführt werden, wenn sich die Preise bereits nachvollziehbar erklären lassen.

Moduswechsel

Felder wie image, mask oder Fortsetzungs-IDs verändern den Ablauf selbst und sollten nur in eigenen Modi erscheinen.

Systeminterna

Felder wie webhook_secret sind für Integratoren gedacht, nicht für alltägliche Creator, und gehören daher nicht in die Standard-UI.

  • prompt
    Anzeigen, wenn
    Immer. Es ist die wichtigste kreative Eingabe für Bild-Tasks.
    Empfohlener Standard
    In der UI erforderlich.
    Warum es wichtig ist
    Es steuert das Ergebnis direkt; ohne es ist die Funktion unbrauchbar.
  • size
    Anzeigen, wenn
    Schon in der ersten Version anzeigen, wenn sich die Abrechnung nach den Ausgabeabmessungen richtet.
    Empfohlener Standard
    Mit einem empfohlenen Seitenverhältnis wie 1:1 beginnen.
    Warum es wichtig ist
    Es beeinflusst sowohl die Kosten als auch die Bildkomposition, daher brauchen Nutzer früh eine einfache Größenwahl.
  • quality
    Anzeigen, wenn
    Erst anzeigen, wenn Nutzer ausdrücklich eine höhere oder günstigere Stufe wünschen.
    Empfohlener Standard
    Serverseitig beim Modellstandard belassen.
    Warum es wichtig ist
    Es ändert Preis und Latenz, muss aber meist nicht ab dem ersten Tag einstellbar sein.
  • n
    Anzeigen, wenn
    Nur anzeigen, wenn Batch-Generierung ein zentraler Workflow ist.
    Empfohlener Standard
    Standardmäßig 1.
    Warum es wichtig ist
    Es vervielfacht die Kosten sofort und kann den ersten Eindruck unübersichtlich machen.
  • mask / image
    Anzeigen, wenn
    Nur bei Bearbeitungs- oder Referenzbild-Produkten anzeigen.
    Empfohlener Standard
    Im Text-zu-Bild-Modus ausblenden.
    Warum es wichtig ist
    Diese Felder machen aus Generierung Bearbeitung und sollten daher nicht in den Basisablauf geraten.
recommended-rollout.txt
Phase 1
- prompt
- one size or one duration default
- submit -> poll -> content

Phase 2
- one quality or resolution selector
- clear pricing hint

Phase 3
- advanced controls such as reference media, continuation, webhook, or vendor-specific tuning

Eine einzige Quelle für Ergebnisse

Wenn ein Task fertig ist, richten Sie Ihre App auf die Plattform-URL aus, die /content zurückgibt. So bleiben Details des Upstream-Anbieters verborgen und die Wiedergabe älterer Ergebnisse stabil.

Immer noch nicht gelöst?

Senden Sie uns die Anfrage-ID oder die Fehlermeldung, und wir sehen uns das an.