Seedance 2.5 API

Referencia completa de la API de los modelos de generación de vídeo Seedance 2.5 de ByteDance.

Variantes del modelo

Esta API admite tres variantes:

Comparación rápida

Relaciones de aspecto compatibles

Texto a vídeo y Referencias a vídeo admiten:

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

Imagen a vídeo no admite el parámetro aspect_ratio.

Opciones de resolución

Seedance 2.5 Text to Video

Punto de conexión

POST /api/v1/video/task

Parámetros de la solicitud

Obligatorios

Opcionales

Ejemplo de solicitud

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 de la solicitud

Obligatorios

Opcionales

No incluya aspect_ratio en las solicitudes de Imagen a vídeo. Este modelo no admite ese parámetro.

Ejemplo de solicitud

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 de la solicitud

Obligatorios

Medios de referencia

Todos los medios de referencia son opcionales. Se admiten solicitudes solo con imágenes, solo con vídeos, solo con audio y sin medios de referencia. Para generar sin referencias, se recomienda Texto a vídeo.

Marcadores de referencia @ (AT)

La función @ (AT) vincula los medios de referencia al prompt mediante marcadores numerados <<<...>>>. La numeración comienza en 1 de forma independiente para cada tipo de medio y sigue el orden de su matriz:

Por ejemplo, si la primera imagen es una referencia de personaje y la segunda una referencia de escena, use <<<image_1>>> para el personaje y <<<image_2>>> para la escena en prompt. Cada marcador debe apuntar a un elemento existente en su matriz correspondiente.

Opcionales

Ejemplo de solicitud

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

Ejemplo de solicitud de Referencias a vídeo con @ (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']
}

Límites de medios

Estos límites se aplican a las imágenes del primer y último fotograma y a los medios de referencia de los modelos de esta página.

El audio y los vídeos de referencia tienen límites de duración total independientes de 30 segundos cada uno. Sus cantidades son independientes: hasta 30 imágenes, 10 vídeos y 10 clips de audio. Añadir vídeos no reduce la cantidad de imágenes permitida.

Todos los modelos usan 720p de forma predeterminada, pero sigue siendo obligatorio enviar resolution. El interruptor de sonido tiene el valor predeterminado true; ni este ajuste ni el audio de referencia cambian el precio.

Formato de respuesta

Respuesta inicial

Todos los modelos devuelven un task_id para consultar el estado periódicamente:

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

Respuesta de consulta

Consulte GET /api/v1/video/{taskId} para comprobar el estado:

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 estado

• submitted: Tarea aceptada y pendiente de procesamiento
• processing: Generación de vídeo en curso
• succeed: Generación de vídeo completada
• failed: Error en la generación de vídeo

Tiempo de procesamiento

El tiempo de procesamiento depende de la duración, la resolución y las condiciones actuales de la cola.

Consulte el estado cada 5-10 segundos.

Buenas prácticas

1. Parámetros obligatorios: envíe siempre resolution y duration, además de aspect_ratio para Texto a vídeo y Referencias a vídeo
2. Relación de Imagen a vídeo: no envíe aspect_ratio en solicitudes de Imagen a vídeo
3. Vídeos de referencia: los vídeos son opcionales; la duración de cada vídeo y la total deben respetar los límites documentados
4. Imágenes de referencia: las imágenes son opcionales independientemente de los vídeos y el audio; envíe hasta 30 URL de imágenes compatibles
5. Audio de referencia: cada clip debe durar 2-30 segundos y no superar 15 MB, con una duración total máxima de 30 segundos
6. Orden de las referencias: organice images, videos y audios en el orden deseado y refiérase a ellos de forma coherente en el prompt
7. Sonido: omita sound para usar el valor predeterminado true, o establézcalo en false para desactivar la generación de sonido