API per la Sostituzione Ballo AI per video basati sul movimento

Accedi a ai_dance_replace tramite l'API GoEnhance per sostituire la persona in un video di danza di riferimento con quella proveniente da un'immagine sorgente, mantenendo il movimento di riferimento. Invia un'attività asincrona, salva il relativo img_uuid, quindi esegui il polling o utilizza i callback per il completamento.
Ottieni chiave API
Ballerino che si esibisce in uno studio di produzione cinematografica per i flussi di lavoro dell'API per la Sostituzione Ballo AI

Crea flussi di lavoro video di danza con sostituzione della persona

Definisci la persona da sostituire

Fornisci un image_url pubblico. La persona in quell'immagine diventa il soggetto utilizzato nel video di danza generato, quindi convalida l'URL prima dell'invio.
Configurazione per l'acquisizione di ritratti per un'immagine di una persona utilizzata da un'API di sostituzione danza

Guida il movimento da un video di danza

Fornisci un video_url pubblico contenente la danza di riferimento. Il limite documentato è di 30 secondi; i video più lunghi vengono rifiutati.
Ballerino e cinepresa che catturano il movimento per un flusso di lavoro di sostituzione danza AI
Convalida l'identificatore esatto del modello, gli URL dei media e la risoluzione di output prima dell'invio.

Funzionalità e input dell'API per la Sostituzione Ballo AI

Identificatore esatto del modello

Imposta model su ai_dance_replace; è un campo di richiesta obbligatorio.

Immagine della persona richiesta

Passa image_url come URI pubblico valido per la persona che apparirà nell'output.

Video di danza richiesto

Passa video_url come video di riferimento pubblico non più lungo del massimo documentato di 30 secondi.

Due opzioni di risoluzione

Scegli 480p o 720p. L'impostazione predefinita documentata è 480p.

Consegna callback opzionale

Aggiungi un custom_callback_url HTTPS pubblico per ricevere aggiornamenti su elaborazione, successo e fallimento.

Risposta attività asincrona

Un invio riuscito restituisce img_uuid; conservalo per i controlli di stato e la gestione dei risultati.
La fatturazione utilizza la durata arrotondata per eccesso del video in input. Calcola il costo in base alla risoluzione selezionata e ai secondi fatturati.

Prezzi dell'API di sostituzione danza AI

Prezzi 480p

2 token per secondo di video in input, pari a $0,04 al secondo o $0,20 ogni 5 secondi a $0,02 per token.

Prezzi 720p

4 token per secondo di video in input, pari a $0,08 al secondo o $0,40 ogni 5 secondi a $0,02 per token.

Fatturazione basata sulla durata

La durata del video in input viene arrotondata per eccesso ai fini della fatturazione; stima il costo come secondi fatturati moltiplicati per la tariffa selezionata.

Integra l'API GoEnhance in sei passaggi

1

1. Crea una chiave API

Crea una chiave API GoEnhance e inviala come bearer token nell'intestazione Authorization.
2

2. Convalida entrambi gli URL dei media

Conferma che l'immagine della persona e il video della danza siano raggiungibili pubblicamente e che il video non superi i 30 secondi.
3

3. Costruisci la richiesta

Imposta model: ai_dance_replace, aggiungi image_url e video_url, quindi scegli 480p o 720p.
4

4. Invia l'attività

Invia il corpo JSON tramite POST a https://api.goenhance.ai/api/v1/videos/generations.
5

5. Mantieni e traccia

Salva l'img_uuid restituito, quindi esegui il polling di GET /api/v1/jobs/detail o ricevi eventi di callback.
6

6. Gestisci gli stati terminali

Elabora successo e fallimento in modo idempotente, verifica l'asset restituito ed evita di duplicare il lavoro a valle.
Ottieni chiave API
Utilizza una pipeline multimediale conforme al consenso per strumenti per creator, produzione di campagne e automazione video ripetibile.

Casi d'uso per sviluppatori per video di sostituzione danza

Modelli di danza per creator

Consenti agli utenti di applicare l'immagine di una persona approvata a una danza di riferimento con licenza all'interno di un flusso di creazione guidato.

Varianti video per campagne

Genera varianti del soggetto da media sorgente approvati per revisione interna ed editing a valle.

Test di performance dei personaggi

Esplora come l'immagine di un personaggio fornito segua un riferimento di movimento esistente prima della produzione.

Asset per creator localizzati

Riutilizza un riferimento di danza approvato con soggetti autorizzati diversi per pipeline di contenuti regionali.

Code di contenuti automatizzate

Collega ID attività e callback all'orchestrazione batch senza bloccare il thread di richiesta dell'applicazione.

Prototipa esperienze di movimento

Convalida un concetto di prodotto basato su immagine più movimento prima di investire in una pipeline di acquisizione personalizzata.
Risposte a domande comuni su input, prezzi, stato, callback e integrazione.

FAQ API Sostituzione Danza AI

Quale endpoint utilizza l'API di sostituzione danza AI?

Invia POST https://api.goenhance.ai/api/v1/videos/generations con model: ai_dance_replace, un image_url pubblico e un video_url pubblico.

Come funziona il prezzo dell'API di sostituzione danza AI?

Il prezzo si basa sulla durata del video in input arrotondata per eccesso: 2 token al secondo a 480p e 4 token al secondo a 720p, pari rispettivamente a $0,20 e $0,40 ogni 5 secondi.

Quali campi sono obbligatori?

I campi obbligatori documentati sono model, image_url e video_url. La risoluzione e l'URL di callback sono facoltativi.

Quanto può durare il video di danza di riferimento?

Il massimo documentato è di 30 secondi. Convalida la durata prima dell'invio perché i video più lunghi vengono rifiutati.

Quali risoluzioni di output sono disponibili?

L'endpoint accetta 480p e 720p. Se omesso, il valore predefinito documentato è 480p.

Come verifico lo stato dell'attività?

Conserva l'img_uuid restituito ed effettua il polling di GET /api/v1/jobs/detail, oppure fornisci un URL di callback HTTPS pubblico.

Come vengono gestiti i fallimenti dei callback?

GoEnhance documenta fino a tre tentativi quando il tuo endpoint di callback non restituisce HTTP 200, con un timeout di tre secondi per ogni tentativo.

Quali autorizzazioni dovrebbe richiedere la mia app?

Utilizza solo immagini e video di danza che sei autorizzato a elaborare e ottieni il consenso appropriato dalle persone identificabili nei file multimediali di origine.

Sviluppa con l'API Sostituzione Danza AI