curl --request POST \
--url https://api.evolink.ai/v1/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "seedance-2.5-draft-to-video",
"source_task_id": "task-unified-1774857405-abc123"
}
'{
"created": 1761313744,
"id": "task-unified-1774857405-abc123",
"model": "seedance-2.5-draft-to-video",
"object": "video.generation.task",
"progress": 0,
"status": "pending",
"task_info": {
"can_cancel": false,
"estimated_time": 165,
"video_duration": 0
},
"type": "video",
"usage": {
"billing_rule": "per_second",
"credits_reserved": 50,
"user_group": "default"
}
}Seedance 2.5
Seedance 2.5 Draft-to-Video — conversión en video final
- Convierte un borrador Seedance 2.5 completado (una tarea creada con
draft: true) en un video final en 1080p con el mismo contenido - Solo admite cuatro campos:
model,source_task_id,output_formatycallback_url. La indicación, los materiales, la duración, la relación de aspecto, la semilla aleatoria y la configuración de audio se reutilizan del borrador: no es necesario ni está permitido enviarlos de nuevo. Cualquier otro campo devuelve un error de parámetro 400 - Envíe la solicitud de conversión antes del
draft_expires_atdel borrador. El período de validez predeterminado es de 24 horas desde su finalización; la fecha límite real es eldraft_expires_atdevuelto al consultar la tarea - El sistema comprueba la validez al aceptar la solicitud y antes de enviarla para su generación. Si el borrador caduca mientras la tarea espera en la cola, la conversión falla y se reembolsa el costo de esa conversión. Deje margen para el tiempo de espera
- El mismo borrador puede convertirse varias veces antes de caducar; cada conversión se factura por separado
- El procesamiento es asíncrono. Use el ID de tarea devuelto para consultar la tarea; la respuesta incluye
source_task_id - El enlace del video generado es válido durante 24 horas. Guárdelo cuanto antes
Reglas de facturación:
- La conversión se factura por separado del borrador, siempre con la tarifa de
1080p - La duración de salida corresponde a la duración real del video registrada para el borrador de origen. Si no existe ese valor, se usa la duración de salida efectiva registrada en la tarea de origen
- Si el borrador no tiene videos de entrada, la duración facturada es la duración de salida. Si tiene videos de entrada (incluidos Reference-to-Video, Video Edit y Video Extend), se calcula como
duración de salida + max(duración de los videos de entrada, duración de salida), redondeada hacia arriba a la décima de segundo - Si el borrador tenía el filtro de contenido desactivado (
content_filter: false), el video final también se factura con un recargo del +10% (1.1x) - Si la conversión falla, se reembolsa el costo de esa conversión; el costo del borrador no se reembolsa
POST
/
v1
/
videos
/
generations
curl --request POST \
--url https://api.evolink.ai/v1/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "seedance-2.5-draft-to-video",
"source_task_id": "task-unified-1774857405-abc123"
}
'{
"created": 1761313744,
"id": "task-unified-1774857405-abc123",
"model": "seedance-2.5-draft-to-video",
"object": "video.generation.task",
"progress": 0,
"status": "pending",
"task_info": {
"can_cancel": false,
"estimated_time": 165,
"video_duration": 0
},
"type": "video",
"usage": {
"billing_rule": "per_second",
"credits_reserved": 50,
"user_group": "default"
}
}Autorizaciones
##Todas las interfaces requieren autenticacion mediante Bearer Token##
Obtener API Key:
Visite la Pagina de gestion de API Key para obtener su API Key
Agregue en el encabezado de la solicitud al usar:
Authorization: Bearer YOUR_API_KEY
Cuerpo
application/json
Nombre del modelo de generacion de video
Opciones disponibles:
seedance-2.5-draft-to-video Ejemplo:
"seedance-2.5-draft-to-video"
ID de una tarea de borrador Seedance 2.5 completada
Cómo obtenerlo: el campo id devuelto por la solicitud que crea el borrador (draft: true)
Requisitos:
- La tarea debe pertenecer a la cuenta actual
- Su modelo debe ser uno de los cinco modelos de generación Seedance 2.5
- Debe haberse creado con
draft: true - Su estado debe ser
completed - La hora actual debe ser anterior al
draft_expires_atdevuelto al consultar la tarea
Ejemplo:
"task-unified-1774857405-abc123"
Formato de contenedor de salida, valor predeterminado mp4
Valores opcionales:
mp4: codificacion H.264, la mejor compatibilidad y precision de color estandar; es el valor predeterminadomov: H.264 + submuestreo de croma yuv444p + audio PCM, con mayor fidelidad de color, recomendado para etalonaje, recorte de croma y composicion. Es posible que el navegador no lo reproduzca en linea; descarguelo y reproduzcalo con VLC / mpv / ffplay. Sin cargo adicional
No se hereda el formato de salida del borrador. Si necesita mov, especifíquelo aquí
Opciones disponibles:
mp4, mov Ejemplo:
"mp4"
Direccion de callback HTTPS despues de completar la tarea
Momento del callback:
- Se activa cuando la tarea se completa (completed) o falla (failed)
- Se envia despues de confirmar la facturacion
Restricciones de seguridad:
- Solo admite protocolo HTTPS
- Prohibido el callback a direcciones IP de red interna (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x, etc.)
- La longitud de la URL no debe exceder
2048caracteres
Mecanismo de callback:
- Tiempo de espera:
10segundos - Maximo
3reintentos despues del fallo (reintentos a los1/2/4segundos despues del fallo) - El formato del cuerpo de respuesta del callback es consistente con el formato de retorno de la interfaz de consulta de tareas
- Un codigo de estado 2xx se considera exitoso, otros codigos de estado activan reintentos
Ejemplo:
"https://your-domain.com/webhooks/video-task-completed"
Respuesta
Tarea de conversión en video final creada correctamente
Marca de tiempo de creacion de la tarea
Ejemplo:
1761313744
ID de la tarea
Ejemplo:
"task-unified-1774857405-abc123"
Nombre del modelo utilizado
Ejemplo:
"seedance-2.5-draft-to-video"
Tipo especifico de la tarea
Opciones disponibles:
video.generation.task Porcentaje de progreso de la tarea (0-100)
Rango requerido:
0 <= x <= 100Ejemplo:
0
Estado de la tarea
Opciones disponibles:
pending, processing, completed, failed Ejemplo:
"pending"
Informacion detallada de la tarea de video
Show child attributes
Show child attributes
Tipo de salida de la tarea
Opciones disponibles:
text, image, audio, video Ejemplo:
"video"
Informacion de uso y facturacion
Show child attributes
Show child attributes