API de textos y hashtags para TikTok: endpoints y límites
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.
| Endpoint | Créditos |
|---|---|
| POST /api/v1/caption | 1 |
| POST /api/v1/hashtags | 1 |
| POST /api/v1/script | 2 |
¿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.
| Pack | Precio por crédito |
|---|---|
| 100 créditos | $0.05 |
| 500 créditos | $0.04 |
| 1000 créditos | $0.035 |
| 5000 créditos | $0.03 |
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
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 .
