API de Exportación de Clips

Usa esta API cuando ya hayas creado una tarea de Clipping con IA o Buscar Momentos y desees renderizar clips más tarde o reexportarlos con diferentes configuraciones.

El project_id debe ser el ID de la tarea original devuelto por:

POST /api/v2/clips
POST /api/v2/clips/find-moments

Enviar Tarea de Exportación

POST https://wayinvideo-api.wayin.ai/api/v2/clips/export

Cuerpo de la Solicitud

Parámetro	Tipo	Requerido	Predeterminado	Descripción
`project_id`	string	Sí	—	ID de la tarea original de Clipping con IA o Buscar Momentos.
`clip_indices`	integer[]	No	`null`	Índices de clips a exportar. Cuando se omite, exporta todos los clips.
`target_lang`	string	No	`null`	Idioma de destino para subtítulos.
`resolution`	string	No	`SD_480`	Resolución: `SD_480`, `HD_720`, `FHD_1080`, `QHD_2K`, `UHD_4K`.
`enable_caption`	boolean	No	`false`	Añadir subtítulos animados.
`caption_display`	string	No	`original`	Modo de subtítulos: `both`, `original`, `translation`.
`cc_style_tpl`	string	No	`temp-7`	ID de plantilla de estilo de subtítulos.
`enable_ai_hook`	boolean	No	`false`	Añadir texto de gancho generado por IA.
`ai_hook_script_style`	string	No	`serious`	Estilo del gancho.
`ai_hook_position`	string	No	`beginning`	Posición: `beginning`, `end`.
`ai_hook_keywords`	string	No	`null`	Palabras clave opcionales para el texto del gancho.
`ai_hook_text_duration`	integer	No	`null`	Duración de la superposición de texto en milisegundos.
`enable_ai_reframe`	boolean	No	`false`	Activar Reencuadre con IA.
`ratio`	string	Obligatorio cuando `enable_ai_reframe` es `true`	—	Proporción: `RATIO_9_16`, `RATIO_1_1`, `RATIO_4_5`, `RATIO_16_9`.

curl -X POST https://wayinvideo-api.wayin.ai/api/v2/clips/export \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-wayinvideo-api-version: v2" \
  -d '{"project_id": "proj_abc123", "clip_indices": [0, 2], "resolution": "UHD_4K", "enable_caption": true, "caption_display": "both", "enable_ai_reframe": true, "ratio": "RATIO_9_16"}'

{"data": {"export_task_id": "export_task_xyz789", "name": "sample export task", "status": "CREATED"}}

Obtener Resultados de Exportación

GET https://wayinvideo-api.wayin.ai/api/v2/clips/export/{taskId}

curl -X GET https://wayinvideo-api.wayin.ai/api/v2/clips/export/export_task_xyz789 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-wayinvideo-api-version: v2"

{"data": {"export_task_id": "export_task_xyz789", "status": "SUCCEEDED",
          "expire_at": 1775831883112, "cost_usage": 48.0,
          "clips": [{"idx": 0, "title": "sample title", "begin_ms": 15000, "end_ms": 75000,
                     "score": 81, "export_link": "https://cdn.example.com/export/clip_001.mp4"}]}}