# Clips-Export-API

> Bestehende Clips aus KI-Clipping und Momente finden mit neuen Untertitelstilen und Rendereinstellungen exportieren oder neu exportieren.

## Clips-Export-API

Verwenden Sie diese API, wenn Sie bereits eine Aufgabe [KI-Clipping](https://wayin.ai/de/api-docs/ai-clipping/) oder [Momente finden](https://wayin.ai/de/api-docs/find-moments/) erstellt haben und Clips später rendern oder mit anderen Einstellungen neu exportieren möchten.

Die `project_id` sollte die ursprüngliche Aufgaben-ID von:
- `POST /api/v2/clips`
- `POST /api/v2/clips/find-moments`

---

## Export-Aufgabe einreichen

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

### Anfragekörper

| Parameter | Typ | Erforderlich | Standard | Beschreibung |
|-----------|-----|--------------|----------|--------------|
| `project_id` | string | Ja | — | Ursprüngliche KI-Clipping- oder Momente-finden-Aufgaben-ID. |
| `clip_indices` | integer[] | Nein | `null` | Zu exportierende Clip-Indizes. Wenn weggelassen, alle Clips. |
| `target_lang` | string | Nein | `null` | Zielsprache für Untertitel. |
| `resolution` | string | Nein | `SD_480` | Auflösung: `SD_480`, `HD_720`, `FHD_1080`, `QHD_2K`, `UHD_4K`. |
| `enable_caption` | boolean | Nein | `false` | Animierte Untertitel hinzufügen. |
| `caption_display` | string | Nein | `original` | Untertitelmodus: `both`, `original`, `translation`. |
| `cc_style_tpl` | string | Nein | `temp-7` | Untertitelstil-Vorlagen-ID. |
| `enable_ai_hook` | boolean | Nein | `false` | KI-generierten Aufmerksamkeitstext hinzufügen. |
| `ai_hook_script_style` | string | Nein | `serious` | Hook-Textstil. |
| `ai_hook_position` | string | Nein | `beginning` | Position: `beginning`, `end`. |
| `ai_hook_keywords` | string | Nein | `null` | Optionale Schlüsselwörter für den KI-Hook-Text. |
| `ai_hook_text_duration` | integer | Nein | `null` | Dauer der Hook-Text-Überlagerung in Millisekunden. |
| `enable_ai_reframe` | boolean | Nein | `false` | KI-Reframing aktivieren. |
| `ratio` | string | Erforderlich wenn `enable_ai_reframe` `true` | — | Seitenverhältnis: `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, "enable_ai_reframe": true, "ratio": "RATIO_9_16"}'
```

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

---

## Export-Ergebnisse abrufen

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