A rota completa de clipe: os três formatos de comando, todos os campos e os nomes aceitos.
!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.A diferença está em como a duração chega — e, principalmente, em quanto do texto sobra para o título.
| formato | no 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>" |
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.
<>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))
&padrao=45 ao comando.&modo=hifen continuam funcionando — o nome
antigo ainda liga o modo —, mas o marcador agora é <>.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 chat | o que sai |
|---|---|
!clip | Clipe: https://clips.twitch.tv/… |
!clip 30 | Clipe (30s): … |
!clip jogada absurda | Clipe "jogada absurda": … |
!clip 30 jogada absurda | Clipe "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.
/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.
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.
segundos, duracao ou duration.titulo, title ou nome.texto, query ou args.channel, canal, alvo ou
target. (Nas outras rotas da API, channel significa outra
coisa — qual canal operar.)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.
$(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.