GET /clips

A rota completa de clipe: os três formatos de comando, todos os campos e os nomes aceitos.

Só quer o !clip funcionando no chat? O comando pronto, com o formato recomendado já escolhido, está em !clip. Esta página é para quem quer montar de outro jeito.

Os três formatos

A diferença está em como a duração chega — e, principalmente, em quanto do texto sobra para o título.

formatono comando"!clip 7 balas lindas <29>" vira
A&segundos=30&texto=…30s — "7 balas lindas <29>"
C&modo=tag&texto=…29s — "7 balas lindas"
sem o <29>: 60s, mesmo título
B&texto=…7s — "balas lindas <29>"

Formato A — título inteiro, duração fixa

Você fixa a duração no comando; tudo que o viewer digitar vira título, número e tudo. !clip 7 balas lindas → clipe de 30s chamado "7 balas lindas".

# StreamElements
$(customapi.https://www.asrus.app/api/v1/clips?format=text&key=SUA_CHAVE&segundos=30&texto=$(queryescape ${1:}))

# Nightbot
!addcom !clip -cd=30 $(urlfetch https://www.asrus.app/api/v1/clips?format=text&key=SUA_CHAVE&segundos=30&texto=$(querystring))

Quer que o viewer também escolha a duração? Troque o 30 por ${1} (SE) ou $(1) (Nightbot): aí a primeira palavra vira a duração e continua no título, porque os campos são independentes.

Formato C — duração no fim, dentro de <>

Um campo só, mas sem comer o número do título: a duração vai no fim da frase. É o formato que a rota curta usa por padrão.

# StreamElements
$(customapi.https://www.asrus.app/api/v1/clips?format=text&key=SUA_CHAVE&modo=tag&texto=$(queryescape ${1:}))

# Nightbot
!addcom !clip -cd=30 $(urlfetch https://www.asrus.app/api/v1/clips?format=text&key=SUA_CHAVE&modo=tag&texto=$(querystring))

Formato B — um campo só, duração adivinhada

Sem &segundos=, a primeira palavra numérica é lida como duração e sai do título. Conveniente para quem quer !clip, !clip 30 e !clip jogada absurda no mesmo comando — mas !clip 7 balas lindas viraria um clipe de 7s chamado "balas lindas".

# StreamElements
$(customapi.https://www.asrus.app/api/v1/clips?format=text&key=SUA_CHAVE&texto=$(queryescape ${1:}))

# Nightbot
!addcom !clip -cd=30 $(urlfetch https://www.asrus.app/api/v1/clips?format=text&key=SUA_CHAVE&texto=$(querystring))
o que digitam no chato que sai
!clipClipe: https://clips.twitch.tv/…
!clip 30Clipe (30s): …
!clip jogada absurdaClipe "jogada absurda": …
!clip 30 jogada absurdaClipe "jogada absurda" (30s): …

Nos dois formatos, texto= recebe o argumento inteiro ($(querystring) no Nightbot, $(queryescape ${1:}) no StreamElements — os dois já escapam os espaços). O que muda é só se ele é fatiado ou não: a presença de &segundos= no comando é o que desliga a adivinhação, mesmo que o valor chegue vazio. Em !clip 2 kills, sem &segundos=, o 2 vira duração e o título fica "kills" — é o preço de um campo só decidir as duas coisas, e é o que o formato A resolve.

A rota curta /api/v1/c/<chave>

É o mesmo /api/v1/clips com os padrões embutidos: resposta em texto, modo=tag e só o link no chat. Campos curtos: t (texto), s (segundos), p (padrão). Os nomes longos continuam valendo.

O título não volta na resposta porque ele já está gravado no clipe, e quem pediu acabou de digitá-lo — repetir gasta uma linha do chat para não dizer nada novo. Se preferir a linha inteira, com título e duração, peça &r=completo. Em /api/v1/clips é o contrário: a linha inteira é o padrão, e &resposta=link encurta.

Quando o bot não substitui a variável

Se o campo chegar sendo só o placeholder (${1:}, $(querystring)), ele conta como vazio em vez de virar o título do clipe. Mas só quando é só o placeholder: 100% insano e custou R$50 continuam sendo títulos legítimos.

Nomes dos campos

Duração e título são os dois opcionais: sem nenhum dos dois, ou com a variável do bot não substituída, sai clipe com os padrões em vez de erro. !clip tem que continuar clipando.

A faixa aceita aqui é de 1 a 60 segundos, e o título é cortado em 100 caracteres. Esse corte é nosso: a Twitch não documenta o limite dela. A documentação dela fala em 5 segundos como mínimo, e não cravamos esse número aqui de propósito — se ela recusar, a mensagem dela chega ao chat. Assim a regra continua sendo da Twitch, e não uma cópia que envelhece.

O $(queryescape) não dá para tirar, e é melhor saber por quê: sem ele, o StreamElements exige a URL como um token único e descarta os espaços — !clip 7 balas lindas chegaria aqui como 7balaslindas. Isso se perde antes de virar requisição, então não é recuperável deste lado. No Nightbot, o $(querystring) já é a versão codificada, então lá não há nada extra a fazer.