API de legendas e hashtags de TikTok: endpoints e limites
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.
| Endpoint | Créditos |
|---|---|
| POST /api/v1/caption | 1 |
| POST /api/v1/hashtags | 1 |
| POST /api/v1/script | 2 |
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.
| Pacote | Preço por crédito |
|---|---|
| 100 créditos | $0.05 |
| 500 créditos | $0.04 |
| 1000 créditos | $0.035 |
| 5000 créditos | $0.03 |
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
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 .
