API de legendas e hashtags de TikTok: endpoints e limites

Experimente o Koda Última verificação

O Koda expõe três endpoints POST — /api/v1/caption, /api/v1/hashtags e /api/v1/script —, autenticados por uma chave de API que você mesmo cria e revoga. Uma legenda ou um conjunto de hashtags custa 1 crédito, um roteiro custa 2, e toda resposta retorna credits_used e credits_remaining para que o seu próprio código possa parar antes do saldo. Os créditos são comprados em pacotes, de $0.05 cada até $0.03, e são separados dos Koda Coins que o estúdio gasta.

Quanto custa cada chamada aos três endpoints

Cada chamada é cobrada em créditos inteiros, debitados de forma atômica assim que a geração dá certo — uma chamada que falha não é cobrada, porque o débito depende de o saldo ainda ser suficiente no momento da gravação.

EndpointCréditos
POST /api/v1/caption1
POST /api/v1/hashtags1
POST /api/v1/script2
Por chamada, por chave. O limite de taxa é de 5 requisições a cada 60 segundos em cada endpoint.

Quanto custa um crédito de verdade?

Quatro tamanhos de pacote, e o preço unitário cai com o tamanho: $0.05 por crédito com 100, $0.03 com 5000. Uma legenda no melhor preço sai por três centavos.

Os créditos não expiram com um período de cobrança e não são Koda Coins. Um coin representa US$ 0,001 de custo real de fornecedores dentro do estúdio; um crédito de API é uma unidade de varejo fixa. Os dois nunca se convertem um no outro, e é por isso que são contados separadamente no painel.

PacotePreço por crédito
100 créditos$0.05
500 créditos$0.04
1000 créditos$0.035
5000 créditos$0.03
Tamanhos de pacote e quanto sai cada crédito.

O que uma resposta te dá além do texto

Toda resposta bem-sucedida traz credits_used e credits_remaining. Essa é a parte que vale integrar: um job em lote pode ler o saldo restante na última chamada em vez de consultar outro endpoint, e parar de forma limpa.

Quando o saldo está baixo demais, a chamada retorna HTTP 402 com o código insufficient_credits e o saldo atual, então a falha é programática e não depende de interpretar uma string de erro.

O que isto não faz

  • Não gera vídeo, imagens nem voz. A API v1 é só texto — legendas, hashtags e roteiros. A geração de vídeo fica no estúdio, onde é cobrada em coins por modelo e por segundo.
  • Não publica. Nada na v1 posta no TikTok, no Instagram ou no YouTube; conectar uma conta e publicar são ações do painel.
  • Tem limite de taxa de 5 requisições por minuto por endpoint, que é um teto para rajadas, não uma cota mensal. Um job que precisa de mais tem que se dosar.
  • Não existe plano grátis na API. Os créditos são comprados antes da primeira chamada.

Perguntas frequentes

Os créditos de API e os Koda Coins dividem o mesmo saldo?
Não. São dois saldos separados, mostrados separadamente no painel. Os Koda Coins pagam as gerações do estúdio e acompanham o custo real de fornecedores; os créditos de API são uma unidade de varejo fixa, comprada em pacotes para os endpoints v1.
O que acontece com uma chamada que falha?
Ela não é cobrada. O débito é uma gravação condicional que só se aplica quando o saldo ainda é suficiente, e roda depois que a geração retorna — então um erro do fornecedor ou uma recusa por limite de taxa deixam o saldo intacto.
Uma chave de API pode ser revogada?
Sim, na página Developer. Uma chave é mostrada por inteiro uma única vez, na criação, e pode ser revogada a qualquer momento; o uso é registrado por chave para você ver qual gastou o quê.

Experimente o Koda

Experimente o Koda

Como esta página foi feita: redigida com ajuda de IA a partir das configurações e limites com que o próprio Koda funciona, verificados em .