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
gpt-image-2.5-flare$4.80 Eingabe · $28.80 Ausgabe / 1 Mio.Asynchroner 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.
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": "GPT Image 2.5 Flare",
"prompt": "A cinematic scene with careful composition",
"size": "auto",
"resolution": "1K",
"n": 1,
"quality": "auto",
"background": "auto",
"moderation": "low",
"output_format": "png"
}')
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 .Dieses Modell erfordert öffentliche Medien-URLs. Laden Sie zuerst eine lokale Datei hoch und setzen Sie dann public_url in die Modellanfrage. Vermeiden Sie große Base64-Bodys.
Upload-Leitfaden lesenAlle Parameter
Alle Felder, die dieses Modell akzeptiert, mit den zulässigen Werten.
Alle Parameter
Alle Felder, die dieses Modell akzeptiert, mit den zulässigen Werten.
modelExakte Modellkennung für diese Anfrage.
gpt-image-2.5-flarepromptAnweisung, die das gewünschte Ergebnis beschreibt.
sizeAspect ratio or exact pixels such as 1600x1200. Exact dimensions must be multiples of 16; sides <=3840, ratio <=3:1, area 655360-8294400.
resolutionAngeforderte Ausgabeauflösung.
1K2K4Kn1234imagesReference images; data URLs are materialized before upstream submission.
qualityAngeforderte Qualitätsstufe der Ausgabe.
autolowmediumhighxhighmaxAblauf 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": "GPT Image 2.5 Flare",
"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
#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
#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.
#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.
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.
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 tuningEine einzige Quelle für Ergebnisse
Immer noch nicht gelöst?
Senden Sie uns die Anfrage-ID oder die Fehlermeldung, und wir sehen uns das an.