img_uuid, quindi esegui il polling o utilizza un callback HTTPS per il risultato in 2K.API Seedream 4.0 per la generazione di immagini
Accedi a Seedream 4.0 tramite l'API aperta indipendente di GoEnhance. Invia solo un prompt testuale o aggiungi fino a 14 immagini di riferimento, ricevi un
Crea una chiave API
Scegli la modalità di input di Seedream 4.0
Da testo a immagine da un prompt mirato
Invia un prompt obbligatorio da 1 a 2.000 caratteri. Ometti image_list per la generazione pura da testo a immagine.
Generazione di immagini guidata da riferimento
Aggiungi 1–14 URL di immagini pubbliche in image_list quando il tuo flusso di lavoro richiede una guida da immagine a immagine.
Un flusso di lavoro REST asincrono
Utilizza un unico endpoint per entrambe le modalità di input. Un invio riuscito restituisce un identificatore di attività invece di bloccarsi finché l'immagine non è pronta.
Convalida la forma della richiesta prima dell'invio e traccia ogni immagine come un'attività asincrona.
Funzionalità e limiti dell'API Seedream 4.0
Validazione del prompt
Il <code>prompt</code> è obbligatorio e accetta da 1 a 2.000 caratteri.
Sette proporzioni documentate
Imposta <code>ratio</code> su <code>1:1</code>, <code>4:3</code>, <code>3:4</code>, <code>16:9</code>, <code>9:16</code>, <code>3:2</code> o <code>2:3</code>. Omettilo per utilizzare l'impostazione predefinita del modello.
Immagini di riferimento opzionali
Passa 1–14 oggetti in <code>image_list</code>, ognuno contenente un URL di immagine pubblica, oppure ometti il campo per la generazione da testo a immagine.
Output 2K
La rotta documentata di Seedream 4.0 restituisce immagini generate a risoluzione 2K.
Autenticazione Bearer
Invia la tua chiave API GoEnhance nell'intestazione <code>Authorization</code> e tienila fuori dal codice lato client e dai log.
Completamento tramite polling o callback
Conserva l'<code>img_uuid</code> restituito, quindi esegui il polling dei dettagli del processo o ricevi aggiornamenti sullo stato dell'attività presso un URL di callback HTTPS pubblico.
Il riferimento API GoEnhance corrente elenca un token per ogni immagine Seedream 4.0.
Prezzi API Seedream
0,02 $ per immagine generata
GoEnhance quota Seedream 4.0 a 1 token per immagine, con 1 token pari a 0,02 $.
Budget semplice a livello di richiesta
Il costo si stima come il numero di attività di immagine inviate moltiplicato per 0,02 $; non è previsto alcun calcolo al secondo per questo endpoint di immagine.
Controlla la fatturazione corrente prima di eseguire i processi di produzione
Consulta la pagina di fatturazione live di GoEnhance prima di lanciare batch di grandi dimensioni, poiché i termini dell'account e i prezzi della piattaforma possono variare.
Integra l'API Seedream 4.0
1
1. Crea e proteggi una chiave API
Crea una chiave su /keys e inviala con la richiesta. Non esporla nel codice del browser o in repository pubblici.
2
2. Crea e convalida la richiesta
Aggiungi il prompt richiesto, scegli un rapporto facoltativo e includi
image_list solo se hai da 1 a 14 URL di riferimento accessibili. 3
3. Invia e conserva img_uuid
Effettua una richiesta POST a
https://api.goenhance.ai/api/v1/seedream-4-0. Salva l'img_uuid restituito con il tuo registro interno delle attività. 4
4. Esegui il polling o ricevi i callback
Esegui il polling di
GET https://api.goenhance.ai/api/v1/jobs/detail?img_uuid=..., oppure fornisci un custom_callback_url per le notifiche di stato HTTPS. 5
5. Gestisci i risultati terminali in modo idempotente
Controlla sia lo stato HTTP che il
code/msg della risposta. Correggi le richieste non valide prima di reinviarle e previeni la duplicazione dell'elaborazione a valle.Connetti generazione di prompt, riferimenti, monitoraggio asincrono dei processi, archiviazione e revisione umana in un'unica pipeline di immagini.
Cosa costruiscono gli sviluppatori con Seedream 4.0
Pipeline creative di prodotto
Genera concetti di scena per prodotti a partire da prompt strutturati e indirizza gli output selezionati in flussi di lavoro di revisione e campagna.
Esplorazione del brand guidata da riferimenti
Usa immagini di riferimento approvate per guidare la composizione o la direzione visiva senza creare un endpoint di modifica delle immagini separato.
Varianti di campagna localizzate
Adatta a livello programmatico i dettagli dei prompt per mercati, formati e canali, mantenendo coerente il monitoraggio delle attività.
Concept art e previsualizzazione
Crea immagini statiche 2K per l'esplorazione di mood, storyboard, studi ambientali e decisioni creative preliminari.
Prezzi, input, rapporti, output, gestione dei processi e relazione con la piattaforma.