Crie vídeos cinematográficos com a API Seedance 2.5 da ByteDance: ao menos um vídeo de referência, imagens/áudio opcionais, seis proporções, 4–30 s, som e 480p/720p.
A API ByteDance Seedance 2.5 Reference-to-Video combina um vídeo de referência obrigatório com recursos opcionais de imagem, áudio e vídeos adicionais para orientar a geração de novos vídeos na Bestimage AI. Desenvolvedores e equipes criativas podem usar referências multimodais para comunicar aparência do sujeito, produtos, ambientes, movimento, ritmo, som e direção visual com mais precisão do que apenas com texto. Controles flexíveis de qualidade, duração, proporção e som gerado tornam a API adequada para conteúdo de marca, fluxos de trabalho com personagens, narrativas de produto e sistemas criativos escaláveis.
Observação É necessário pelo menos um vídeo de referência. As imagens de referência são opcionais e podem ser omitidas quando um vídeo é fornecido; apenas áudio ou imagens não podem substituir a entrada de vídeo obrigatória. Certifique-se de que todos os prompts e mídias estejam em conformidade com as diretrizes de segurança de conteúdo da ByteDance.
Seedance 2.5 Reference-to-Video vs. Seedance 2.5 Text-to-Video
Text-to-Video gera conteúdo apenas a partir de instruções
escritas. Reference-to-Video acrescenta orientação obrigatória por vídeo, além de imagens e áudio opcionais, para fluxos de trabalho que exigem um controle mais
concreto sobre movimento, aparência, sincronização ou estilo.
Seedance 2.5 Reference-to-Video vs. Seedance 2.5 Image-to-Video
Image-to-Video anima um primeiro quadro obrigatório e
pode usar um quadro final opcional. Reference-to-Video começa com material de vídeo obrigatório e pode combiná-lo com recursos opcionais de
imagem e áudio para uma direção multimodal mais ampla.
Seedance 2.5 Reference-to-Video vs. Wan Reference-to-Video
Ambas as abordagens usam mídia enviada para orientar
a geração de novos vídeos. O Seedance 2.5 oferece um fluxo de trabalho com vídeo obrigatório, referências opcionais de várias imagens e áudio, além de
controles de saída flexíveis pela Bestimage AI.
Seedance 2.5 Reference-to-Video vs. Vidu Reference-to-Video
O Vidu oferece criação de vídeos orientada por referências para garantir consistência
visual. O Seedance 2.5 se diferencia pela orientação obrigatória por vídeo e pela capacidade de combinar referências opcionais de imagem e
áudio em uma única solicitação.
Seedance 2.5 Reference-to-Video vs. ferramentas de vídeo Runway
O Runway oferece um amplo conjunto interativo de criação.
A API Seedance 2.5 Reference-to-Video oferece um fluxo de trabalho programático focado em entradas de mídia multimodal, direção de referências baseada em
prompt e geração escalável.
// Step 1: Submit generation request
const response = await fetch('https://api.flaq.ai/api/v1/video/task', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'Authorization': 'Bearer YOUR_API_KEY'
},
body: JSON.stringify({
model_name: 'seedance-v2.5-reference-to-video',
prompt: 'Use image one for the subject, video one for the movement, and audio one for the atmosphere',
resolution: '720p',
duration: 8,
aspect_ratio: '16:9',
sound: true,
images: ['https://example.com/subject-reference.jpg'],
videos: ['https://example.com/motion-reference.mp4'],
audios: ['https://example.com/atmosphere-reference.mp3']
})
});
const { data } = await response.json();
const taskId = data.task_id;
// Use the @ (AT) reference feature in prompt through <<<...>>> placeholders.
// Placeholder numbering is 1-based for each media array:
// <<<image_1>>> = images[0], <<<image_2>>> = images[1]
// <<<video_1>>> = videos[0], <<<audio_1>>> = audios[0]
const mediaReferenceResponse = await fetch('https://api.flaq.ai/api/v1/video/task', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'Authorization': 'Bearer YOUR_API_KEY'
},
body: JSON.stringify({
model_name: 'seedance-v2.5-reference-to-video',
prompt: 'Place the explorer from <<<image_1>>> in the environment from <<<image_2>>>, following the camera movement in <<<video_1>>> and speaking with the reference voice from <<<audio_1>>>',
resolution: '720p',
duration: 10,
aspect_ratio: '16:9',
sound: true,
images: [
'https://example.com/explorer-reference.jpg',
'https://example.com/environment-reference.png'
],
videos: ['https://example.com/camera-movement-reference.mp4'],
audios: ['https://example.com/voice-reference.mp3']
})
});
const { data: mediaReferenceData } = await mediaReferenceResponse.json();
const mediaReferenceTaskId = mediaReferenceData.task_id;
// Step 2: Poll for results
const taskId = data.task_id;
const pollResult = async (taskId) => {
const res = await fetch(`https://api.flaq.ai/api/v1/video/${taskId}`, {
headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
});
return res.json();
};
while (true) {
const pollResultData = await pollResult(taskId);
const status = pollResultData.data.task_status;
if (status === 'succeed') {
console.log(pollResultData.data.task_result.videos[].);
;
}
(status === ) {
.(pollResultData..);
;
}
( (resolve, ));
}
# Step 1: Submit generation request
import requests
response = requests.post(
'https://api.flaq.ai/api/v1/video/task',
headers={
'Content-Type': 'application/json',
'Authorization': 'Bearer YOUR_API_KEY'
},
json={
'model_name': ,
: ,
: ,
: ,
: ,
: ,
: [],
: [],
: []
}
)
result = response.json()
task_id = result[][]
media_reference_response = requests.post(
,
headers={
: ,
:
},
json={
: ,
: ,
: ,
: ,
: ,
: ,
: [
,
],
: [],
: []
}
)
media_reference_result = media_reference_response.json()
media_reference_task_id = media_reference_result[][]
# Step 1: Submit generation request
curl -X POST https://api.flaq.ai/api/v1/video/task \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"model_name": "seedance-v2.5-reference-to-video",
"prompt": "Use image one for the subject, video one for the movement, and audio one for the atmosphere",
"resolution": "720p",
"duration": 8,
"aspect_ratio": "16:9",
"sound": true,
"images": ["https://example.com/subject-reference.jpg"],
"videos": ["https://example.com/motion-reference.mp4"],
"audios": ["https://example.com/atmosphere-reference.mp3"]
}'
# Use the @ (AT) reference feature in prompt through <<<...>>> placeholders.
# Placeholder numbering is 1-based for each media array:
curl -X POST https://api.flaq.ai/api/v1/video/task \
-H \
-H \
-d
# Step 2: Poll for results
task_id = response.json()['data']['task_id']
poll_url = f"https://api.flaq.ai/api/v1/video/{task_id}"
while True:
poll_result = requests.get(poll_url, headers={'Authorization': 'Bearer YOUR_API_KEY'}).json()
status = poll_result['data']['task_status']
if status == 'succeed':
print(poll_result['data']['task_result']['videos'][0]['url'])
break
if status == 'failed':
print(poll_result['data']['task_status_msg'])
break
time.sleep(10)
# Step 2: Poll for results
# Replace {task_id} with the task_id returned from the submit response
curl -X GET "https://api.flaq.ai/api/v1/video/{task_id}" \
-H "Authorization: Bearer YOUR_API_KEY"