Seedance 2.5 API

Referência completa da API dos modelos de geração de vídeo Seedance 2.5 da ByteDance.

Variantes do modelo

Esta API oferece três variantes de modelo:

Comparação rápida

Proporções suportadas

Texto para vídeo e Referências para vídeo suportam:

21:9, 16:9, 9:16, 1:1, 4:3, 3:4

Imagem para vídeo não suporta o parâmetro aspect_ratio.

Opções de resolução

Seedance 2.5 Text to Video

Ponto de acesso

POST /api/v1/video/task

Parâmetros da requisição

Obrigatórios

Opcionais

Exemplo de requisição

javascriptCopiar
const response = await fetch('https://api.flaq.ai/api/v1/video/task', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model_name: 'seedance-v2.5-text-to-video',
    prompt: 'A golden retriever running through a sunlit meadow',
    resolution: '720p',
    duration: 8,
    aspect_ratio: '16:9',
    sound: true
  })
});

const { data } = await response.json();
const taskId = data.task_id;

Seedance 2.5 Image to Video

Parâmetros da requisição

Obrigatórios

Opcionais

Não inclua aspect_ratio nas requisições de Imagem para vídeo. Este modelo não suporta esse parâmetro.

Exemplo de requisição

javascriptCopiar
{
  model_name: 'seedance-v2.5-image-to-video',
  image_url: 'https://example.com/first-frame.jpg',
  image_end_url: 'https://example.com/last-frame.jpg',
  prompt: 'Camera slowly pulls back to reveal the full landscape',
  resolution: '720p',
  duration: 8,
  sound: true
}

Seedance 2.5 Reference to Video

Parâmetros da requisição

Obrigatórios

Mídias de referência

Todas as mídias de referência são opcionais. São aceitas requisições apenas com imagens, apenas com vídeos, apenas com áudio e sem mídias de referência. Para gerar sem referências, recomenda-se Texto para vídeo.

Marcadores de referência @ (AT)

O recurso de referência @ (AT) associa as mídias de referência ao prompt por meio de marcadores numerados <<<...>>>. A numeração começa em 1 de forma independente para cada tipo de mídia e segue a ordem do array correspondente:

Por exemplo, se a primeira imagem for uma referência de personagem e a segunda de cenário, use <<<image_1>>> para o personagem e <<<image_2>>> para o cenário em prompt. Cada marcador deve apontar para um item existente no array correspondente.

Opcionais

Exemplo de requisição

javascriptCopiar
{
  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']
}

Exemplo de requisição de Referências para vídeo com @ (AT)

javascriptCopiar
{
  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']
}

Limites de mídia

Estes limites se aplicam às imagens do primeiro e do último quadro e às mídias de referência dos modelos desta página.

O áudio e os vídeos de referência têm limites independentes de duração total de 30 segundos cada. As quantidades também são independentes: até 30 imagens, 10 vídeos e 10 clipes de áudio. Adicionar vídeos não reduz a quantidade permitida de imagens.

Todos os modelos usam 720p por padrão, mas resolution ainda deve ser informado. O controle de som tem valor padrão true; nem esse controle nem o áudio de referência alteram o preço.

Formato da resposta

Resposta inicial

Todos os modelos retornam um task_id para consulta periódica:

jsonCopiar
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/video/{task_id}",
    "task_status": "submitted"
  }
}

Resposta da consulta

Consulte GET /api/v1/video/{taskId} para verificar o status:

jsonCopiar
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/video/{task_id}",
    "task_status": "succeed",
    "task_status_msg": null,
    "task_result": {
      "credit": 0.2,
      "videos": [
        {
          "url": "https://example.com/generated-video.mp4"
        }
      ]
    }
  }
}

Valores de status

• submitted: Tarefa aceita e aguardando processamento
• processing: Geração de vídeo em andamento
• succeed: Geração de vídeo concluída
• failed: Falha na geração de vídeo

Tempo de processamento

O tempo de processamento varia conforme a duração, a resolução e as condições atuais da fila.

Consulte o status a cada 5-10 segundos.

Boas práticas

1. Parâmetros obrigatórios: sempre forneça resolution e duration, além de aspect_ratio para Texto para vídeo e Referências para vídeo
2. Proporção em Imagem para vídeo: não envie aspect_ratio nas requisições de Imagem para vídeo
3. Vídeos de referência: os vídeos são opcionais; a duração de cada vídeo e a duração total devem respeitar os limites documentados
4. Imagens de referência: as imagens são opcionais independentemente dos vídeos e do áudio; envie até 30 URLs de imagens suportadas
5. Áudio de referência: mantenha cada clipe entre 2-30 segundos e até 15 MB, com duração total de no máximo 30 segundos
6. Ordem das referências: organize images, videos e audios na ordem desejada e faça referências consistentes no prompt
7. Som: omita sound para usar o padrão true ou defina false para desativar a geração de som