Seedream 5.0 Flash
Seedream 5.0 Flash image generation and editing. One image per request, up to 10 reference images, 1K/1.5K/2K or exact pixels, transparent-background editing and layer decomposition. One flat price for every size; final billing follows the actual generation charge.
Prezzo
$0.015086/ chiamata
Endpoint
/images/tasks
Modalità di consegna
Ciclo di vita dei task asincroni
Disponibilità
Disponibile ora
Documentazione API
Configura e copia la richiesta
Scegli le opzioni accettate da questo modello. Il codice qui sotto si aggiorna mentre scegli.
https://www.aisplice.store/v1/images/tasksBearer API keyTask asincronoOpzioniVengono mostrate solo le opzioni pubblicate per questo modello.
# 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": "Seedream 5.0 Flash",
"prompt": "A cinematic scene with careful composition",
"size": "auto",
"resolution": "1K",
"n": 1,
"output_format": "jpeg",
"watermark": false,
"optimize_prompt_options": {
"mode": "standard"
}
}')
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 .- 1Invia il task
- 2Interroga lo stato
- 3Recupera il contenuto
In produzione sono consigliati URL pubblici per i media. Carica prima un file locale, poi inserisci public_url nella richiesta al modello. Evita corpi Base64 di grandi dimensioni.
Leggi la guida all'uploadRiferimento dei parametri
modelIdentificatore esatto del modello per questa richiesta.
seedream-5-0-flashpromptGeneration/editing instruction. Optional only when layer_decomposition is true. Point and box tags use normalized 0..1000 coordinates.
imagesOptional reference image URLs or data URIs, up to 10. Layer decomposition and transparent editing require exactly one image.
sizeauto, 1K, 1.5K, 2K, a supported aspect ratio (1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, 2:1, 1:2, 21:9), or an exact WIDTHxHEIGHT value. Exact pixels must total 921600..4624220. Every size has the same price.
resolutionRisoluzione dell'output richiesta.
1K1.5K2Kn1Ciclo di vita della risposta
Stato del task, stati finali ed esempi di risposta con il risultato.
Ciclo di vita della risposta
Stato del task, stati finali ed esempi di risposta con il risultato.
{
"id": "task_xxx",
"task_id": "task_xxx",
"object": "image.task",
"model": "Seedream 5.0 Flash",
"status": "queued"
}{
"created": 1720000000,
"data": [
{
"url": "https://media.example/result.png"
}
]
}In attesa
queued · submitted · in_progress · processing
Successo
completed · succeeded · success
Errore
failed · failure · cancelled · canceled
Errori e produzione
Regole di retry, idempotenza e la checklist minima per la produzione.
Errori e produzione
Regole di retry, idempotenza e la checklist minima per la produzione.
400 / 422Correggi i campi della richiesta o l'opzione non supportata; non riprovare senza modifiche.
401Verifica che la chiave API sia presente, attiva e inviata come Bearer token.
402Il saldo dell'account è insufficiente.
409La Idempotency-Key è in elaborazione oppure è stata riutilizzata con un corpo diverso.
429Applica un backoff secondo Retry-After prima di riprovare.
5xxRiprova con backoff esponenziale e mantieni la Idempotency-Key originale.
- Per le app mobile e browser pubbliche, tieni le chiavi API sul tuo server.
- Imposta una Idempotency-Key univoca per ogni operazione asincrona fatturabile.
- Salva task_id, così il polling può riprendere dopo un riavvio.
- Usa un timeout per ogni richiesta HTTP e riporta l'ID richiesta nelle segnalazioni all'assistenza.
- Leggi i metadati dei modelli in tempo reale invece di inserire nel codice prezzi e opzioni supportate.
Prezzo e fasce
risparmi il 12% rispetto al prezzo ufficialePrezzo per richiesta
$0.015086/ chiamata
$0.017143
Prezzi a fasce
Prezzo base $0.015086
Prezzi a fasce — il prezzo finale dipende dalle opzioni richieste. Le fasce non elencate vengono fatturate al prezzo base.
- 1.5k×1$0.015086
- 16:9×1$0.015086
- 1:1×1$0.015086
- 1:2×1$0.015086
- 1k×1$0.015086
- 21:9×1$0.015086
- 2:1×1$0.015086
- 2:3×1$0.015086
- 2k×1$0.015086
- 3:2×1$0.015086
- 3:4×1$0.015086
- 4:3×1$0.015086
- 9:16×1$0.015086
- auto×1$0.015086
- 1.5k×1$0.015086
- 1k×1$0.015086
- 2k×1$0.015086
Il prezzo mostrato qui è esattamente quello che ti viene addebitato — le chiamate non riuscite vengono rimborsate automaticamente.
Modelli correlati