# API de Exportación de Clips

> Exporta o reexporta clips existentes de Clipping con IA y Buscar Momentos con nuevos estilos de subtítulos y configuraciones de renderización.

## API de Exportación de Clips

Usa esta API cuando ya hayas creado una tarea de [Clipping con IA](https://wayin.ai/es/api-docs/ai-clipping/) o [Buscar Momentos](https://wayin.ai/es/api-docs/find-moments/) 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`. |

```bash
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"}'
```

```json
{"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}
```

```bash
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"
```

```json
{"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"}]}}
```