Seedream 5.0 Pro

Seedream 5.0 Pro genera un'immagine da un prompt, modifica o combina fino a 10 immagini di riferimento e scompone un'immagine in un'immagine di base più un massimo di 16 livelli trasparenti. L'output è a 1K, 1.5K, 2K o con dimensioni esatte in pixel. Dettagli del modello e Playground.

Collegarsi a Wan APICopia il link del titolo

Usa https://api.wanapi.app come URL di base dell'API. Crea una chiave con la famiglia di modelli Wan nelle impostazioni delle chiavi API e inviala come Authorization: Bearer YOUR_API_KEY. Conserva le chiavi sul tuo server. Il Playground usa la sessione del sito e addebita lo stesso saldo dell'account.

GET /v1/models elenca i modelli disponibili per la tua chiave. Seedream 5.0 Pro usa l'API OpenAI Images: POST /v1/images/generations con JSON oppure POST /v1/images/edits con JSON o caricamenti multipart. La richiesta restituisce la risposta quando l'immagine è pronta; non ci sono attività da interrogare periodicamente.

Generare un'immagineCopia il link del titolo

Imposta WAN_API_KEY con la tua chiave sul server. Invia la richiesta una sola volta; la generazione termina di solito entro un minuto, quindi imposta un timeout del client di almeno quattro minuti.

curl https://api.wanapi.app/v1/images/generations \
  -H "Authorization: Bearer $WAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "bytedance/seedream-5.0-pro",
  "prompt": "A minimalist magazine cover: a red fox in fresh snow at dawn, the bold serif title \"QUIET WILD\" across the top",
  "size": "1K"
}'

La risposta segue il formato OpenAI Images. I valori di esempio sono illustrativi:

{
  "created": 1792022400,
  "data": [
    {
      "url": "https://cdn.example.com/image-1.jpg",
      "size": "1024x1024",
      "output_format": "jpeg"
    }
  ],
  "usage": {
    "generated_images": 1
  }
}

Gli URL delle immagini restano disponibili per 30 giorni. Salva i file nel tuo spazio di archiviazione se ti servono più a lungo. Invia "response_format": "b64_json" per ricevere anche ogni immagine in Base64 in b64_json.

Prezzi di Seedream 5.0 ProCopia il link del titolo

Ogni immagine generata viene addebitata in base alle dimensioni in pixel, con uno sconto del 30% sulla tariffa ufficiale: fino a 2,61 milioni di pixel (1K e 1.5K) si applica la tariffa inferiore, alle immagini più grandi la tariffa superiore. La prima immagine di riferimento è gratuita; per ogni immagine di riferimento aggiuntiva si applica la tariffa dei riferimenti. Una richiesta rifiutata prima che venga generata un'immagine non viene addebitata.

La scomposizione in livelli addebita l'immagine di base e ogni livello restituito. Quando tutte le immagini restituite non superano 2,61 milioni di pixel, ciascuna costa il 30% in meno rispetto alla tariffa ufficiale dei livelli. Quando un'immagine restituita è più grande, come accade sempre a 2K, tutte le immagini vengono addebitate alla tariffa ufficiale dei livelli per le rispettive dimensioni. Il tuo saldo deve coprire il massimo di 17 immagini; paghi solo le immagini restituite.

Campi della richiestaCopia il link del titolo

Invia un oggetto JSON. model è obbligatorio; prompt è obbligatorio a meno che layer_decomposition non sia true. I campi sconosciuti vengono rifiutati.

stream, sequential_image_generation, tools, seed, guidance_scale e mask non sono supportati da questo modello e vengono rifiutati.

Modificare e combinare immagini di riferimentoCopia il link del titolo

Passa un'immagine con un'istruzione di modifica oppure più immagini da combinare:

{
  "model": "bytedance/seedream-5.0-pro",
  "prompt": "Place the perfume bottle from image 1 on the marble table from image 2, soft window light",
  "image": [
    "https://example.com/bottle.png",
    "https://example.com/table.jpg"
  ],
  "size": "2K",
  "output_format": "png"
}

POST /v1/images/edits accetta gli stessi campi. Con multipart, carica i file nei campi image o image[] e invia optimize_prompt_options come stringa JSON.

Scomposizione in livelliCopia il link del titolo

{
  "model": "bytedance/seedream-5.0-pro",
  "prompt": "Separate the title text, the parrot and the background",
  "image": "https://example.com/poster.png",
  "layer_decomposition": true,
  "size": "2K"
}

La risposta elenca prima l'immagine di base. Ogni livello aggiunge il proprio ordine di sovrapposizione, la posizione e la descrizione:

{
  "created": 1792022400,
  "data": [
    { "url": "https://cdn.example.com/image-1.jpg", "size": "2048x2048", "output_format": "jpeg", "z_index": 0 },
    {
      "url": "https://cdn.example.com/image-2.png",
      "size": "1273x265",
      "output_format": "png",
      "z_index": 1,
      "bounding_box": { "absolute": [383, 120, 1655, 384], "normalized": [187, 59, 808, 188] },
      "name": "Title text",
      "description": "Yellow serif title text"
    }
  ],
  "usage": { "input_images": 1, "generated_images": 2 }
}

Se la generazione di un livello non riesce, l'intera richiesta non riesce. Se il prompt richiede un numero di livelli superiore al limite, parte del contenuto dei livelli potrebbe essere omessa.

ErroriCopia il link del titolo

Gli errori usano la struttura OpenAI {"error": {"message", "type", "code"}}.

Non ripetere mai automaticamente una richiesta dopo un timeout senza aver prima controllato il registro dei consumi.