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 suporte a três variantes do modelo:

Comparação rápida

Proporções compatíveis

Text-to-Video e Reference-to-Video oferecem suporte a:

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

Image-to-Video não oferece suporte ao parâmetro aspect_ratio.

Opções de resolução

Seedance 2.5 Text to Video

Ponto de acesso da API

POST /api/v1/video/task

Parâmetros da solicitação

Obrigatórios

Opcionais

Exemplo de solicitaçã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 solicitação

Obrigatórios

Opcionais

Não inclua aspect_ratio nas solicitações Image-to-Video. Este modelo não oferece suporte a esse parâmetro.

Exemplo de solicitaçã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 solicitação

Obrigatórios

Mídia de referência

Placeholders de referência @ (AT)

O recurso de referência @ (AT) vincula a mídia de referência ao prompt por meio de placeholders <<<...>>> 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 for uma referência de cena, use <<<image_1>>> para o personagem e <<<image_2>>> para a cena no prompt. Cada placeholder deve apontar para um item existente no array correspondente.

Opcionais

Exemplo de solicitaçã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 solicitação Reference-to-Video 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']
}

Formato da resposta

Resposta inicial

Todos os modelos retornam um task_id para polling:

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 do polling

Faça polling de 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": {
      "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.

Faça polling a cada 5 a 10 segundos para verificar o status.

Práticas recomendadas

1. Parâmetros obrigatórios: sempre forneça resolution e duration, além de aspect_ratio para Text-to-Video e Reference-to-Video
2. Proporção de Image-to-Video: não envie aspect_ratio em solicitações Image-to-Video
3. Vídeos de referência: Reference-to-Video exige pelo menos um vídeo; cada vídeo e a duração combinada devem permanecer dentro dos limites documentados
4. Imagens de referência: as imagens são opcionais quando há vídeos de referência; ao usá-las, envie de 1 a 30 URLs de imagens compatíveis
5. Áudio de referência: mantenha cada clipe de áudio entre 2 e 30 segundos e com até 15 MB, com duração combinada máxima de 30 segundos
6. Ordem das referências: mantenha images, videos e audios na ordem pretendida e faça referências consistentes a eles no prompt
7. Áudio: omita sound para usar o valor padrão true ou defina-o como false para desativar o áudio gerado