{ "aboutHtml": "

Un’edizione più veloce per creare immagini

Seedream 5.0 Flash è il modello di generazione e modifica immagini di ByteDance Seed per flussi di lavoro che privilegiano la velocità di generazione. La guida Pro/Flash del produttore descrive sia text-to-image sia image-to-image con uno o più riferimenti. Distingue la generazione più veloce di Flash dalla priorità alla maggiore qualità d’immagine di Pro, senza stabilire un tempo di risposta fisso per ogni brief.

Le caratteristiche condivise distintive sono modifica interattiva, scomposizione in livelli e generazione multilingue nativa. La generazione ordinaria restituisce un’immagine finita. Il flusso Flash del produttore non supporta generazione sequenziale di immagini correlate, ricerca web o output di immagini in streaming. L’ottimizzazione del prompt usa la modalità standard; il controllo separato di ottimizzazione veloce appartiene a Pro anziché Flash.

Creare da un brief e riferimenti

Indica immagine desiderata, soggetto principale, composizione e trattamento visivo, poi identifica cosa controlla ogni riferimento. Per una visuale di prodotto, separa il riferimento che stabilisce l’oggetto da quello che fornisce una tavolozza o un materiale di superficie. “Conserva sagoma e angolo di vista dell’oggetto della prima immagine; usa la seconda solo per la tavolozza attenuata dello sfondo” assegna ruoli distinti ai riferimenti.

Il produttore consiglia prompt concisi, non oltre 300 caratteri cinesi o 600 parole inglesi. È una guida di preparazione anziché un limite rigido dichiarato dell’input testuale. Elenca prima i requisiti decisivi, inclusi testo esatto che deve apparire, rapporto d’aspetto desiderato e dettagli che devono restare invariati. Ispeziona l’immagine finita rispetto a tale elenco anziché affidarti solo al suo aspetto generale.

Modifica guidata spazialmente

Flash può usare punti, riquadri delimitatori, frecce e segni liberi per identificare dove deve avvenire una modifica. Fornisci l’immagine sorgente insieme a posizione e cambiamento. Per un concept d’interni, contrassegna la sedia, richiedi una sostituzione del tessuto e identifica pavimento, parete, angolo di camera e oggetti vicini da preservare. Se i segni servono solo da guida, chiedi esplicitamente di rimuoverli dall’immagine finita.

La guida di modifica tramite coordinate del produttore usa tag <point> e <bbox> con coordinate normalizzate a 0–999 rispetto all’immagine in ingresso specificata. Un punto contiene x e y; un riquadro contiene coordinate superiore sinistra e inferiore destra. Identifica numero dell’immagine e oggetto destinatario, soprattutto quando un riquadro include più soggetti. Per una modifica fra immagini, distingui l’oggetto da prendere da un riferimento e la zona di destinazione in un altro.

Usa le dimensioni proprie dell’immagine visualizzata nell’ottenere la posizione proporzionale; zoom del canvas, panoramica o coordinate del browser non sono coordinate normalizzate dell’immagine. Descrivi le zone protette oltre a quella modificata. Confronta prospettiva, illuminazione e dettagli circostanti del risultato con la sorgente originale.

Separa una composizione in livelli modificabili

La scomposizione in livelli è una modalità distinta che accetta esattamente un’immagine e restituisce un’immagine base e fino a 16 livelli indipendenti. Ogni livello è un PNG con alfa. Un prompt può nominare gli elementi da separare, come titolo, soggetto principale e decorazioni; senza un prompt di scomposizione, il modello identifica automaticamente gli elementi principali.

I risultati includono nomi dei livelli, descrizioni, ordine di sovrapposizione e riquadri di collocazione. Usa l’immagine base con indice di sovrapposizione zero, poi colloca gli altri livelli in ordine crescente. I riquadri assoluti descrivono la collocazione nell’immagine base d’output; quelli normalizzati descrivono la collocazione proporzionale su un canvas diverso. Conserva questi metadati di collocazione restituiti con i file immagine affinché la composizione originale possa essere ricostruita prima di riordinarla.

Per una revisione di poster, separa la grafica principale da titolo e decorazioni, poi ispeziona bordi e ogni area di sfondo ripristinata. Un livello trasparente può essere modificato come unico input con canale alfa e output PNG trasparente. L’opzione di sfondo trasparente riguarda quel flusso di modifica immagine a input singolo; la generazione text-to-image ordinaria è un’operazione separata.

Composizione multilingue

Oltre a cinese e inglese, il produttore documenta supporto nativo per prompt e testo nelle immagini in russo, arabo, filippino, thailandese, turco, coreano, malese, spagnolo, portoghese, indonesiano, francese, tedesco, vietnamita e giapponese. Fornisci il testo approvato esatto e la direzione di lettura e identifica quale zona contiene ogni blocco testuale. Controlla accenti, caratteri uniti, interruzioni di riga e piccole etichette nell’immagine finale.

File di riferimento e specifiche d’output

La generazione immagini accetta fino a 10 riferimenti in JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC o HEIF. Ciascuno può arrivare a 30 MB, con entrambi i lati superiori a 14 pixel, 196–36.000.000 pixel totali e rapporto d’aspetto da 1:16 a 16:1. La scomposizione in livelli richiede invece un JPEG o PNG di 262.144–36.000.000 pixel, fino a 30 MB, entro lo stesso intervallo di rapporti.

La generazione offre fasce d’output 1K, 1.5K e 2K, con 2K predefinita, oppure dimensioni esplicite con 921.600–4.624.220 pixel totali e rapporti da 1:16 a 16:1. Entrambi i vincoli si applicano alle dimensioni personalizzate. L’output dei livelli usa 1K, 1.5K, 2K o auto, con auto predefinito; base e ciascun livello mantengono i rispettivi rapporti d’aspetto sorgente.

Le immagini finite sono JPEG o PNG. Il formato dell’immagine base può essere scelto separatamente, mentre i livelli scomposti restano PNG con alfa. La consegna può usare dati immagine codificati o link di download conservati per 24 ore. Salva ogni immagine restituita e i suoi metadati per il flusso di design previsto. Ispeziona testo, dettagli modificati e allineamento dei livelli alle dimensioni d’uso dell’elaborato.

", "aboutText": "Un’edizione più veloce per creare immagini\n\nSeedream 5.0 Flash è il modello di generazione e modifica immagini di ByteDance Seed per flussi di lavoro che privilegiano la velocità di generazione. La guida Pro/Flash del produttore descrive sia text-to-image sia image-to-image con uno o più riferimenti. Distingue la generazione più veloce di Flash dalla priorità alla maggiore qualità d’immagine di Pro, senza stabilire un tempo di risposta fisso per ogni brief.\n\nLe caratteristiche condivise distintive sono modifica interattiva, scomposizione in livelli e generazione multilingue nativa. La generazione ordinaria restituisce un’immagine finita. Il flusso Flash del produttore non supporta generazione sequenziale di immagini correlate, ricerca web o output di immagini in streaming. L’ottimizzazione del prompt usa la modalità standard; il controllo separato di ottimizzazione veloce appartiene a Pro anziché Flash.\n\nCreare da un brief e riferimenti\n\nIndica immagine desiderata, soggetto principale, composizione e trattamento visivo, poi identifica cosa controlla ogni riferimento. Per una visuale di prodotto, separa il riferimento che stabilisce l’oggetto da quello che fornisce una tavolozza o un materiale di superficie. “Conserva sagoma e angolo di vista dell’oggetto della prima immagine; usa la seconda solo per la tavolozza attenuata dello sfondo” assegna ruoli distinti ai riferimenti.\n\nIl produttore consiglia prompt concisi, non oltre 300 caratteri cinesi o 600 parole inglesi. È una guida di preparazione anziché un limite rigido dichiarato dell’input testuale. Elenca prima i requisiti decisivi, inclusi testo esatto che deve apparire, rapporto d’aspetto desiderato e dettagli che devono restare invariati. Ispeziona l’immagine finita rispetto a tale elenco anziché affidarti solo al suo aspetto generale.\n\nModifica guidata spazialmente\n\nFlash può usare punti, riquadri delimitatori, frecce e segni liberi per identificare dove deve avvenire una modifica. Fornisci l’immagine sorgente insieme a posizione e cambiamento. Per un concept d’interni, contrassegna la sedia, richiedi una sostituzione del tessuto e identifica pavimento, parete, angolo di camera e oggetti vicini da preservare. Se i segni servono solo da guida, chiedi esplicitamente di rimuoverli dall’immagine finita.\n\nLa guida di modifica tramite coordinate del produttore usa tag e con coordinate normalizzate a 0–999 rispetto all’immagine in ingresso specificata. Un punto contiene x e y; un riquadro contiene coordinate superiore sinistra e inferiore destra. Identifica numero dell’immagine e oggetto destinatario, soprattutto quando un riquadro include più soggetti. Per una modifica fra immagini, distingui l’oggetto da prendere da un riferimento e la zona di destinazione in un altro.\n\nUsa le dimensioni proprie dell’immagine visualizzata nell’ottenere la posizione proporzionale; zoom del canvas, panoramica o coordinate del browser non sono coordinate normalizzate dell’immagine. Descrivi le zone protette oltre a quella modificata. Confronta prospettiva, illuminazione e dettagli circostanti del risultato con la sorgente originale.\n\nSepara una composizione in livelli modificabili\n\nLa scomposizione in livelli è una modalità distinta che accetta esattamente un’immagine e restituisce un’immagine base e fino a 16 livelli indipendenti. Ogni livello è un PNG con alfa. Un prompt può nominare gli elementi da separare, come titolo, soggetto principale e decorazioni; senza un prompt di scomposizione, il modello identifica automaticamente gli elementi principali.\n\nI risultati includono nomi dei livelli, descrizioni, ordine di sovrapposizione e riquadri di collocazione. Usa l’immagine base con indice di sovrapposizione zero, poi colloca gli altri livelli in ordine crescente. I riquadri assoluti descrivono la collocazione nell’immagine base d’output; quelli normalizzati descrivono la collocazione proporzionale su un canvas diverso. Conserva questi metadati di collocazione restituiti con i file immagine affinché la composizione originale possa essere ricostruita prima di riordinarla.\n\nPer una revisione di poster, separa la grafica principale da titolo e decorazioni, poi ispeziona bordi e ogni area di sfondo ripristinata. Un livello trasparente può essere modificato come unico input con canale alfa e output PNG trasparente. L’opzione di sfondo trasparente riguarda quel flusso di modifica immagine a input singolo; la generazione text-to-image ordinaria è un’operazione separata.\n\nComposizione multilingue\n\nOltre a cinese e inglese, il produttore documenta supporto nativo per prompt e testo nelle immagini in russo, arabo, filippino, thailandese, turco, coreano, malese, spagnolo, portoghese, indonesiano, francese, tedesco, vietnamita e giapponese. Fornisci il testo approvato esatto e la direzione di lettura e identifica quale zona contiene ogni blocco testuale. Controlla accenti, caratteri uniti, interruzioni di riga e piccole etichette nell’immagine finale.\n\nFile di riferimento e specifiche d’output\n\nLa generazione immagini accetta fino a 10 riferimenti in JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC o HEIF. Ciascuno può arrivare a 30 MB, con entrambi i lati superiori a 14 pixel, 196–36.000.000 pixel totali e rapporto d’aspetto da 1:16 a 16:1. La scomposizione in livelli richiede invece un JPEG o PNG di 262.144–36.000.000 pixel, fino a 30 MB, entro lo stesso intervallo di rapporti.\n\nLa generazione offre fasce d’output 1K, 1.5K e 2K, con 2K predefinita, oppure dimensioni esplicite con 921.600–4.624.220 pixel totali e rapporti da 1:16 a 16:1. Entrambi i vincoli si applicano alle dimensioni personalizzate. L’output dei livelli usa 1K, 1.5K, 2K o auto, con auto predefinito; base e ciascun livello mantengono i rispettivi rapporti d’aspetto sorgente.\n\nLe immagini finite sono JPEG o PNG. Il formato dell’immagine base può essere scelto separatamente, mentre i livelli scomposti restano PNG con alfa. La consegna può usare dati immagine codificati o link di download conservati per 24 ore. Salva ogni immagine restituita e i suoi metadati per il flusso di design previsto. Ispeziona testo, dettagli modificati e allineamento dei livelli alle dimensioni d’uso dell’elaborato.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "b264a63bb7d9c1f1338120d9679025159e3ff1d16b1802e257f23e071a2b3bdc", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "it", "methods": [ { "html": "
•

ByteDance Seed: Seedream 5.0 Flash

ByteDance Seed /bytedance-seed/seedream-5-0-flash

Introduzione

Crea un’immagine finita a partire da un brief testuale.

  • Crea un’immagine statica di un prodotto
  • Esplora un concetto visivo
  • Illustra una scena
Input accettati
Testo
Risultati
Immagini
Informazioni sul modello

Questa descrizione illustra le funzionalità del modello. Gli input, gli output e le opzioni disponibili in Ailoot per il metodo selezionato sono elencati di seguito.

Un’edizione più veloce per creare immagini

Seedream 5.0 Flash è il modello di generazione e modifica immagini di ByteDance Seed per flussi di lavoro che privilegiano la velocità di generazione. La guida Pro/Flash del produttore descrive sia text-to-image sia image-to-image con uno o più riferimenti. Distingue la generazione più veloce di Flash dalla priorità alla maggiore qualità d’immagine di Pro, senza stabilire un tempo di risposta fisso per ogni brief.

Le caratteristiche condivise distintive sono modifica interattiva, scomposizione in livelli e generazione multilingue nativa. La generazione ordinaria restituisce un’immagine finita. Il flusso Flash del produttore non supporta generazione sequenziale di immagini correlate, ricerca web o output di immagini in streaming. L’ottimizzazione del prompt usa la modalità standard; il controllo separato di ottimizzazione veloce appartiene a Pro anziché Flash.

Creare da un brief e riferimenti

Indica immagine desiderata, soggetto principale, composizione e trattamento visivo, poi identifica cosa controlla ogni riferimento. Per una visuale di prodotto, separa il riferimento che stabilisce l’oggetto da quello che fornisce una tavolozza o un materiale di superficie. “Conserva sagoma e angolo di vista dell’oggetto della prima immagine; usa la seconda solo per la tavolozza attenuata dello sfondo” assegna ruoli distinti ai riferimenti.

Il produttore consiglia prompt concisi, non oltre 300 caratteri cinesi o 600 parole inglesi. È una guida di preparazione anziché un limite rigido dichiarato dell’input testuale. Elenca prima i requisiti decisivi, inclusi testo esatto che deve apparire, rapporto d’aspetto desiderato e dettagli che devono restare invariati. Ispeziona l’immagine finita rispetto a tale elenco anziché affidarti solo al suo aspetto generale.

Modifica guidata spazialmente

Flash può usare punti, riquadri delimitatori, frecce e segni liberi per identificare dove deve avvenire una modifica. Fornisci l’immagine sorgente insieme a posizione e cambiamento. Per un concept d’interni, contrassegna la sedia, richiedi una sostituzione del tessuto e identifica pavimento, parete, angolo di camera e oggetti vicini da preservare. Se i segni servono solo da guida, chiedi esplicitamente di rimuoverli dall’immagine finita.

La guida di modifica tramite coordinate del produttore usa tag <point> e <bbox> con coordinate normalizzate a 0–999 rispetto all’immagine in ingresso specificata. Un punto contiene x e y; un riquadro contiene coordinate superiore sinistra e inferiore destra. Identifica numero dell’immagine e oggetto destinatario, soprattutto quando un riquadro include più soggetti. Per una modifica fra immagini, distingui l’oggetto da prendere da un riferimento e la zona di destinazione in un altro.

Usa le dimensioni proprie dell’immagine visualizzata nell’ottenere la posizione proporzionale; zoom del canvas, panoramica o coordinate del browser non sono coordinate normalizzate dell’immagine. Descrivi le zone protette oltre a quella modificata. Confronta prospettiva, illuminazione e dettagli circostanti del risultato con la sorgente originale.

Separa una composizione in livelli modificabili

La scomposizione in livelli è una modalità distinta che accetta esattamente un’immagine e restituisce un’immagine base e fino a 16 livelli indipendenti. Ogni livello è un PNG con alfa. Un prompt può nominare gli elementi da separare, come titolo, soggetto principale e decorazioni; senza un prompt di scomposizione, il modello identifica automaticamente gli elementi principali.

I risultati includono nomi dei livelli, descrizioni, ordine di sovrapposizione e riquadri di collocazione. Usa l’immagine base con indice di sovrapposizione zero, poi colloca gli altri livelli in ordine crescente. I riquadri assoluti descrivono la collocazione nell’immagine base d’output; quelli normalizzati descrivono la collocazione proporzionale su un canvas diverso. Conserva questi metadati di collocazione restituiti con i file immagine affinché la composizione originale possa essere ricostruita prima di riordinarla.

Per una revisione di poster, separa la grafica principale da titolo e decorazioni, poi ispeziona bordi e ogni area di sfondo ripristinata. Un livello trasparente può essere modificato come unico input con canale alfa e output PNG trasparente. L’opzione di sfondo trasparente riguarda quel flusso di modifica immagine a input singolo; la generazione text-to-image ordinaria è un’operazione separata.

Composizione multilingue

Oltre a cinese e inglese, il produttore documenta supporto nativo per prompt e testo nelle immagini in russo, arabo, filippino, thailandese, turco, coreano, malese, spagnolo, portoghese, indonesiano, francese, tedesco, vietnamita e giapponese. Fornisci il testo approvato esatto e la direzione di lettura e identifica quale zona contiene ogni blocco testuale. Controlla accenti, caratteri uniti, interruzioni di riga e piccole etichette nell’immagine finale.

File di riferimento e specifiche d’output

La generazione immagini accetta fino a 10 riferimenti in JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC o HEIF. Ciascuno può arrivare a 30 MB, con entrambi i lati superiori a 14 pixel, 196–36.000.000 pixel totali e rapporto d’aspetto da 1:16 a 16:1. La scomposizione in livelli richiede invece un JPEG o PNG di 262.144–36.000.000 pixel, fino a 30 MB, entro lo stesso intervallo di rapporti.

La generazione offre fasce d’output 1K, 1.5K e 2K, con 2K predefinita, oppure dimensioni esplicite con 921.600–4.624.220 pixel totali e rapporti da 1:16 a 16:1. Entrambi i vincoli si applicano alle dimensioni personalizzate. L’output dei livelli usa 1K, 1.5K, 2K o auto, con auto predefinito; base e ciascun livello mantengono i rispettivi rapporti d’aspetto sorgente.

Le immagini finite sono JPEG o PNG. Il formato dell’immagine base può essere scelto separatamente, mentre i livelli scomposti restano PNG con alfa. La consegna può usare dati immagine codificati o link di download conservati per 24 ore. Salva ogni immagine restituita e i suoi metadati per il flusso di design previsto. Ispeziona testo, dettagli modificati e allineamento dei livelli alle dimensioni d’uso dell’elaborato.

Disponibile in Ailoot · input e metodi

Ailoot Ultra · Immagini POST /v1/images/generations
Tipi di input
text
Tipi di output
image
Formato di output
File immagine
Numero di output
1 output
CampoTipoRequisitoValori e limitiPredefinito
CampomodelTipostringRequisitoObbligatorioValori e limiti
bytedance-seed/seedream-5-0-flash
Predefinito—
CampopromptTipostringRequisitoObbligatorioValori e limiti
Lunghezza minima: 1
Condizioni: Prompt UTF8 non vuoto. Non viene inventato alcun limite di caratteri valido per tutti i modelli del produttore.
Predefinito—
CamponTipointegerRequisitoFacoltativoValori e limiti
1
Predefinito1
Camporesponse_formatTipostringRequisitoFacoltativoValori e limiti
url, b64_json
Predefinito—
CampostreamTipobooleanRequisitoFacoltativoValori e limiti
false
Predefinitofalse
Combinazioni di materiali in input

Da testo a immagine · Obbligatorio: prompt

Parametri e ciclo di vita del metodo
ParametroContratto
Parametrocontent_typeContrattoapplication/json
ParametrorequiredContrattomodel, prompt
Parametromaterial_typesContrattotext
ParametrooptionalContratton, response_format, stream
ParametronContratto1
ParametrostreamContrattofalse
Parametroresponse_formatContrattourl, b64_json
Parametroreference_imagesContrattofalse
ParametroeditContrattofalse
Parametrooutput_format_optionalContratto
Parametroresolution_controlContrattonull
Parametroaspect_ratio_controlContrattonull
Parametroother_fieldsContrattorifiutato salvo l'instradamento interno esatto del fornitore fissato

Ciclo di vita: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · task_id effettivamente restituito o record della libreria multimediale

GET /v1/media/assets/{asset_id}/content

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Genera un'immagine dal prompt.

Salva ogni elemento di dati; url/b64_json sono codifiche del risultato.

Tariffe

Calcolo del costo finale

Le tariffe visualizzate stimano il costo prima della generazione. L'addebito finale viene calcolato in base al costo registrato per la generazione originale. La durata misurata dell'output e le quantità previste non costituiscono la quantità finale fatturabile.

Le tariffe non aggiungono opzioni alla richiesta. I parametri supportati sono elencati nel metodo selezionato.

Modalità rapida
Non specificato Quando è selezionata la modalità rapida
Modalità flex
Non specificato Quando è selezionata la modalità flex
Sforzo massimo di ragionamento
Non specificato Quando lo sforzo massimo di ragionamento usa l'adeguamento predefinito (default)

Tariffe stimate per il confronto

Prezzi per configurazione

Associa ogni costo alle condizioni indicate. Usa una sola tariffa per ogni insieme di configurazioni alternative.

ConfigurazioneListino delle tariffeQuantità previstaUnità di fatturazioneCosto
ConfigurazioneTariffe base dei tokenListino delle tariffeTariffa baseQuantità prevista—Unità di fatturazione—Costo
Input · Token in input · Stima solo a fini di confronto — / 1K token
Output · Token in output · Stima solo a fini di confronto — / 1K token
Input · Lettura dalla cache · Stima solo a fini di confronto — / 1K token
Input · Scrittura nella cache · Stima solo a fini di confronto — / 1K token
Input · Scrittura nella cache, 1 ora · Stima solo a fini di confronto — / 1K token
Configurazioneimmagine in ingressoListino delle tariffe—Quantità prevista—Unità di fatturazioneper immagine in inputCosto
Input · immagine in ingresso · Stima solo a fini di confronto $0 per immagine in input
ConfigurazioneUltraListino delle tariffe—Quantità prevista—Unità di fatturazioneper immagine in outputCosto
Output · immagine in uscita · Stima solo a fini di confronto $0.036 per immagine in output
ConfigurazioneCosto stimato della generazioneListino delle tariffe—Quantità previstastima per una generazioneUnità di fatturazione—Costo
Output · Costo di generazione stimato · Stima solo a fini di confronto $0.036 stima prima della generazione

Questa stima non è un addebito aggiuntivo né una tariffa fissa per la generazione completata.

Ailoot prenota un importo stimato prima di una richiesta. Dopo il risultato, addebita il costo finale in base all’utilizzo misurato. Per lo streaming, l’addebito usa il record finale di utilizzo. Come funzionano la prenotazione e l’addebito finale →

Dettagli della tariffa di riferimento

I listini di riferimento del modello non modificano la selezione del metodo, i preventivi o gli addebiti. Gli addebiti attivi usano le tariffe del metodo Ailoot selezionato.

Configurazioni tariffarie per le immagini

Prezzi per configurazione

Associa ogni costo alle condizioni indicate. Usa una sola tariffa per ogni insieme di configurazioni alternative.

ConfigurazioneCondizioni di fatturazioneCosto
ConfigurazioneImmagine in uscitaCondizioni di fatturazioneNon è dichiarata alcuna variante tariffaria.Costo
Output · Immagine in uscita $0.036 per immagine
ConfigurazioneImmagine in ingressoCondizioni di fatturazioneNon è dichiarata alcuna variante tariffaria.Costo
Input · Immagine in ingresso $0 per immagine

Le voci equivalenti descrivono lo stesso addebito; non aggiungono un secondo costo.

Esempi di richieste

Ailoot Ultra · Immagini

set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "bytedance-seed/seedream-5-0-flash", "prompt": "A lighthouse on a cliff, watercolor", "n": 1, "response_format": "b64_json"}')\n\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \\\n  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n  --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n    if not items: raise SystemExit("No completed images; retain the full response")\n    for index, item in enumerate(items):\n        encoded=item.get("b64_json")\n        uri=item.get("url", "")\n        if not encoded and uri.startswith("data:image/"):\n            header, separator, encoded=uri.partition(",")\n            if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")\n        if encoded:\n            raw=base64.b64decode(encoded,validate=True)\n        elif uri:\n            uri=urljoin("https://api.ailoot.ai",uri)\n            parsed=urlsplit(uri)\n            if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:\n                raise SystemExit("Invalid returned image URL")\n            owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")\n            args=["curl","--fail-with-body","--silent","--show-error",uri]\n            if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n            temporary=Path(f"image-{index}.bin")\n            subprocess.run(args+["-o",str(temporary)],check=True)\n            raw=temporary.read_bytes()\n            temporary.unlink()\n        else: raise SystemExit("Image has neither bytes nor URL")\n        if not raw: raise SystemExit("Empty image result")\n        ext="png" if raw.startswith(b"\\x89PNG") else "jpg" if raw.startswith(b"\\xff\\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"\n        Path(f"image-{index}.{ext}").write_bytes(raw)\n    print("Every returned image saved; complete response metadata retained")\nsave_images(json.loads(Path("result.json").read_text())["data"])\nPY_RESULT\n

Ricevi e salva i risultati

Ailoot Ultra · Immagini

Scarica ogni immagine restituita o salvane il contenuto Base64

  • GET /v1/media/tasks/{task_id}
  • GET /v1/media/assets/{asset_id}/content
  • GET /v1/media/assets
  • GET /v1/media/assets/{asset_id}
Conserva tutti i risultati completati

Salva ogni immagine completata; recupera ogni URL restituito oppure decodificane il contenuto Base64.

Salva ogni elemento data. Decodifica ogni b64_json o recupera ogni URL firmato restituito. Scegli l'estensione del nome del file in base al MIME e ai byte effettivi.

Se occorre verificare la risposta originale

Se il risultato di una generazione o modifica di immagini richiede una verifica, conserva operation_id/X-Client-Request-ID originale e le informazioni sul risultato restituito. Recupera i risultati esistenti che ti appartengono tramite la libreria multimediale usando i valori effettivi di task_id o asset_id. Non reinviare la richiesta di generazione/modifica e non costruire un URL di polling a partire da operation_id.

Campi della risposta
CampoTipo
CampocreatedTipointeger
Campodata[].urlTipostring
Campodata[].b64_jsonTipobase64 string
CampousageTipoobject
Errori e passaggi successivi
RispostaCondizionePassaggio successivo
Risposta400 · invalid_request_errorCondizioneCampi obbligatori, rappresentazione del materiale o valore del parametro non validiPassaggio successivoCorreggi i campi indicati prima di una nuova richiesta di creazione.
Rispostaserver_errorCondizioneLa risposta restituita indica che l'operazione o il risultato richiede una verificaPassaggio successivoConserva l'ID originale di operazione/task restituito, gli header della richiesta e la risposta; continua a leggere l'operazione originale tramite le modalità supportate. Non reinviare la richiesta di creazione.

Alias

Alias del modello

Ailoot Ultra bytedance-seed/seedream-5-0-flash

Alias dei percorsi dei metodi

Usa i percorsi dei metodi indicati sopra.

ID di chiamata correlati

bytedance-seed/seedream-5-0-flash

", "method_identity": { "effective_request_model_id": "bytedance-seed/seedream-5-0-flash", "fmt": "images", "http": "POST", "path": "/v1/images/generations", "request_model_id": "bytedance-seed/seedream-5-0-flash", "route_label": "Ultra" }, "method_key": "Ultra|images|/v1/images/generations|bytedance-seed%2Fseedream-5-0-flash", "ordinal": 0, "rawMethod": { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "Le tariffe visualizzate stimano il costo prima della generazione. L'addebito finale viene calcolato in base al costo registrato per la generazione originale. La durata misurata dell'output e le quantità previste non costituiscono la quantità finale fatturabile.", "forecast_quantity_is_estimate": true, "physical_output_is_billable_quantity": false, "version": "original_invoice_usd_v1" }, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "Save every data item. Decode each b64_json or fetch every returned signed URL. Select a filename extension from the actual MIME/bytes.", "errors": [ { "code": null, "condition": "Campi obbligatori, rappresentazione del materiale o valore del parametro non validi", "http_status": 400, "recovery": "Correggi i campi indicati prima di una nuova richiesta di creazione.", "type": "invalid_request_error" }, { "code": null, "condition": "La risposta restituita indica che l'operazione o il risultato richiede una verifica", "http_status": null, "recovery": "Conserva l'ID originale di operazione/task restituito, gli header della richiesta e la risposta; continua a leggere l'operazione originale tramite le modalità supportate. Non reinviare la richiesta di creazione.", "type": "server_error" } ], "hints": [], "ignored_fields": [], "lifecycle": { "all_results": "Follow everyactualreturnedoutputandownedasset; no result is discardedbecauseindex0orcontent_urlalreadyexists.", "assets": [ { "http": "GET", "path": "/v1/media/assets" }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "content": [ { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "exact returned signed URL; never construct token" } ], "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "status": [ { "http": "GET", "id_source": "actual returned task_id or media library record", "path": "/v1/media/tasks/{task_id}" } ], "unknown": "Se il risultato di una generazione o modifica di immagini richiede una verifica, conserva operation_id/X-Client-Request-ID originale e le informazioni sul risultato restituito. Recupera i risultati esistenti che ti appartengono tramite la libreria multimediale usando i valori effettivi di task_id o asset_id. Non reinviare la richiesta di generazione/modifica e non costruire un URL di polling a partire da operation_id." }, "material_combinations": [ { "content_type": "application/json", "mode": "text_to_image", "reference_images": false, "required": [ "prompt" ] } ], "media_library": { "asset": { "fields": [ { "description": null, "name": "asset_id", "type": "string" }, { "description": null, "name": "task_id", "type": "string" }, { "description": null, "name": "output_key", "type": "string" }, { "description": null, "name": "family", "type": "string" }, { "description": null, "name": "model", "type": "string" }, { "description": null, "name": "method", "type": "string" }, { "description": null, "name": "status", "type": "string" }, { "description": null, "name": "content_type", "type": "string" }, { "description": null, "name": "sha256", "type": "string" }, { "description": null, "name": "size_bytes", "type": "integer" }, { "description": null, "name": "content_url", "type": "string" } ], "http": "GET", "id_source": "actual returned asset_id", "path": "/v1/media/assets/{asset_id}" }, "content": { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "range_header_supported": true, "url_source": "Use exact returned signed content_url including its token; do not construct a token." }, "expired_link": { "code": "link_expired", "http_status": 404, "recovery": "Read the asset again to obtain its refreshed signed content_url, then fetch that URL. Do not regenerate." }, "list": { "all_pages": "Follow every returned next_cursor, then select records by their actual task_id/output_key.", "http": "GET", "output_fields": [ { "description": null, "name": "object", "type": "string" }, { "description": null, "name": "data", "type": "asset[]" }, { "description": null, "name": "next_cursor", "type": "string|null" } ], "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "family", "required": false, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "cursor", "required": false, "type": "string" }, { "availability": "source_interface", "default": 20, "default_known": true, "enum": null, "enum_known": false, "maximum": 100, "minimum": 1, "name": "limit", "required": false, "type": "integer" } ], "path": "/v1/media/assets" }, "revoke": { "http": "DELETE", "meaning": "Revokes/deletes the existing owned file; this is not generation cancellation.", "path": "/v1/media/assets/{asset_id}", "pending_status": "revoking", "success_statuses": [ 202, 204 ] }, "task": { "http": "GET", "id_source": "actual returned task_id or media library record; operation_id is not task_id", "path": "/v1/media/tasks/{task_id}" } }, "operation_modes": [ "text_to_image" ], "outputs": { "all_results": "Salva ogni elemento data. Decodifica ogni b64_json o recupera ogni URL firmato restituito. Scegli l'estensione del nome del file in base al MIME e ai byte effettivi.", "count": 1, "family": "image", "fields": [ { "description": null, "name": "created", "type": "integer" }, { "description": null, "name": "data[].url", "type": "string" }, { "description": null, "name": "data[].b64_json", "type": "base64 string" }, { "description": null, "name": "usage", "type": "object" } ], "format": "actual validated raster MIME" }, "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "bytedance-seed/seedream-5-0-flash" ], "enum_known": true, "name": "model", "required": true, "type": "string" }, { "availability": "source_interface", "conditions": "Prompt UTF8 non vuoto. Non viene inventato alcun limite di caratteri valido per tutti i modelli del produttore.", "default": null, "default_known": false, "enum": null, "enum_known": false, "min_length": 1, "name": "prompt", "required": true, "type": "string" }, { "availability": "source_interface", "default": 1, "default_known": true, "enum": [ 1 ], "enum_known": true, "name": "n", "required": false, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "url", "b64_json" ], "enum_known": true, "name": "response_format", "required": false, "type": "string" }, { "availability": "source_interface", "default": false, "default_known": true, "enum": [ false ], "enum_known": true, "name": "stream", "required": false, "type": "boolean" } ], "profile_binding": "Exact existing Ailoot model and method; interface constraints below do not assert provider qualification.", "unsupported": [ "image edits/references", "resolution/size", "aspect_ratio", "stream=true", "n other than1", "other fields outside this exact facade profile", "output_format field must be omitted" ] }, "hints": [ "Genera un'immagine dal prompt.", "Salva ogni elemento di dati; url/b64_json sono codifiche del risultato." ], "input": { "aspect_ratio_control": null, "content_type": "application/json", "edit": false, "material_types": [ "text" ], "n": [ 1 ], "optional": [ "n", "response_format", "stream" ], "other_fields": "rifiutato salvo l'instradamento interno esatto del fornitore fissato", "output_format_optional": [], "reference_images": false, "required": [ "model", "prompt" ], "resolution_control": null, "response_format": [ "url", "b64_json" ], "stream": [ false ] }, "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets" }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "content": [ { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "exact returned signed URL; never construct token" } ], "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "status": [ { "http": "GET", "id_source": "task_id effettivamente restituito o record della libreria multimediale", "path": "/v1/media/tasks/{task_id}" } ], "unknown": "If an image generation or edit result requires a check, keep the original operation_id/X-Client-Request-ID and returned result information. Recover existing owned results through the media library using actual task_id or asset_id values. Do not resubmit the generation/edit request or construct a polling URL from operation_id." }, "manufacturer_capability": null, "method": { "http": "POST", "path": "/v1/images/generations" }, "method_aliases": [], "operation_modes": [ "text_to_image" ], "output": { "count": 1, "family": "image", "format": "validated raster MIME", "result": "actual owned URL or b64_json" } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "quoted_unit": "per input image" }, "label": "immagine in ingresso", "units": [ { "amount": "0", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "image_input", "label": "input image", "native_amount_usd_per_unit": "0", "native_quantity": 1, "public_unit_label": "per input image", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "image_input" } ] }, { "dimensions": { "quoted_unit": "per image output" }, "label": "Ultra", "units": [ { "amount": "0.036", "amount_unit": "usd_per_exact_physical_unit", "billing_input": false, "estimate_only": true, "key": "image_output", "label": "image output", "native_amount_usd_per_unit": "0.036", "native_quantity": 1, "public_unit_label": "per image output", "quantity": "1", "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "image_output" } ] }, { "basis": "Questa stima non è un addebito aggiuntivo né una tariffa fissa per la generazione completata.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Costo stimato della generazione", "units": [ { "amount": "0.036", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.036", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "examples": [ { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\nexport AILOOT_API_KEY\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{\"model\": \"bytedance-seed/seedream-5-0-flash\", \"prompt\": \"A lighthouse on a cliff, watercolor\", \"n\": 1, \"response_format\": \"b64_json\"}')\n\nPath(\"request.json\").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n if not items: raise SystemExit(\"No completed images; retain the full response\")\n for index, item in enumerate(items):\n encoded=item.get(\"b64_json\")\n uri=item.get(\"url\", \"\")\n if not encoded and uri.startswith(\"data:image/\"):\n header, separator, encoded=uri.partition(\",\")\n if not separator or \";base64\" not in header: raise SystemExit(\"Unsupported image data URI\")\n if encoded:\n raw=base64.b64decode(encoded,validate=True)\n elif uri:\n uri=urljoin(\"https://api.ailoot.ai\",uri)\n parsed=urlsplit(uri)\n if parsed.scheme!=\"https\" or not parsed.netloc or parsed.username or parsed.password:\n raise SystemExit(\"Invalid returned image URL\")\n owned=parsed.netloc==\"api.ailoot.ai\" and parsed.path.startswith(\"/v1/media/assets/\") and parsed.path.endswith(\"/content\")\n args=[\"curl\",\"--fail-with-body\",\"--silent\",\"--show-error\",uri]\n if owned: args += [\"-H\",\"Authorization: Bearer \"+os.environ[\"AILOOT_API_KEY\"]]\n temporary=Path(f\"image-{index}.bin\")\n subprocess.run(args+[\"-o\",str(temporary)],check=True)\n raw=temporary.read_bytes()\n temporary.unlink()\n else: raise SystemExit(\"Image has neither bytes nor URL\")\n if not raw: raise SystemExit(\"Empty image result\")\n ext=\"png\" if raw.startswith(b\"\\x89PNG\") else \"jpg\" if raw.startswith(b\"\\xff\\xd8\") else \"webp\" if raw[:4]==b\"RIFF\" and raw[8:12]==b\"WEBP\" else \"svg\" if raw.lstrip().startswith((b\" e con coordinate normalizzate a 0–999 rispetto all’immagine in ingresso specificata. Un punto contiene x e y; un riquadro contiene coordinate superiore sinistra e inferiore destra. Identifica numero dell’immagine e oggetto destinatario, soprattutto quando un riquadro include più soggetti. Per una modifica fra immagini, distingui l’oggetto da prendere da un riferimento e la zona di destinazione in un altro.\n\nUsa le dimensioni proprie dell’immagine visualizzata nell’ottenere la posizione proporzionale; zoom del canvas, panoramica o coordinate del browser non sono coordinate normalizzate dell’immagine. Descrivi le zone protette oltre a quella modificata. Confronta prospettiva, illuminazione e dettagli circostanti del risultato con la sorgente originale.\n\nSepara una composizione in livelli modificabili\n\nLa scomposizione in livelli è una modalità distinta che accetta esattamente un’immagine e restituisce un’immagine base e fino a 16 livelli indipendenti. Ogni livello è un PNG con alfa. Un prompt può nominare gli elementi da separare, come titolo, soggetto principale e decorazioni; senza un prompt di scomposizione, il modello identifica automaticamente gli elementi principali.\n\nI risultati includono nomi dei livelli, descrizioni, ordine di sovrapposizione e riquadri di collocazione. Usa l’immagine base con indice di sovrapposizione zero, poi colloca gli altri livelli in ordine crescente. I riquadri assoluti descrivono la collocazione nell’immagine base d’output; quelli normalizzati descrivono la collocazione proporzionale su un canvas diverso. Conserva questi metadati di collocazione restituiti con i file immagine affinché la composizione originale possa essere ricostruita prima di riordinarla.\n\nPer una revisione di poster, separa la grafica principale da titolo e decorazioni, poi ispeziona bordi e ogni area di sfondo ripristinata. Un livello trasparente può essere modificato come unico input con canale alfa e output PNG trasparente. L’opzione di sfondo trasparente riguarda quel flusso di modifica immagine a input singolo; la generazione text-to-image ordinaria è un’operazione separata.\n\nComposizione multilingue\n\nOltre a cinese e inglese, il produttore documenta supporto nativo per prompt e testo nelle immagini in russo, arabo, filippino, thailandese, turco, coreano, malese, spagnolo, portoghese, indonesiano, francese, tedesco, vietnamita e giapponese. Fornisci il testo approvato esatto e la direzione di lettura e identifica quale zona contiene ogni blocco testuale. Controlla accenti, caratteri uniti, interruzioni di riga e piccole etichette nell’immagine finale.\n\nFile di riferimento e specifiche d’output\n\nLa generazione immagini accetta fino a 10 riferimenti in JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC o HEIF. Ciascuno può arrivare a 30 MB, con entrambi i lati superiori a 14 pixel, 196–36.000.000 pixel totali e rapporto d’aspetto da 1:16 a 16:1. La scomposizione in livelli richiede invece un JPEG o PNG di 262.144–36.000.000 pixel, fino a 30 MB, entro lo stesso intervallo di rapporti.\n\nLa generazione offre fasce d’output 1K, 1.5K e 2K, con 2K predefinita, oppure dimensioni esplicite con 921.600–4.624.220 pixel totali e rapporti da 1:16 a 16:1. Entrambi i vincoli si applicano alle dimensioni personalizzate. L’output dei livelli usa 1K, 1.5K, 2K o auto, con auto predefinito; base e ciascun livello mantengono i rispettivi rapporti d’aspetto sorgente.\n\nLe immagini finite sono JPEG o PNG. Il formato dell’immagine base può essere scelto separatamente, mentre i livelli scomposti restano PNG con alfa. La consegna può usare dati immagine codificati o link di download conservati per 24 ore. Salva ogni immagine restituita e i suoi metadati per il flusso di design previsto. Ispeziona testo, dettagli modificati e allineamento dei livelli alle dimensioni d’uso dell’elaborato.", "alias_of": null, "aliases": [], "author": "ByteDance Seed", "available": null, "canonical_model": "bytedance-seed/seedream-5-0-flash", "capabilities": { "context_length": 0, "manufacturer_input": [ "text", "image" ], "manufacturer_output": [ "image" ] }, "card_routes": [ { "label": "Ultra", "rates": [ { "amount": "0.036", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.036", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ], "summary": "Tutte le tariffe della configurazione sono riportate nei dettagli." } ], "ctx": null, "declared_tariff_references": [ { "client_selectable": false, "key": "c28268da12f5c8a4b252dcc4", "label": "Configurazioni tariffarie per le immagini", "profiles": [ { "basis": "Le voci equivalenti descrivono lo stesso addebito; non aggiungono un secondo costo.", "dimensions": { "conditions": "Non è dichiarata alcuna variante tariffaria." }, "label": "Immagine in uscita", "units": [ { "amount": "0.036", "amount_unit": "usd_per_image", "billing_input": false, "key": "output_image", "label": "Output image", "public_unit_label": "per image", "quantity": 1, "rate_role": "typed_image_reference", "side": "out", "unit": "image" } ] }, { "basis": "Le voci equivalenti descrivono lo stesso addebito; non aggiungono un secondo costo.", "dimensions": { "conditions": "Non è dichiarata alcuna variante tariffaria." }, "label": "Immagine in ingresso", "units": [ { "amount": "0", "amount_unit": "usd_per_image", "billing_input": false, "key": "input_image", "label": "Input image", "public_unit_label": "per image", "quantity": 1, "rate_role": "typed_image_reference", "side": "in", "unit": "image" } ] } ] } ], "entity_type": "model", "formats": [ "images" ], "id": "bytedance-seed/seedream-5-0-flash", "input": [ "text" ], "kind": "image", "max_out": null, "methods": [ { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "Le tariffe visualizzate stimano il costo prima della generazione. L'addebito finale viene calcolato in base al costo registrato per la generazione originale. La durata misurata dell'output e le quantità previste non costituiscono la quantità finale fatturabile.", "forecast_quantity_is_estimate": true, "physical_output_is_billable_quantity": false, "version": "original_invoice_usd_v1" }, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "Save every data item. Decode each b64_json or fetch every returned signed URL. Select a filename extension from the actual MIME/bytes.", "errors": [ { "code": null, "condition": "Campi obbligatori, rappresentazione del materiale o valore del parametro non validi", "http_status": 400, "recovery": "Correggi i campi indicati prima di una nuova richiesta di creazione.", "type": "invalid_request_error" }, { "code": null, "condition": "La risposta restituita indica che l'operazione o il risultato richiede una verifica", "http_status": null, "recovery": "Conserva l'ID originale di operazione/task restituito, gli header della richiesta e la risposta; continua a leggere l'operazione originale tramite le modalità supportate. Non reinviare la richiesta di creazione.", "type": "server_error" } ], "hints": [], "ignored_fields": [], "lifecycle": { "all_results": "Follow everyactualreturnedoutputandownedasset; no result is discardedbecauseindex0orcontent_urlalreadyexists.", "assets": [ { "http": "GET", "path": "/v1/media/assets" }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "content": [ { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "exact returned signed URL; never construct token" } ], "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "status": [ { "http": "GET", "id_source": "actual returned task_id or media library record", "path": "/v1/media/tasks/{task_id}" } ], "unknown": "Se il risultato di una generazione o modifica di immagini richiede una verifica, conserva operation_id/X-Client-Request-ID originale e le informazioni sul risultato restituito. Recupera i risultati esistenti che ti appartengono tramite la libreria multimediale usando i valori effettivi di task_id o asset_id. Non reinviare la richiesta di generazione/modifica e non costruire un URL di polling a partire da operation_id." }, "material_combinations": [ { "content_type": "application/json", "mode": "text_to_image", "reference_images": false, "required": [ "prompt" ] } ], "media_library": { "asset": { "fields": [ { "description": null, "name": "asset_id", "type": "string" }, { "description": null, "name": "task_id", "type": "string" }, { "description": null, "name": "output_key", "type": "string" }, { "description": null, "name": "family", "type": "string" }, { "description": null, "name": "model", "type": "string" }, { "description": null, "name": "method", "type": "string" }, { "description": null, "name": "status", "type": "string" }, { "description": null, "name": "content_type", "type": "string" }, { "description": null, "name": "sha256", "type": "string" }, { "description": null, "name": "size_bytes", "type": "integer" }, { "description": null, "name": "content_url", "type": "string" } ], "http": "GET", "id_source": "actual returned asset_id", "path": "/v1/media/assets/{asset_id}" }, "content": { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "range_header_supported": true, "url_source": "Use exact returned signed content_url including its token; do not construct a token." }, "expired_link": { "code": "link_expired", "http_status": 404, "recovery": "Read the asset again to obtain its refreshed signed content_url, then fetch that URL. Do not regenerate." }, "list": { "all_pages": "Follow every returned next_cursor, then select records by their actual task_id/output_key.", "http": "GET", "output_fields": [ { "description": null, "name": "object", "type": "string" }, { "description": null, "name": "data", "type": "asset[]" }, { "description": null, "name": "next_cursor", "type": "string|null" } ], "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "family", "required": false, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "cursor", "required": false, "type": "string" }, { "availability": "source_interface", "default": 20, "default_known": true, "enum": null, "enum_known": false, "maximum": 100, "minimum": 1, "name": "limit", "required": false, "type": "integer" } ], "path": "/v1/media/assets" }, "revoke": { "http": "DELETE", "meaning": "Revokes/deletes the existing owned file; this is not generation cancellation.", "path": "/v1/media/assets/{asset_id}", "pending_status": "revoking", "success_statuses": [ 202, 204 ] }, "task": { "http": "GET", "id_source": "actual returned task_id or media library record; operation_id is not task_id", "path": "/v1/media/tasks/{task_id}" } }, "operation_modes": [ "text_to_image" ], "outputs": { "all_results": "Salva ogni elemento data. Decodifica ogni b64_json o recupera ogni URL firmato restituito. Scegli l'estensione del nome del file in base al MIME e ai byte effettivi.", "count": 1, "family": "image", "fields": [ { "description": null, "name": "created", "type": "integer" }, { "description": null, "name": "data[].url", "type": "string" }, { "description": null, "name": "data[].b64_json", "type": "base64 string" }, { "description": null, "name": "usage", "type": "object" } ], "format": "actual validated raster MIME" }, "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "bytedance-seed/seedream-5-0-flash" ], "enum_known": true, "name": "model", "required": true, "type": "string" }, { "availability": "source_interface", "conditions": "Prompt UTF8 non vuoto. Non viene inventato alcun limite di caratteri valido per tutti i modelli del produttore.", "default": null, "default_known": false, "enum": null, "enum_known": false, "min_length": 1, "name": "prompt", "required": true, "type": "string" }, { "availability": "source_interface", "default": 1, "default_known": true, "enum": [ 1 ], "enum_known": true, "name": "n", "required": false, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "url", "b64_json" ], "enum_known": true, "name": "response_format", "required": false, "type": "string" }, { "availability": "source_interface", "default": false, "default_known": true, "enum": [ false ], "enum_known": true, "name": "stream", "required": false, "type": "boolean" } ], "profile_binding": "Exact existing Ailoot model and method; interface constraints below do not assert provider qualification.", "unsupported": [ "image edits/references", "resolution/size", "aspect_ratio", "stream=true", "n other than1", "other fields outside this exact facade profile", "output_format field must be omitted" ] }, "hints": [ "Genera un'immagine dal prompt.", "Salva ogni elemento di dati; url/b64_json sono codifiche del risultato." ], "input": { "aspect_ratio_control": null, "content_type": "application/json", "edit": false, "material_types": [ "text" ], "n": [ 1 ], "optional": [ "n", "response_format", "stream" ], "other_fields": "rifiutato salvo l'instradamento interno esatto del fornitore fissato", "output_format_optional": [], "reference_images": false, "required": [ "model", "prompt" ], "resolution_control": null, "response_format": [ "url", "b64_json" ], "stream": [ false ] }, "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets" }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "content": [ { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "exact returned signed URL; never construct token" } ], "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "status": [ { "http": "GET", "id_source": "task_id effettivamente restituito o record della libreria multimediale", "path": "/v1/media/tasks/{task_id}" } ], "unknown": "If an image generation or edit result requires a check, keep the original operation_id/X-Client-Request-ID and returned result information. Recover existing owned results through the media library using actual task_id or asset_id values. Do not resubmit the generation/edit request or construct a polling URL from operation_id." }, "manufacturer_capability": null, "method": { "http": "POST", "path": "/v1/images/generations" }, "method_aliases": [], "operation_modes": [ "text_to_image" ], "output": { "count": 1, "family": "image", "format": "validated raster MIME", "result": "actual owned URL or b64_json" } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "quoted_unit": "per input image" }, "label": "immagine in ingresso", "units": [ { "amount": "0", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "image_input", "label": "input image", "native_amount_usd_per_unit": "0", "native_quantity": 1, "public_unit_label": "per input image", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "image_input" } ] }, { "dimensions": { "quoted_unit": "per image output" }, "label": "Ultra", "units": [ { "amount": "0.036", "amount_unit": "usd_per_exact_physical_unit", "billing_input": false, "estimate_only": true, "key": "image_output", "label": "image output", "native_amount_usd_per_unit": "0.036", "native_quantity": 1, "public_unit_label": "per image output", "quantity": "1", "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "image_output" } ] }, { "basis": "Questa stima non è un addebito aggiuntivo né una tariffa fissa per la generazione completata.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Costo stimato della generazione", "units": [ { "amount": "0.036", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.036", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "examples": [ { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\nexport AILOOT_API_KEY\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{\"model\": \"bytedance-seed/seedream-5-0-flash\", \"prompt\": \"A lighthouse on a cliff, watercolor\", \"n\": 1, \"response_format\": \"b64_json\"}')\n\nPath(\"request.json\").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n if not items: raise SystemExit(\"No completed images; retain the full response\")\n for index, item in enumerate(items):\n encoded=item.get(\"b64_json\")\n uri=item.get(\"url\", \"\")\n if not encoded and uri.startswith(\"data:image/\"):\n header, separator, encoded=uri.partition(\",\")\n if not separator or \";base64\" not in header: raise SystemExit(\"Unsupported image data URI\")\n if encoded:\n raw=base64.b64decode(encoded,validate=True)\n elif uri:\n uri=urljoin(\"https://api.ailoot.ai\",uri)\n parsed=urlsplit(uri)\n if parsed.scheme!=\"https\" or not parsed.netloc or parsed.username or parsed.password:\n raise SystemExit(\"Invalid returned image URL\")\n owned=parsed.netloc==\"api.ailoot.ai\" and parsed.path.startswith(\"/v1/media/assets/\") and parsed.path.endswith(\"/content\")\n args=[\"curl\",\"--fail-with-body\",\"--silent\",\"--show-error\",uri]\n if owned: args += [\"-H\",\"Authorization: Bearer \"+os.environ[\"AILOOT_API_KEY\"]]\n temporary=Path(f\"image-{index}.bin\")\n subprocess.run(args+[\"-o\",str(temporary)],check=True)\n raw=temporary.read_bytes()\n temporary.unlink()\n else: raise SystemExit(\"Image has neither bytes nor URL\")\n if not raw: raise SystemExit(\"Empty image result\")\n ext=\"png\" if raw.startswith(b\"\\x89PNG\") else \"jpg\" if raw.startswith(b\"\\xff\\xd8\") else \"webp\" if raw[:4]==b\"RIFF\" and raw[8:12]==b\"WEBP\" else \"svg\" if raw.lstrip().startswith((b\"