Come ottenere una chiave API Seedream nel 2026: BytePlus, prezzi ufficiali e un'alternativa con una sola chiave

Hai un prompt Seedream che funziona in un'app web e ora lo vuoi nel tuo codice. Serve una chiave API. Ci sono due modi per ottenerla: il cloud di ByteDance, BytePlus ModelArk, dove crei una chiave, scegli un ID modello e paghi per immagine; oppure una piattaforma API che esegue Seedream dietro un'unica chiave insieme ad altri modelli. Questa guida copre entrambi, con i passaggi esatti, i prezzi ufficiali al 12 ottobre 2026 e le differenze tra i due.

Risposta breve: accedi alla console BytePlus, apri la pagina API keys, clicca Create API key e chiama https://ark.ap-southeast.bytepluses.com/api/v3/images/generations con la chiave come bearer token e un ID modello come dola-seedream-5-0-pro-260628. Seedream 5.0 Pro costa $0.045 per immagine fino a 1.5K e $0.09 oltre, Flash $0.018 e Lite $0.035. BytePlus applica un filtro sui contenuti per impostazione predefinita. Una chiave SpicyAPI esegue le stesse versioni del modello Seedream senza alcun filtro aggiunto, a $0.036 per immagine 1K per 5.0 Pro, e la stessa chiave chiama anche video e altri modelli di immagini.

• Un solo modello, account ufficiale: BytePlus ModelArk. La via più economica a Seedream 5.0 Flash.
• Più modelli, lavori per adulti o prezzi Pro più bassi: una chiave di una piattaforma API come SpicyAPI.
• Pagine di "chiave API Seedream gratis": il listino ufficiale non ha alcuna quota di output gratuita. Le chiavi condivise online sono la quota di qualcun altro.

Opzione 1: ottenere una chiave API Seedream da BytePlus ModelArk

BytePlus è il cloud internazionale di ByteDance e ModelArk è il suo servizio di modelli. Seedream è uno dei modelli di immagini lì presenti, insieme al video Seedance e ai modelli linguistici Seed. Un solo account e una sola chiave coprono tutti.

1. Crea un account BytePlus e accedi alla console. Aggiungi un metodo di pagamento prima di farci affidamento: secondo la pagina ufficiale dei prezzi, un account che resta in arretrato per due ore vede sospesi i servizi di modelli finché non viene ricaricato.
2. Apri la pagina delle chiavi API. Se la tua organizzazione usa spazi di progetto, passa prima a quello giusto nell'angolo in basso a sinistra, perché una chiave raggiunge solo i modelli del proprio progetto.
3. Clicca Create API key, conferma il nome e clicca Create. La chiave compare nell'elenco delle chiavi API. Le chiavi create dopo il 17 settembre 2026 usano un nuovo formato in chiaro; le chiavi più vecchie funzionano ancora.
4. Metti la chiave in una variabile d'ambiente (la documentazione usa ARK_API_KEY) invece che nel codice.

I passaggi ufficiali per la chiave si fermano qui. La console ha anche una pagina Model activation, che mostra i tuoi limiti di frequenza; diverse guide di terze parti aggiungono un passaggio di attivazione prima della prima chiamata di immagine, quindi se una chiamata viene rifiutata per l'accesso, quella pagina è il primo posto dove guardare.

Poi chiama l'endpoint delle immagini con l'ID modello:

curl https://ark.ap-southeast.bytepluses.com/api/v3/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $ARK_API_KEY" \
  -d '{
    "model": "dola-seedream-5-0-pro-260628",
    "prompt": "An adult woman in her early thirties in a cream silk blouse reads a paperback by a rain-streaked café window at dusk, warm lamp light on her face, city lights blurred outside, a cup of coffee on the marble table, calm and absorbed expression, cinematic photograph, 50mm lens, shallow depth of field, natural skin texture",
    "size": "2K",
    "output_format": "png",
    "watermark": false
  }'

La chiamata è sincrona. La risposta contiene un array data e il url di ogni elemento è un link di download per una immagine. Il link viene conservato solo per 24 ore, quindi scarica o copia subito il file nel tuo archivio. Imposta response_format su b64_json se preferisci ricevere i byte dell'immagine nella risposta. watermark ha come valore predefinito true, che aggiunge un segno visibile, quindi impostalo su false se non lo vuoi.

Altre tre cose da sapere prima di costruirci sopra:

• Limita ogni chiave. Una chiave può essere limitata a specifici ID modello e a specifici indirizzi IP. Un account può contenere fino a 50 chiavi, quindi una chiave separata e limitata per ogni app è un'assicurazione economica contro le fughe.
• Occhio al limite di frequenza. Seedream 5.0 Pro e Flash consentono 500 immagini al minuto per versione del modello su un account; oltre, le chiamate restituiscono un errore.
• La moderazione dei contenuti è attiva per impostazione predefinita. Il pre-filtro dei contenuti di ModelArk copre contenuti per adulti ed espliciti ed è abilitato sui nuovi endpoint; puoi disattivarlo per singolo endpoint, ma resta comunque applicata una base di policy sui contenuti di BytePlus. Le immagini bloccate non vengono addebitate.

ID modello Seedream su BytePlus

BytePlus ora chiama i modelli 5.0 Pro e Flash "Dola Seedream". È la stessa linea di modelli. Il suffisso della data cambia quando esce un nuovo snapshot, quindi copia l'ID dall'elenco dei modelli invece di tirare a indovinare.

Prezzi ufficiali dell'API Seedream

Dalla pagina dei prezzi di ModelArk, verificata il 12 ottobre 2026:

Nel listino non c'è alcuna quota di output gratuita. Un lotto di 1.000 immagini Seedream 5.0 Pro a 2K costa $90, e 1.000 immagini Flash costano $18.

Opzione 2: usare Seedream con una sola chiave SpicyAPI

Una piattaforma API ti dà una sola chiave per molti modelli e gestisce gli account dei provider dietro le quinte. Su SpicyAPI i passaggi sono:

1. Registrati e apri le chiavi API nella console.
2. Crea una chiave. Puoi fissarle un tetto giornaliero, mensile e per l'intera durata, e limitare quali modelli può chiamare.
3. Aggiungi credito con carta, Apple Pay, Google Pay o criptovalute. È un saldo in dollari USA senza abbonamento, e il credito pagato non scade.
4. Chiama l'endpoint dei task con il nome del modello:

curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $SPICY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  --data '{
    "model": "bytedance/seedream-5.0-pro/text-to-image",
    "input": {
      "prompt": "An adult woman in her early thirties in a cream silk blouse reads a paperback by a rain-streaked café window at dusk, warm lamp light on her face, city lights blurred outside, a cup of coffee on the marble table, calm and absorbed expression, cinematic photograph, 50mm lens, shallow depth of field, natural skin texture",
      "resolution": "2k",
      "aspect_ratio": "16:9"
    }
  }'

Questa chiamata è asincrona: restituisce subito un ID del task. Interroga GET https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=<id> finché il task non termina, oppure passa un URL di callback quando lo crei. Le immagini finite sono archiviate nello storage di SpicyAPI e conservate fino a 14 giorni, dietro link firmati, quindi non sei in corsa contro una scadenza di 24 ore. Il riferimento API elenca i campi, e la pagina di Seedream 5.0 Pro contiene lo schema di input completo, comprese le modifiche con immagini di riferimento e la scomposizione in livelli.

Prezzi per immagine al 12 ottobre 2026:

Pro è il 20% sotto il prezzo ufficiale a entrambe le dimensioni; SpicyAPI offre 1K e 2K, non 1.5K. Lite e 4.0 costano circa lo stesso. Flash costa di più su SpicyAPI che su BytePlus. Se ti serve solo Flash e i tuoi contenuti rientrano nelle policy di BytePlus, la chiave ufficiale è la scelta più economica.

La differenza più grande è ciò che torna indietro. SpicyAPI non aggiunge alcun filtro sui contenuti a Seedream. Nei nostri test di settembre, Seedream 5.0 Pro ha riuscito 33 esecuzioni su 34 di text-to-image e modifica per adulti, Lite le ha riuscite tutte e 34, e Flash ha attenuato un paio delle richieste più forti. I risultati completi sono in Seedream è senza censura?. È comunque il modello a decidere cosa disegna, e i personaggi adulti e i diritti su qualsiasi foto che modifichi restano una tua responsabilità.

Quale chiave scegliere?

Puoi anche usarle entrambe: BytePlus per i lavori generici in cui costa meno, e una chiave di piattaforma per tutto il resto.

E la "chiave API Seedream gratis"?

"Seedream API key free" e "Seedream API key generator" sono ricerche comuni. Non esiste una chiave gratuita ufficiale. BytePlus addebita ogni immagine in output, mentre le immagini in input sono gratuite. Le chiavi pubblicate su GitHub o nei forum appartengono all'account di qualcun altro. Smettono di funzionare quando il proprietario se ne accorge, e tutto ciò che costruisci su una di esse si rompe con loro. I siti generatori che promettono una chiave gratuita rivendono l'accesso oppure distribuiscono chiavi che non sono loro.

Il modo onesto più economico per provare è inviare una manciata di immagini: dieci immagini Seedream 5.0 Pro a 1K costano meno di 50 centesimi su entrambe le vie. Su SpicyAPI i task falliti di solito non vengono addebitati (ogni pagina di modello indica se un modello fa eccezione), e il prezzo di un'esecuzione viene mostrato prima di inviarla.

Risoluzione dei problemi con una chiave nuova

• 401 o "invalid API key": controlla che l'intestazione sia Authorization: Bearer <key> e che nella variabile d'ambiente non ci siano spazi o a capo finali.
• Errori di accesso o "model not found" su BytePlus: l'ID modello è scritto male, la chiave è limitata ad altri modelli oppure appartiene a un altro spazio di progetto. Se nessuno di questi casi vale, controlla la pagina Model activation.
• Errori di contenuto su BytePlus: il pre-filtro ha bloccato il prompt o l'output. Non vengono addebitati. Riformulare può aiutare per contenuti generici al limite. Per i lavori per adulti, leggi prima la policy d'uso di BytePlus, perché le sue regole di base sui contenuti si applicano all'intero account anche con il filtro disattivato.
• I link smettono di funzionare il giorno dopo: gli URL delle immagini BytePlus scadono dopo 24 ore. Salva il file appena arriva la risposta.
• Le chiamate si fermano dopo giorni di funzionamento: controlla il saldo dell'account. Un account in arretrato per due ore viene sospeso finché non viene ricaricato.

Domande frequenti

Dove trovo la mia chiave API Seedream?

Nella console BytePlus, nella pagina delle chiavi API. Su SpicyAPI, in Console → API keys. In entrambe, l'elenco delle chiavi mostra quelle che hai creato.

L'API Seedream è gratuita?

No. Su BytePlus ogni immagine in output viene addebitata, da $0.018 per 5.0 Flash a $0.09 per 5.0 Pro oltre 1.5K. Le immagini in input sono gratuite, tranne che Seedream 5.0 Pro addebita $0.003 per ogni immagine in input dopo la prima.

Qual è l'ID modello di Seedream 5.0?

Su BytePlus, dola-seedream-5-0-pro-260628 per Pro, dola-seedream-5-0-flash-260915 per Flash e seedream-5-0-lite-260128 per Lite. Su SpicyAPI, bytedance/seedream-5.0-pro/text-to-image e i nomi corrispondenti per Flash, Lite e le modifiche.

Posso usare l'API Seedream per immagini NSFW?

Non con le impostazioni predefinite di BytePlus: il pre-filtro dei contenuti blocca i contenuti per adulti, e le policy sui contenuti di BytePlus si applicano anche quando è disattivato. Su SpicyAPI non c'è alcun filtro aggiunto, e Seedream 5.0 Pro e Lite hanno riuscito quasi tutti i nostri test per adulti.

Seedream 4.5 o 5.0?

Su BytePlus, 5.0 Lite ($0.035) costa meno di 4.5 ($0.04), e 5.0 Flash ($0.018) costa meno di entrambi. Pro è quello per cui vale la pena pagare di più, quando conta soprattutto la qualità dell'immagine. Il nostro confronto Lite vs Pro vs Flash ha risultati affiancati.

In sintesi

Ottenere una chiave API Seedream da BytePlus richiede pochi minuti: crea una chiave, usa l'ID modello giusto, salva ogni immagine entro 24 ore e tieni d'occhio il saldo. È la via più economica a Seedream 5.0 Flash e quella giusta per i lavori generici con un account diretto ByteDance. Se vuoi Seedream accanto ad altri modelli di immagini e video con una sola chiave, un prezzo Pro più basso, risultati che restano disponibili fino a due settimane, o immagini per adulti senza un filtro del provider, una chiave SpicyAPI fa al caso tuo.

Crea una chiave SpicyAPI e prova Seedream 5.0 Pro →