Vai al contenuto
PlaygroundDocumentazioneOttieni la chiave API

API di Mage · Modello per immagini

API di Seedream

Seedream, con filtro rigoroso

Ottieni una chiave APIProva Seedream nel playground
POST https://api.mage.space/v1/seedream/generate

In breve

L'API Seedream esegue Seedream 5.5 e altre 5 varianti tramite Mage all'indirizzo POST https://api.mage.space/v1/seedream/generate. Una richiesta con le impostazioni predefinite costa 42 Gems (circa 0,042 $), senza abbonamento. Seedream supporta i personaggi salvati e i riferimenti tramite @handle nel prompt.

  • ImmagineOutput
  • 6Varianti
  • 42Gems per immagine, predefinito
  • $0.042Circa, in USD

Panoramica

Cosa fa l'API di Seedream

Seedream di ByteDance, da Seedream 5.0 Flash per le bozze a Seedream 5.5, il più recente e quello predefinito, con scene dettagliate, testo leggibile e modifiche a partire da un massimo di 10 riferimenti o Characters, fino a 4K con Seedream 4.5. Filtro severo: prompt e prime immagini vengono controllati prima di ogni esecuzione.

La famiglia di modelli per immagini Seedream di ByteDance, ideale per scene dettagliate, testo leggibile e modifiche a partire da un massimo di 10 References o Characters: Seedream 5.5 (`seedream-5.5`), il più recente e quello predefinito, con immagini più realistiche, testo piccolo più nitido e modifiche ripetute più stabili; Seedream 5.0 Pro (`seedream-5.0-pro`), il precedente modello di punta; Seedream 5.0 Flash (`seedream-5.0-flash`), un unico prezzo fisso con le immagini di input incluse, il più basso a 2K o con immagini di input (Seedream 5.5 costa meno per un prompt da solo in 1K); Seedream 5.0 Lite (`seedream-5.0-lite`), fino a 3K; Seedream 4.5 (`seedream-4.5`), fino a 4K; e Seedream 4.0 (`seedream-4.0`). Filtro rigoroso: Mage controlla il prompt e la prima immagine prima dell'esecuzione; una richiesta rifiutata non va a buon fine, restituisce `content_blocked` con un motivo e viene rimborsata.

Accetta come input image, additional_images.

Guida rapida

Chiama l'API di Seedream

Imposta MAGE_API_KEY, invia la richiesta a /seedream/generate e controlla status_url finché la richiesta non è completata.

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/seedream/generate' \
  --header "Authorization: Bearer $MAGE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "Editorial portrait in soft daylight, 35mm film look",
  "aspect_ratio": "4:5",
  "model_id": "seedream-5.5"
}' | jq -r '.status_url')

# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"
TypeScript
// npm install @mage-space/sdk
import Mage from '@mage-space/sdk';

const mage = new Mage(); // reads MAGE_API_KEY

const request = await mage.run('seedream', {
  prompt: 'Editorial portrait in soft daylight, 35mm film look',
  aspect_ratio: '4:5',
  model_id: 'seedream-5.5',
});

console.log(request.result.url);
Python
# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("seedream", {
    "prompt": "Editorial portrait in soft daylight, 35mm film look",
    "aspect_ratio": "4:5",
    "model_id": "seedream-5.5",
})

print(request["result"]["url"])

Modelli

Valori model_id di Seedream

Invia model_id per scegliere una variante. Una richiesta senza model_id usa quella predefinita.

model_idNomePredefinito
seedream-4.0Seedream 4.0
seedream-4.5Seedream 4.5
seedream-5.0-liteSeedream 5.0 Lite
seedream-5.0-proSeedream 5.0 Pro
seedream-5.0-flashSeedream 5.0 Flash
seedream-5.5Seedream 5.5Sì

Opzioni

Parametri di Seedream

Valori consentiti per tutte le varianti; una variante può offrirne meno. La documentazione elenca le opzioni di ogni variante.

CampoValori
aspect_ratio21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21
resolution1K, 2K, 3K, 4K

Input

Contenuti multimediali accettati da Seedream

Invia ciascuno come URL https, data URL o upload fino a 100 MB.

CampoRuolo
imageL'immagine di riferimento.
additional_imagesImmagini di riferimento aggiuntive.

Altri modelli di immagini

Altre API di generazione di immagini su Mage

FAQ

Domande frequenti

Quanto costa l'API di Seedream?
Una richiesta Seedream con le impostazioni predefinite (Seedream 5.5) costa 42 Gems, circa 0,042 $. Altre risoluzioni, durate e varianti cambiano il prezzo; la risposta indica l'addebito esatto. Se una generazione non riesce, ti viene rimborsata; se viene bloccata dalla content policy di Mage, no.
Qual è l'endpoint dell'API di Seedream?
POST https://api.mage.space/v1/seedream/generate con un header Authorization: Bearer contenente la tua chiave API di Mage. La risposta include uno status_url da controllare per ottenere il risultato.
Quali modelli Seedream posso usare?
seedream-4.0 (Seedream 4.0), seedream-4.5 (Seedream 4.5), seedream-5.0-lite (Seedream 5.0 Lite), seedream-5.0-pro (Seedream 5.0 Pro), seedream-5.0-flash (Seedream 5.0 Flash), seedream-5.5 (Seedream 5.5). Il modello predefinito è Seedream 5.5.
Seedream supporta immagini di riferimento o personaggi?
Seedream accetta image, additional_images. Seedream accetta personaggi salvati e riferimenti richiamati con @handle nel prompt.
Posso usare Seedream da Claude o ChatGPT?
Sì. Collega il server MCP di Mage a Claude, ChatGPT, Claude Code, Grok o Cursor e chiedi Seedream per nome. Il tuo assistente legge le opzioni con get_model e ti indica il prezzo prima di generare.
Per quanto tempo vengono conservati i risultati di Seedream?
Risultati e input vengono conservati per 30 giorni. Scarica tutto ciò che vuoi tenere nel tuo spazio di archiviazione.

Inizia a creare con Mage

Un solo account, un solo saldo di Gems, tutti i modelli. Paghi solo ciò che generi.

Ottieni una chiave APIProva Seedream nel playground