Pular para o conteúdo principal

Sem censura — Este modelo declara não aplicar filtro de conteúdo. A SpicyAPI encaminha a solicitação sem adicionar uma análise de conteúdo da plataforma; as obrigações legais e de consentimento continuam com o cliente.Ver todos os modelos com esse nível de filtragem
bytedance/seedance-2.0/reference-to-video

O reference-to-video Seedance 2.0 da ByteDance constrói uma tomada com o seu material: até 9 imagens, 3 clipes de vídeo e 3 faixas de áudio, sem primeiro quadro. A saída tem 4 a 15 segundos em 480p, 720p, 1080p ou 4K, com áudio nativo.

A partir de $0.043/s
Executar modelo

Playground

Enviar uma requisição

Início rápido

Os exemplos usam as definições públicas de parâmetros do endpoint selecionado. Troque a chave de API e as mídias de exemplo e envie a requisição a partir do seu servidor.

SDKs e integrações
POSThttps://api.spicyapi.ai/api/v1/jobs/createTask

Autenticação da API

Guarde a chave de API na variável de ambiente do servidor SPICY_API_KEY. Use autenticação Bearer e Content-Type: application/json nas requisições JSON.

Authorization: Bearer $SPICY_API_KEY
Resultado de exemploUsar este exemplo
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $SPICY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
  -d '{
  "model": "bytedance/seedance-2.0/reference-to-video",
  "input": {
    "aspect_ratio": "adaptive",
    "bitrate_mode": "standard",
    "duration_seconds": 5,
    "generate_audio": true,
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
    "resolution": "720p",
    "reference_image_urls": [
      "https://example.com/reference.png"
    ]
  }
}'

# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $SPICY_API_KEY"

Gerado a partir do schema de entrada deste modelo — o mesmo que a API usa para validar cada requisição.

Parâmetros de entrada

Coloque estes campos no objeto input do corpo da requisição. Nomes e tipos são os mesmos da API. Quando nenhum valor padrão estiver indicado, não presuma que exista um.

Este modelo tem dependências entre campos. Os campos marcados como obrigatórios sob condição dependem de outras entradas; as regras completas estão no JSON Schema abaixo.

promptstringObrigatório

Obrigatório, e aqui ele também faz o casting. As referências são citadas na ordem de envio, então diga qual imagem é qual personagem, o que cada clipe contribui e para que serve o áudio. Briefings não são revisados do nosso lado; onde a camada do próprio Seedance recusa a formulação, um primeiro quadro no image-to-video é a rota que ainda chega lá.

Valor padrão
Não especificado
watermarkbooleanOpcional

Adiciona ao vídeo a marca-d’água visível “AI generated” do próprio modelo. Desligado por padrão; ligue quando o lugar onde você publica exigir a identificação de conteúdo feito com IA. Não altera o preço.

Valor padrão
false
bitrate_modestringOpcional

Taxa de bits do arquivo entregue: `standard` (padrão) ou `high`. `high` mantém texturas finas e movimentos rápidos mais nítidos na mesma resolução e gera um arquivo bem maior; resolução, taxa de quadros e duração não mudam. Não altera o preço.

Valor padrão
"standard"
Valores permitidos
"standard""high"
return_last_framebooleanOpcional

Devolve também o último quadro do clipe como imagem separada, junto com o vídeo. Mande-o ao image-to-video como próximo quadro inicial para encadear planos sem exportar o quadro você mesmo. Desligado por padrão; não altera o preço.

Valor padrão
false
seedintegerOpcional

Seed inteiro; omita e cada execução sorteia o seu. Fixe com todo o resto constante para julgar o que uma edição de prompt realmente mudou. É ferramenta de comparação, não promessa de repetição quadro a quadro.

Valor padrão
Não especificado
Restrições
minimum:0
maximum:2147483647
generate_audiobooleanOpcional

Ligado por padrão. Produz uma trilha nativa sincronizada com a imagem. Mesmo com `reference_audio_urls` enviado, desligar significa nenhuma trilha renderizada — o áudio de referência molda ritmo e interpretação, ele não é a faixa de saída. Desligue quando a edição for musicada na pós.

Valor padrão
true
duration_secondsintegerOpcionalAfeta o preço

De 4 a 15 segundos, padrão 5; com -1, o modelo escolhe a duração (a estimativa usa o máximo de 15 segundos e a cobrança, a duração entregue). Quinze segundos é o teto desta geração; para um plano único mais longo, mude para o endpoint da 2.5. Repare que isto e a duração dos seus clipes de referência são duas contribuições independentes à quantidade cobrada, então maximizar os dois é onde uma única requisição fica cara.

Valor padrão
5
Valores permitidos
-1456789101112131415
resolutionstringOpcionalAfeta o preço

480p, 720p, 1080p ou 4k, padrão 720p, e alimenta a quantidade cobrada diretamente. Define só a faixa de saída e não vai deixar referências de baixa resolução mais nítidas. Teste se as referências combinam numa faixa baixa e depois suba para o take final. Não existem faixas de upscaling ou realce aqui.

Valor padrão
"720p"
Valores permitidos
"480p""720p""1080p""4k"
aspect_ratiostringOpcional

Vem em `adaptive`: o modelo encontra um enquadramento que acomoda todos os sujeitos referenciados, o que pesa mais quando as referências não compartilham a mesma forma. Fixe uma proporção só por exigência dura de entrega — `9:16` para um feed vertical, por exemplo — e confira se nenhuma pessoa ou produto referenciado ficou cortado. Não afeta a cobrança.

Valor padrão
"adaptive"
Valores permitidos
"21:9""16:9""4:3""1:1""3:4""9:16""adaptive"
reference_audio_urlsarray<string>Opcional

Até 3 arquivos de áudio de referência, cada um com 2 a 15 segundos e no máximo 15 segundos somados, dando ao modelo uma âncora sonora — interpretação, andamento, uma frase musical — à qual o movimento e os pontos de corte se alinham. Diferente de `generate_audio`: isto é entrada, enquanto quem decide se o clipe final tem trilha continua sendo `generate_audio`.

Valor padrão
Não especificado
Restrições
maxItems:3
reference_video_urlsarray<string>Obrigatório sob condiçãoAfeta o preço

Até 3 clipes de referência, cada um com 2 a 15 segundos e no máximo 15 segundos somados, fornecendo movimento, ritmo ou linguagem de câmera. A duração de um clipe de referência conta na quantidade cobrada — não como troca de faixa, mas como multiplicador linear do mesmo tipo que `duration_seconds` — então corte nos segundos que você realmente quer citar.

Valor padrão
Não especificado
Restrições
maxItems:3
reference_image_urlsarray<string>Obrigatório sob condição

Até 9 imagens de referência, usadas para segurar um personagem, um estilo ou um cenário. Dois ou três ângulos do mesmo personagem costumam funcionar melhor que uma pilha de quadros quase idênticos. Este endpoint não tem parâmetro de primeiro nem de último quadro: modo referência e modo quadro são mutuamente exclusivos, então mude para image-to-video quando o quadro de abertura precisar ser exato. A verificação de entrada do próprio Seedance pode recusar uma foto ou um clipe de referência que mostre o rosto de uma pessoa real e identificável. Cada lado precisa ter entre 300 e 6000 pixels; abaixo disso, a verificação de entrada recusa a imagem antes de qualquer cobrança.

Valor padrão
Não especificado
Restrições
maxItems:9

Acompanhar tarefa

HTTP 202 quer dizer que a tarefa foi aceita, não que terminou. Guarde o taskId devolvido e consulte essa tarefa. Não crie outra enquanto espera o resultado.

Requisição aceita
HTTP/1.1 202 Accepted
Location: /api/v1/jobs/recordInfo?taskId=job_01k3m8x9q2z4v7n5p6r8s0t1w3

{
  "code": 200,
  "msg": "success",
  "request_id": "req_example_create",
  "data": {
    "taskId": "job_01k3m8x9q2z4v7n5p6r8s0t1w3",
    "state": "queued",
    "estimatedCost": "0.750000"
  }
}

A resposta de aceitação já traz a estimativa, para que o seu aplicativo mostre o mesmo valor no histórico de tarefas e na cobrança.

Consultar a tarefa
curl --get "https://api.spicyapi.ai/api/v1/jobs/recordInfo" \
  --data-urlencode "taskId=$TASK_ID" \
  -H "Authorization: Bearer $SPICY_API_KEY"

Comece consultando a cada 2 segundos, mais ou menos, e vá espaçando. Pare em um estado final. Se a conexão cair, consulte o taskId original. Só recrie a tarefa com a chave de idempotência e o corpo originais.

Ou receba o resultado por callback
import { verifyWebhook } from "@spicyapi/sdk";

// express.raw keeps the bytes we signed; express.json never matches.
app.post("/hooks/spicy", express.raw({ type: "application/json" }), (req, res) => {
  const { payload } = verifyWebhook({
    rawBody: req.body,
    timestamp: req.header("X-Webhook-Timestamp"),
    signature: req.header("X-Webhook-Signature"),
    payloadVersion: Number(req.header("X-Webhook-Payload-Version")),
    secret: process.env.SPICY_WEBHOOK_SECRET,
  });
  res.status(200).end();
  void handleFinishedTask(payload);
});

Passe callBackUrl ao criar a tarefa e o registro concluído chega até você via POST — sem nenhum laço de polling. Toda entrega traz X-Webhook-Timestamp, X-Webhook-Signature e X-Webhook-Payload-Version. A assinatura é um HMAC-SHA256 em base64 sobre taskId.timestamp.sha256(body), então confira contra os bytes brutos: se você analisar o JSON e serializar de novo, os bytes mudam e a verificação falha. Entregas com erro são repetidas, ou seja, o mesmo taskId pode chegar duas vezes — deixe seu handler idempotente. Responda 2xx primeiro e faça o trabalho depois; um handler lento conta como entrega falha.

Ler resultado

Só consuma output quando state for succeeded. Em caso de falha, use errorCode, errorMessage e request_id para investigar. Os custos e estados de exemplo não representam uma cobrança real.

Exemplo de resposta concluída
{
  "code": 200,
  "msg": "success",
  "request_id": "req_example_record",
  "data": {
    "taskId": "job_01k3m8x9q2z4v7n5p6r8s0t1w3",
    "model": "bytedance/seedance-2.0/reference-to-video",
    "state": "succeeded",
    "output": {
      "assets": [
        {
          "key": "tasks/2026/08/28/job_01k3m8x9q2z4v7n5p6r8s0t1w3/3f7a1c9e5b2d48f0a6c1e3d5b7f9a1c3.mp4",
          "mime": "video/mp4",
          "url": "https://example.r2.cloudflarestorage.com/results/job_01k3m8x9q2z4v7n5p6r8s0t1w3/result.mp4?X-Amz-Signature=SIGNATURE_FROM_RESPONSE",
          "expiresAt": "2026-08-28T12:20:08.000Z"
        }
      ]
    },
    "cost": "0.750000",
    "settled": true,
    "createdAt": "2026-08-28T12:00:00Z",
    "completedAt": "2026-08-28T12:00:30Z"
  }
}

Para cada arquivo disponível, abra ou baixe assets[].url direto, sem o cabeçalho Authorization da API. O link assinado expira em expiresAt: consulte a tarefa de novo para renovar enquanto o arquivo estiver dentro do prazo de retenção. Arquivo pendente ou indisponível não tem URL. Trate os links assinados como dado privado.

SDKs e integrações

Use a SpicyAPI no seu app, terminal, assistente de IA ou fluxo visual. Escolha um guia de configuração.

SDKs
TypeScript · Python · Go · PHP · Java
CLI
Comandos de terminal e scripts de automação.
MCP
Claude Code · Cursor · Codex
Agent Skill
Instruções reutilizáveis para seu assistente de IA.
n8n
Nós comunitários para instalações próprias e modelos importáveis com HTTP Request para n8n Cloud.
ComfyUI
Fluxos de imagem, vídeo e áudio em um canvas de nós.

Mais integrações

SillyTavernTelegram / DiscordApp proxyOpenAI SDKLangChainVercel AI SDK
Explorar fluxos prontos para usar

Use no ComfyUI

Instale os nós da SpicyAPI pelo ComfyUI Manager ou com o comando abaixo e procure por Seedance 2.0 · Reference to Video no canvas. O nó tem as mesmas opções desta página e mostra o preço antes da execução.

cd ComfyUI/custom_nodes
git clone https://github.com/spicyapi-ai/comfyui-spicyapi
Exemplos de fluxos de trabalhoGuia de configuraçãoCódigo-fonte no GitHub