HiAPI
Hero image in formato cinematografico 21:9: a sinistra uno spazio vuoto con luce morbida, a destra una striscia di pellicola in vetro traslucido e fotogrammi in vetro sospesi che si snodano e si dispiegano, con gradiente iridescente blu ghiaccio, blush e lavanda; la scritta tridimensionale luminosa seedance-2.5-flash è incisa sul fotogramma più grande della striscia di pellicola, come immagine di intestazione della pagina di dettaglio di seedance-2.5-flash/image-to-video.

ByteDance

Seedance 2.5 Flash

seedance-2.5-flash/reference-to-video

La serie di modelli video Seedance 2.5 di ByteDance supporta la generazione di video da testo, la generazione a partire dal primo fotogramma e la generazione con riferimenti multimodali, con output singolo da 4 a 30 secondi, opzioni 480p o 720p e generazione di audio sincronizzato, ideale per la produzione rapida di spot pubblicitari e video di prodotti per l'e-commerce

Prova seedance-2.5-flash/reference-to-video

Input

Output

video
Compila i parametri e genera: i risultati appariranno qui.

Prezzi

seedance-2.5-flash/reference-to-video per second

Specifiche Prezzo unitario
480P $0.0679
720P $0.1525

Panoramica

Per gli sviluppatori che vogliono creare video guidati da materiali di riferimento: basta inserire un prompt e citare in ordine immagini o audio di riferimento per generare un video dalla sequenza visiva continua. È possibile scegliere la risoluzione 480p o 720p, le proporzioni, una durata da 4 a 30 secondi e l'output in mp4 o mov. Ideale per spot pubblicitari brevi, presentazioni di prodotti e video brevi per i social, in tutti i casi in cui serve mantenere lo stile dei materiali esistenti.

Punti di forza principali

  • Generazione guidata da più materiali di riferimento: si possono citare fino a 10 immagini e 5 tracce audio, richiamandole nel prompt in ordine con @image1, @audio1 e così via.
  • Le immagini definiscono il contenuto visivo, l'audio definisce il ritmo: le immagini di riferimento vincolano l'aspetto di personaggi, prodotti e scene, mentre l'audio di riferimento fornisce la musica, il ritmo o la voce fuori campo; i due tipi di materiali possono essere usati da soli o combinati.
  • Durata e proporzioni flessibili: la durata è selezionabile secondo per secondo da 4 a 30 secondi; le proporzioni includono orizzontale, verticale, quadrato e widescreen, oppure si adattano automaticamente ai materiali di riferimento.
  • Output adatto al flusso di post-produzione: oltre al formato mp4, più compatibile, è possibile scegliere il formato mov pensato per la post-produzione professionale.

Descrizione delle capacità

Le immagini di riferimento vincolano il contenuto visivo: si possono inviare fino a 10 immagini di riferimento nei formati jpeg, png, webp, bmp, tiff e gif, ciascuna non superiore a 30MB, con lati da 300 a 6000 pixel; vanno richiamate nel prompt con @image1 e così via.

Durata impostabile a piacere: la durata può essere un numero intero da 4 a 30 secondi oppure -1, per lasciare al modello la decisione automatica in base al contenuto; la fatturazione avviene in base ai secondi del video finale.

Generazione assistita da audio di riferimento: si possono inviare fino a 5 tracce audio di riferimento in wav o mp3, ciascuna da 2 a 30 secondi e non superiore a 15MB, per un totale non superiore a 30 secondi; l'audio può essere usato anche da solo, senza immagini di riferimento.

Impostazioni di proporzioni, risoluzione e formato: la risoluzione di output può essere 480p o 720p; le proporzioni supportano 16:9, 4:3, 1:1, 3:4, 9:16, 21:9 e adaptive; l'output è selezionabile tra mp4 e mov.

Scenari di utilizzo

  • Produzione di video brevi per team di brand e agenzie: utilizzando immagini di prodotto e musiche di brand esistenti come riferimento, si generano inquadrature continue con introduzione, movimento di camera e chiusura, per confrontare versioni creative prima della pubblicazione.
  • Inquadrature per la presentazione di prodotti e-commerce: inserendo più immagini di prodotto e citandole una a una nel prompt, si generano video di presentazione o di utilizzo, da inserire nelle pagine di dettaglio prodotto o negli annunci in-feed.
  • Video brevi verticali per piattaforme social: scegliendo il formato 9:16 o 1:1, si generano video brevi con riferimenti a immagini e audio, per l'aggiornamento quotidiano dei contenuti su piattaforme di video brevi e social media.
  • Video brevi con musica o voce fuori campo: inviando immagini di persone o prodotti e una traccia audio di riferimento, si fa seguire il movimento delle immagini al ritmo dell'audio, per video di presentazione con musica o brevi video con voce fuori campo.

Limiti e consigli per la scelta

Le immagini di riferimento sono al massimo 10, le tracce audio di riferimento al massimo 5 per un totale non superiore a 30 secondi; se si superano questi limiti, occorre suddividere la generazione in più passaggi. La risoluzione di output è disponibile solo in 480p e 720p, e le proporzioni non includono formati ultrawide o personalizzati. La durata massima di una singola generazione è di 30 secondi; per contenuti più lunghi occorre generare più segmenti e montarli. I materiali di riferimento sono soggetti a limiti di formato, dimensione e intervallo di pixel: i file non conformi non possono essere inviati.

Modello video di ByteDance guidato da riferimenti

Generare video continui guidati da materiali di riferimento

Inviando un prompt con riferimenti a immagini o audio, il modello interpreta i materiali nell'ordine citato e genera una sequenza video coerente. L'output supporta 480p e 720p, varie proporzioni e i formati mp4 o mov.

  • Tipo di outputVideo
  • Risoluzione480p / 720p
  • Durata4–30 secondi, oppure -1 per automatico
  • Materiali di riferimentoFino a 10 immagini / 5 audio

Nel prompt, citate i materiali in ordine con @image1, @audio1 e indicate chiaramente il ruolo di ciascun materiale.

01

Capacità

Come si comporta: tre capacità verificabili

Le tre capacità seguenti corrispondono rispettivamente a riferimenti immagine, riferimenti audio e specifiche di output; è possibile verificarle una per una prima di organizzare il prompt.

I riferimenti immagine stabiliscono la base visiva

Caricate fino a 10 immagini come riferimento di contenuto, nei formati bitmap più comuni, con limiti su dimensione e intervallo di pixel per singolo file. Citandole nel prompt in ordine con @image1 e così via, potete indicare quale immagine corrisponde a quale soggetto o scena. Il controllo principale è che i numeri di riferimento coincidano con l'ordine dei materiali.

I riferimenti audio guidano la generazione

Potete inviare fino a 5 tracce audio wav o mp3, ciascuna da 2 a 30 secondi e per un totale non superiore a 30 secondi. L'audio può essere usato da solo o combinato con le immagini, citandolo nel prompt con @audio1. Il controllo principale è che dimensione e durata di ogni traccia rientrino nei limiti.

Specifiche e formato di output

La risoluzione si sceglie tra 480p e 720p; le proporzioni coprono orizzontale, verticale, quadrato e widescreen, oppure si impostano su adaptive per seguire i materiali. Il formato di output può essere mp4, più compatibile, o mov, pensato per la post-produzione. Verificate che le proporzioni siano coerenti con il canale di distribuzione.

Il numero, il formato e la durata dei materiali di riferimento determinano ciò che è possibile inviare; l'ordine dei riferimenti nel prompt determina come i materiali partecipano alla costruzione dell'immagine.

02

Guida rapida

Dai materiali di riferimento alla sequenza video

Provalo subito →

Partite da uno scopo chiaro, preparate materiali di riferimento conformi, organizzate un prompt con i numeri di riferimento e infine verificate il video finale in base alle specifiche di output.

  • Immagini di riferimentojpeg/png/webp/bmp/tiff/gif, ≤30MB per file
  • Audio di riferimentowav/mp3, 2–30 secondi, totale ≤30 secondi

Un set di materiali di riferimento conformi ai limiti

01

Preparate i materiali di riferimento

Stabilite innanzitutto se il riferimento deve essere un'immagine o un audio, quindi selezionate i file in base ai requisiti di formato, dimensione, pixel e durata, evitando di caricare tipi non supportati.

  • Promptfino a 5000 caratteri, citate i materiali in ordine

Un prompt che associa materiali e istruzioni

02

Scrivete un prompt con i riferimenti

Citate i materiali in ordine con @image1, @audio1, descrivete il contenuto e le azioni della scena e indicate a quale parte dell'audio deve corrispondere il video.

Durata4–30 secondi, oppure -1 per automatico

✓Verifica

→

Proporzioni16:9, 9:16, 1:1 ecc., oppure adaptive

03

Impostate i parametri di output e verificate

Scegliete durata, risoluzione, proporzioni e formato di output, quindi controllate che il numero di materiali di riferimento e la durata totale dell'audio non superino i limiti.

03

Scenari

Dove usarlo: tre tipi di video brevi

Confronto tra versioni creative di spot pubblicitari

Usando immagini di prodotto e musiche di brand come riferimento, si generano inquadrature continue con movimenti di camera e azioni conclusive. Ideale per preparare più direzioni creative prima della pubblicazione; il controllo principale è che l'aspetto del prodotto nei materiali di riferimento resti coerente nel video.

Presentazione di prodotti nelle pagine di dettaglio e-commerce

Inviate più immagini di prodotto e citatele una a una nel prompt per generare video di presentazione o di utilizzo. Il video finale può essere inserito direttamente nella pagina di dettaglio prodotto o negli annunci in-feed; il controllo principale è che il soggetto sia chiaramente riconoscibile nell'inquadratura.

Video brevi con voce fuori campo o musica, basati su immagini e audio di riferimento

Le immagini di riferimento definiscono persone o prodotti, l'audio di riferimento definisce il ritmo o la voce, generando un video breve in cui le immagini seguono l'avanzare dell'audio. Adatto a presentazioni con voce fuori campo e video di presentazione con musica; il controllo principale è che i movimenti siano sincronizzati con il ritmo dell'audio.

04

Integrazione

Integrazione: richiamare seedance-2.5-flash nel vostro prodotto o strumento AI

Basta una API Key di HiAPI: tutti i metodi condividono lo stesso account e la stessa fatturazione.

  1. Create una API Key

    Vai alla console →

  2. Scegliete un metodo di integrazione

    A destra sceglietene uno e copiatelo

  • Strumenti di programmazione AI consigliato

    Claude Code, Cursor, Codex e altri strumenti via comando con MCP

  • API diretta

    Il vostro prodotto, servizi backend, flussi automatizzati

  • Non sapete quale scegliere

    Copiate un messaggio all'AI e lasciate che scelga e vi dia i passaggi

Agent Skills · SDK · llms.txt · Tutti i metodi di integrazione →

Terminale · Claude Code

claude mcp add --transport http hiapi https://mcp.hiapi.ai/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

Una volta collegato, dite direttamente all'AI il vostro obiettivo e lasciate che richiami seedance-2.5-flash, controlli l'avanzamento dell'attività e ottenga il risultato. I passaggi di configurazione per Cursor, Codex e altri strumenti sono nella guida qui sotto.

Vedi la guida all'integrazione degli Agent →

Integrate l'API nel vostro prodotto

Usate la API Key per inviare un'attività per il modello corrente e controllate lo stato tramite l'ID attività restituito. I parametri della richiesta usano gli stessi dati di rete della documentazione API di questa pagina; sostituite i contenuti di input degli esempi con i vostri materiali reali.

# Invia un'attività asincrona; restituisce subito un taskId (senza attendere la generazione)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "seedance-2.5-flash/reference-to-video",
  "input": {
    "prompt": "…",
    "duration": 5,
    "resolution": "480p",
    "aspect_ratio": "adaptive",
    "output_format": "mp4",
    "generate_audio": true,
    "omni_reference_task_type": "reference"
  }
}'
Vedi la documentazione API completa di questa pagina →

Lasciate che l'AI scelga il metodo di integrazione per voi

Leggi l'indice della documentazione HiAPI https://hiapi.ai/llms.txt. Voglio usare seedance-2.5-flash nel mio progetto. In base al mio scenario d'uso, valuta prima se è più adatto Remote MCP, Agent Skills o l'API diretta; se necessario, fammi prima una domanda chiave, poi indicami i passaggi di integrazione più semplici e la configurazione da inserire.

Copiate questo messaggio nello strumento AI che usate, aggiungendo il linguaggio del progetto, i materiali di input e il risultato atteso. In base a ciò potrà indicarvi il metodo di integrazione e i passaggi successivi.

  • Nuovo modello Rilascio di seedance-2.5-flash/reference-to-video
  • Nuovo modello seedance-2.5-flash/image-to-video ora disponibile
  • Nuovo modello Lancio di seedance-2.5-flash/text-to-video

Modelli correlati

Vedi tutti i modelli →

Stesso tipo