Seedance 2.5 Flash API
O Seedance 2.5 Flash é a versão mais rápida do modelo de vídeo Seedance 2.5 da ByteDance e gera vídeos em 480p e 720p a partir de texto, imagens, vídeos de referência e áudio. Use este espaço de trabalho da APIMart para preparar uma requisição seedance-2.5-flash e, depois, confira o exemplo e os parâmetros da Seedance 2.5 Flash API abaixo.
Espaço de trabalho da Seedance 2.5 Flash API
- 480p ou 720p, 4–30 segundos ou Auto
- Até 10 imagens, 5 vídeos e 5 áudios
- Tipos de tarefa, áudio, MP4/MOV e último quadro
Sem valor ou com auto, o modelo decide. reference usa suas referências; edit e extend exigem pelo menos um vídeo de referência.
Até 10 imagens, 5 vídeos e 5 áudios por solicitação. Informe URLs http(s) públicas ou IDs asset://.
Seu vídeo aparecerá aqui
Seedance 2.5 Flash API: geração de vídeo mais rápida em 480p e 720p
O modelo Seedance 2.5 Flash foi feito para velocidade. Prepare uma requisição para saída em 480p ou 720p: descreva a tomada, escolha um tipo de tarefa e adicione imagens, vídeos de referência ou áudio. Revise tudo como formulário ou como JSON antes de chamar a API.
Exemplo da Seedance 2.5 Flash API: texto para vídeo e imagem para vídeo
Os exemplos da Seedance 2.5 Flash API usam o formato comum de tarefas assíncronas da APIMart: envie uma tarefa e consulte-a com o ID de tarefa retornado.
- 1
Autentique as requisições à Seedance 2.5 Flash API
Salve sua API key da APIMart como APIMART_API_KEY. Os exemplos da Seedance 2.5 Flash API enviam Authorization: Bearer <key> no envio e na consulta de tarefas.
- 2
Envie uma tarefa seedance-2.5-flash
Faça POST /v1/videos/generations com model definido como seedance-2.5-flash, seu prompt, size, resolution e duration. Adicione image_urls, video_urls ou audio_urls como referências. Leia o ID da tarefa em data[0].task_id.
- 3
Obtenha o resultado do Seedance 2.5 Flash
Use GET /v1/tasks/{task_id}. Para uma tarefa concluída, leia data.result.videos[0].url[0]; para uma tarefa com falha, leia data.error.message.
Veja a documentação da APIMart para a autenticação da APIMart e o uso geral da API.
curl -X POST https://api.apimart.ai/v1/videos/generations \
-H "Authorization: Bearer $APIMART_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2.5-flash",
"prompt": "Um ciclista pedala por uma estrada costeira ao nascer do sol, a câmera acompanha de lado enquanto as ondas refletem a luz quente",
"size": "16:9",
"resolution": "720p",
"duration": 10
}'import os
import time
import requests
API_BASE = "https://api.apimart.ai"
headers = {"Authorization": f"Bearer {os.environ['APIMART_API_KEY']}"}
# 1. Submit the generation task
payload = {
"model": "seedance-2.5-flash",
"prompt": "Um ciclista pedala por uma estrada costeira ao nascer do sol, a câmera acompanha de lado enquanto as ondas refletem a luz quente",
"size": "16:9",
"resolution": "720p",
"duration": 10
}
resp = requests.post(f"{API_BASE}/v1/videos/generations", headers=headers, json=payload, timeout=60)
resp.raise_for_status()
task_id = resp.json()["data"][0]["task_id"]
# 2. Poll the task until it finishes
for _ in range(200):
task_resp = requests.get(f"{API_BASE}/v1/tasks/{task_id}", headers=headers, timeout=30)
task_resp.raise_for_status()
task = task_resp.json()["data"]
if task["status"] == "completed":
print(task["result"]["videos"][0]["url"][0])
break
if task["status"] == "failed":
raise RuntimeError(task.get("error", {}).get("message", "generation failed"))
time.sleep(10)
else:
raise TimeoutError(f"task {task_id} did not finish in time; continue GET polling with this task ID")curl -X POST https://api.apimart.ai/v1/videos/generations \
-H "Authorization: Bearer $APIMART_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2.5-flash",
"prompt": "O produto da imagem de referência gira devagar em uma base giratória de estúdio branca sob luz suave, enquanto a câmera se aproxima do rótulo",
"image_urls": [
"https://example.com/product.jpg"
],
"size": "16:9",
"resolution": "720p",
"duration": 10
}'TASK_ID="task_xxx" # replace with the task_id returned by the POST request
curl "https://api.apimart.ai/v1/tasks/$TASK_ID" \
-H "Authorization: Bearer $APIMART_API_KEY"Parâmetros da Seedance 2.5 Flash API
| Parâmetro | Tipo | Obrigatório | Padrão | Descrição |
|---|---|---|---|---|
model | string | Sim | Padrão: seedance-2.5-flash | Valor de model neste espaço de trabalho do Seedance 2.5 Flash e nos exemplos: seedance-2.5-flash. |
prompt | string | Sim | Padrão: — | Descrição do vídeo. Cite as entradas pelo índice, como @图片1, @视频1 ou @音频1, na ordem do array. |
resolution | string | Opcional | Padrão: 720p | 480p ou 720p. O Seedance 2.5 Flash não oferece 1080p. |
size | string | Opcional | Padrão: adaptive | Proporção (também aceita como aspect_ratio): 16:9, 4:3, 1:1, 3:4, 9:16, 21:9 ou adaptive. Tarefas de edição, de extensão e só com primeiro/último quadro exigem adaptive. |
duration | integer | Opcional | Padrão: 5 | Duração do clipe: 4–30 segundos, ou -1 para o modelo escolher. Tarefas de edição seguem o vídeo de origem e usam -1. |
generate_audio | boolean | Opcional | Padrão: true | Gera áudio junto com o vídeo (também aceito como audio). Defina false para um vídeo sem som. |
image_urls | array | Opcional | Padrão: — | Imagens de referência como URLs http(s) ou IDs asset://. As imagens contam para o limite de 10 por requisição. Não pode ser usado com image_with_roles. |
image_with_roles | array | Opcional | Padrão: — | Imagens com função: first_frame, last_frame ou reference_image. Um último quadro exige um primeiro quadro; todas as funções contam para o limite de 10 imagens. |
video_urls | array | Opcional | Padrão: — | Até 5 vídeos de referência como URLs http(s) ou IDs asset://. Tarefas de edição e extensão precisam de pelo menos um. |
audio_urls | array | Opcional | Padrão: — | Até 5 áudios de referência como URLs http(s) ou IDs asset://. |
omni_reference_task_type | string | Opcional | Padrão: — | auto, reference, edit ou extend. Deixe sem definir ou use auto para o modelo decidir. |
output_format | string | Opcional | Padrão: mp4 | mp4 ou mov. |
return_last_frame | boolean | Opcional | Padrão: false | Também retorna o último quadro do vídeo como imagem. |
seed | integer | Opcional | Padrão: — | Seed aleatória. A mesma seed gera resultados parecidos, não idênticos. |
watermark | boolean | Opcional | Padrão: false | Adiciona uma marca d'água de conteúdo gerado por IA. |
tools | array | Opcional | Padrão: — | Ferramentas opcionais, como [{"type": "web_search"}] para usar informações da web. |
nsfw_check | boolean | Opcional | Padrão: false | Campo da APIMart: modera o prompt e as imagens de entrada antes do envio da tarefa. |
