# Panduan Cepat

> Mulai menggunakan WayinVideo API dalam hitungan menit.

## Panduan Cepat

Ikuti langkah-langkah berikut untuk mulai menggunakan WayinVideo API dalam hitungan menit.

## 1. Dapatkan Kunci API Anda

1. Masuk ke [WayinVideo API Dashboard](https://wayin.ai/wayinvideo/api-dashboard)
2. Klik **Create API Key** untuk membuat kunci baru
3. Salin dan simpan kunci API Anda dengan aman

> **Penting:** Rahasiakan kunci API Anda. Jangan paparkan di kode sisi klien atau repositori publik.

## 2. Kirim Tugas Klipping

Kirimkan URL video untuk memulai tugas AI clipping:

```bash
curl -X POST https://wayinvideo-api.wayin.ai/api/v2/clips \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-wayinvideo-api-version: v2" \
  -d '{
    "video_url": "https://www.youtube.com/watch?v=example",
    "enable_export": false
  }'
```

Respons:

```json
{
  "data": {
    "id": "proj_abc123",
    "name": "sample project name",
    "status": "CREATED"
  }
}
```

## 3. Polling untuk Hasil

Lakukan polling status tugas hingga mencapai `SUCCEEDED`. Kami merekomendasikan polling setiap **30 detik**.

```bash
curl -X GET https://wayinvideo-api.wayin.ai/api/v2/clips/results/proj_abc123 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-wayinvideo-api-version: v2"
```

Ketika selesai, respons menyertakan klip Anda:

```json
{
  "data": {
    "id": "proj_abc123",
    "name": "sample project name",
    "status": "SUCCEEDED",
    "clips": [
      {
        "idx": 0,
        "title": "sample title",
        "begin_ms": "15000",
        "end_ms": "75000",
        "thumbnail": "https://cdn.example.com/thumb/clip_001.jpg",
        "tags": ["insight", "understanding"],
        "desc": "sample description"
      }
    ]
  }
}
```

> **Catatan:** Saat mengirim tugas Clipping, Anda dapat mengatur `enable_export = true` agar layanan merender dan mengekspor video serta mengembalikan tautan ekspor. Karena rendering dan ekspor memerlukan waktu pemrosesan tambahan, penyelesaian akan memakan waktu lebih lama dibandingkan saat ekspor dinonaktifkan.

## 4. Ekspor dan Publikasikan Klip

Setelah klip dibuat, Anda dapat merendernya sebagai file video atau mempublikasikannya langsung ke akun media sosial yang terhubung:

- [Clips Export API](https://wayin.ai/id/api-docs/clips-export/) — Render atau ekspor ulang klip dengan resolusi, caption, AI Reframe, AI Hook, dan pengaturan ekspor khusus lainnya.
- [Social Media Publishing API](https://wayin.ai/id/api-docs/social-media-publishing/) — Hubungkan akun media sosial dan publikasikan klip yang dibuat oleh AI Clipping atau Find Moments.

## Langkah Berikutnya

- [AI Clipping](https://wayin.ai/id/api-docs/ai-clipping/) — Dapatkan klip viral dari video panjang
- [Find Moments](https://wayin.ai/id/api-docs/find-moments/) — Temukan momen menggunakan kueri bahasa alami
- [Video Summarization](https://wayin.ai/id/api-docs/video-summarization/) — Dapatkan ringkasan dan highlight timeline
- [Video Notes](https://wayin.ai/id/api-docs/video-notes/) — Hasilkan catatan AI terstruktur dalam format Markdown dan teks biasa
- [Video Transcription](https://wayin.ai/id/api-docs/video-transcription/) — Ekstrak transkrip tingkat kata dengan diarisasi pembicara
- [AI for Stream Videos](https://wayin.ai/solutions/stream) — Jelajahi Live Stream Understanding and Clipping untuk alur kerja video real-time.
