# Inicio Rápido

> Comienza a usar la API WayinVideo en minutos.

## Inicio Rápido

Sigue estos pasos para comenzar a usar la API WayinVideo en minutos.

## 1. Obtén tu Clave de API

1. Inicia sesión en tu [WayinVideo API Dashboard](https://wayin.ai/wayinvideo/api-dashboard)
2. Haz clic en **Create API Key** para generar una nueva clave
3. Copia y guarda tu clave de API de forma segura

> **Importante:** Mantén tu clave de API en secreto. No la expongas en código del lado del cliente ni en repositorios públicos.

## 2. Envía una Tarea de Clipping

Envía una URL de vídeo para iniciar una tarea de clipping con IA:

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

Respuesta:

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

## 3. Consulta los Resultados

Consulta el estado de la tarea hasta que llegue a `SUCCEEDED`. Recomendamos consultar cada **30 segundos**.

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

Cuando se complete, la respuesta incluye tus clips:

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

> **Nota:** Al enviar una tarea de Clipping, puedes establecer `enable_export = true` para que el servicio renderice y exporte el vídeo y devuelva enlaces de exportación. Como el renderizado y la exportación requieren tiempo de procesamiento adicional, la tarea tardará más en completarse que cuando la exportación está deshabilitada.

## 4. Exporta y Publica Clips

Después de generar los clips, puedes renderizarlos como archivos de video o publicarlos directamente en cuentas de redes sociales conectadas:

- [API de Exportación de Clips](https://wayin.ai/es/api-docs/clips-export/) — Renderiza o reexporta clips con resolución, subtítulos, AI Reframe, AI Hook y otros ajustes personalizados.
- [API de Publicación en Redes Sociales](https://wayin.ai/es/api-docs/social-media-publishing/) — Conecta cuentas de redes sociales y publica clips generados por Clipping con IA o Buscar Momentos.

## Próximos Pasos

- [Clipping con IA](https://wayin.ai/es/api-docs/ai-clipping/) — Obtén clips virales de vídeos largos
- [Buscar Momentos](https://wayin.ai/es/api-docs/find-moments/) — Encuentra momentos usando consultas en lenguaje natural
- [Resumen de Vídeo](https://wayin.ai/es/api-docs/video-summarization/) — Obtén resúmenes y momentos destacados
- [Notas de Vídeo](https://wayin.ai/es/api-docs/video-notes/) — Genera notas estructuradas con IA en Markdown y texto sin formato
- [Transcripción de Vídeo](https://wayin.ai/es/api-docs/video-transcription/) — Extrae transcripciones a nivel de palabra con diarización de locutores
- [AI for Stream Videos](https://wayin.ai/solutions/stream) — Explora Live Stream Understanding and Clipping para flujos de video en tiempo real.
