API de textos y hashtags para TikTok: endpoints y límites

Prueba Koda Última revisión

Koda expone tres endpoints POST —/api/v1/caption, /api/v1/hashtags y /api/v1/script—, autenticados con una clave de API que creas y revocas tú mismo. Un texto o un conjunto de hashtags cuesta 1 crédito, un guion cuesta 2, y cada respuesta devuelve credits_used y credits_remaining para que tu propio código pueda pararse antes que el saldo. Los créditos se compran en packs, desde $0.05 cada uno hasta $0.03, y son independientes de los Koda Coins que gasta el estudio.

Lo que cuesta cada llamada a los tres endpoints

Cada llamada se cobra en créditos enteros, descontados de forma atómica una vez que la generación tiene éxito: una llamada fallida no se factura, porque el descuento está condicionado a que el saldo siga siendo suficiente en el momento de la escritura.

EndpointCréditos
POST /api/v1/caption1
POST /api/v1/hashtags1
POST /api/v1/script2
Por llamada y por clave. El límite de tasa es de 5 peticiones cada 60 segundos en cada endpoint.

¿Cuánto cuesta realmente un crédito?

Cuatro tamaños de pack, y el precio unitario baja con el tamaño: $0.05 por crédito con 100, $0.03 con 5000. Un texto a la mejor tarifa son tres céntimos.

Los créditos no caducan con un periodo de facturación y no son Koda Coins. Un coin representa 0,001 $ de coste real de proveedores dentro del estudio; un crédito de API es una unidad de venta fija. Los dos nunca se convierten entre sí, y por eso se cuentan por separado en el panel.

PackPrecio por crédito
100 créditos$0.05
500 créditos$0.04
1000 créditos$0.035
5000 créditos$0.03
Tamaños de pack y lo que sale cada crédito.

Lo que te da una respuesta además del texto

Cada respuesta correcta lleva credits_used y credits_remaining. Esa es la parte que vale la pena conectar: un proceso por lotes puede leer el saldo restante en la última llamada en lugar de consultar otro endpoint, y pararse limpiamente.

Cuando el saldo es demasiado bajo, la llamada devuelve HTTP 402 con el código insufficient_credits y el saldo actual, así que el fallo es programático y no hay que analizar una cadena de error.

Lo que esto no hace

  • No genera vídeo, imágenes ni voz. La API v1 es solo texto: textos, hashtags y guiones. La generación de vídeo se queda en el estudio, donde se cobra en coins por modelo y por segundo.
  • No publica. Nada de la v1 publica en TikTok, Instagram o YouTube; conectar una cuenta y publicar son acciones del panel.
  • Tiene un límite de tasa de 5 peticiones por minuto por endpoint, que es un techo para las ráfagas, no una cuota mensual. Un proceso que necesite más tiene que dosificarse.
  • La API no tiene nivel gratuito. Los créditos se compran antes de la primera llamada.

Preguntas frecuentes

¿Los créditos de API y los Koda Coins comparten saldo?
No. Son dos saldos distintos que se muestran por separado en el panel. Los Koda Coins pagan las generaciones del estudio y siguen el coste real de proveedores; los créditos de API son una unidad de venta fija que se compra en packs para los endpoints v1.
¿Qué pasa con una llamada que falla?
No se factura. El descuento es una escritura condicional que solo se aplica si el saldo sigue siendo suficiente, y se ejecuta después de que vuelva la generación: un error del proveedor o un rechazo por límite de tasa dejan el saldo intacto.
¿Se puede revocar una clave de API?
Sí, desde la página Developer. Una clave se muestra completa una sola vez, al crearla, y se puede revocar en cualquier momento; el uso se registra por clave para que veas cuál ha gastado qué.

Prueba Koda

Prueba Koda

Cómo se hizo esta página: redactada con ayuda de IA a partir de los ajustes y límites con los que funciona el propio Koda, revisados el .