Crear clip

Crea un clip del stream en vivo desde el chat.

GEThttps://ttv.losperris.dev/api/create-clip

AutenticaciónTodos los endpoints requieren el parámetro apiKey en la query. Obtén la tuya desde el panel.›

Requisitos

1. El canal debe estar en vivo.
2. La creación de clips debe estar habilitada en el panel de Twitch.

Límites

Rate limit

Usa el límite general de tu rol (30–120 req/min). Configura un cooldown de 30–60 s en el bot para no spamear la API de Twitch.

Parámetros

Parámetro	Tipo	Requerido	Descripción
channel	String	Sí	Canal en el que se crea el clip.
apiKey	String	Sí	Clave de API de tu cuenta.
user	String	No	Usuario que solicita el clip (para plantillas).
title	String	No	Título opcional del clip.
template	String	No	Plantilla con {user}, {url}, {title} y {channel}.

Ejemplo de petición

cURLcURL -iURL

curl --request GET \
  --url 'https://ttv.losperris.dev/api/create-clip?channel=losperris&apiKey=TU_API_KEY&user=viewer123' \
  --header 'Accept: text/plain'

curl -i --request GET \
  --url 'https://ttv.losperris.dev/api/create-clip?channel=losperris&apiKey=TU_API_KEY&user=viewer123' \
  --header 'Accept: text/plain'

https://ttv.losperris.dev/api/create-clip?channel=losperris&apiKey=TU_API_KEY&user=viewer123

Plantillas personalizadas

Añade template para personalizar el mensaje del bot. Placeholders: {user}, {url}, {title} y {channel}.

cURLcURL -iURL

curl --request GET \
  --url 'https://ttv.losperris.dev/api/create-clip?channel=losperris&apiKey=TU_API_KEY&user=viewer123&template=Clip+de+%7Buser%7D%3A+%7Burl%7D' \
  --header 'Accept: text/plain'

curl -i --request GET \
  --url 'https://ttv.losperris.dev/api/create-clip?channel=losperris&apiKey=TU_API_KEY&user=viewer123&template=Clip+de+%7Buser%7D%3A+%7Burl%7D' \
  --header 'Accept: text/plain'

https://ttv.losperris.dev/api/create-clip?channel=losperris&apiKey=TU_API_KEY&user=viewer123&template=Clip+de+%7Buser%7D%3A+%7Burl%7D

Respuestas

200Canal offlineSin permisoKey inválida (200)429

https://clips.twitch.tv/AwkwardHelplessSalamander-HfG3kL9mN2pQrS

HTTP/1.1 200 OK
Content-Type: text/plain; charset=utf-8
Cache-Control: public, s-maxage=10, stale-while-revalidate
X-RateLimit-Limit: 30
X-RateLimit-Remaining: 29
X-RateLimit-Reset: 1710000060

https://clips.twitch.tv/AwkwardHelplessSalamander-HfG3kL9mN2pQrS

El canal está offline. Solo se pueden crear clips en canales en directo.

HTTP/1.1 200 OK
Content-Type: text/plain; charset=utf-8
Cache-Control: public, s-maxage=10, stale-while-revalidate
X-RateLimit-Limit: 30
X-RateLimit-Remaining: 29
X-RateLimit-Reset: 1710000060

El canal está offline. Solo se pueden crear clips en canales en directo.

Sin permiso para crear clips en este canal.

HTTP/1.1 200 OK
Content-Type: text/plain; charset=utf-8
Cache-Control: public, s-maxage=10, stale-while-revalidate
X-RateLimit-Limit: 30
X-RateLimit-Remaining: 29
X-RateLimit-Reset: 1710000060

Sin permiso para crear clips en este canal.

Error de autenticación. Clave API inválida o expirada. Regenerala o pide ayuda a Ponss 🦆

HTTP/1.1 200 OK
Content-Type: text/plain; charset=utf-8
Cache-Control: public, s-maxage=10, stale-while-revalidate
X-RateLimit-Limit: 30
X-RateLimit-Remaining: 29
X-RateLimit-Reset: 1710000060

Error de autenticación. Clave API inválida o expirada. Regenerala o pide ayuda a Ponss 🦆

(sin contenido)

HTTP/1.1 429 Too Many Requests
Content-Type: text/plain; charset=utf-8
X-RateLimit-Limit: 30
X-RateLimit-Remaining: 29
X-RateLimit-Reset: 1710000060

Listar clips en JSON

Para widgets u OBS, consulta Listar clips (/dashboard/get-clips) en Extras.

Comportamiento en bots

Errores de API Key y de negocio devuelven **HTTP 200** con el mensaje en el cuerpo (así Nightbot y StreamElements lo muestran en el chat). El rate limit (**429**) devuelve **cuerpo vacío**.

Integración con bots

Wizebot y Fossabot

Wizebot y Fossabot ya incluyen el comando nativo !clip para crear clips del directo. No necesitas integrar este endpoint si usas alguno de esos bots.

Nightbot

!addcom !clip $(urlfetch https://ttv.losperris.dev/api/create-clip?channel=$(channel)&apiKey=TU_API_KEY)

StreamElements

!command add !clip ${customapi.https://ttv.losperris.dev/api/create-clip?channel=${channel}&apiKey=TU_API_KEY}

Streamlabs

{readapi.https://ttv.losperris.dev/api/create-clip?channel=TU_CANAL&apiKey=TU_API_KEY}