Empezar a usar la API de KIE
Bienvenido a KIE. Esta guía te explica la información esencial que necesitas para integrar las APIs de KIE en tu producto, incluyendo modelos, precios, autenticación, flujo de solicitudes, límites y soporte. Nuestra meta es ser claros, prácticos y amigables para desarrolladores. Por favor, léelo cuidadosamente antes de pasar a producción.
1. Modelos disponibles y el entorno de prueba (Playground)
Puedes encontrar los últimos modelos compatibles en nuestra página de Mercado:
👉 https://kie.ai/marketActualizamos y añadimos nuevos modelos tan pronto como están estables.
Cada página de modelo tiene un enlace al entorno de prueba, donde puedes probar y experimentar directamente en nuestra interfaz antes de llamar a la API.
El entorno de prueba es el mejor lugar para entender el comportamiento de los modelos, sus parámetros y los formatos de salida.
2. Precios
La lista completa y actualizada de precios está disponible aquí:
👉 https://kie.ai/pricingNuestros precios son generalmente un 30%–50% más baratos que las APIs oficiales.
Para algunos modelos, los descuentos pueden llegar hasta un 80%.
Los precios pueden cambiar cuando los proveedores upstream ajusten sus costos, por lo que siempre consulta la página de precios para obtener los últimos datos.
3. Crear y proteger tu clave de API
Crea y gestiona tus claves de API aquí:
👉 https://kie.ai/api-keyNotas importantes de seguridad:
Nunca publiques tu clave de API en el código del frontend (navegador, aplicaciones móviles o repositorios públicos).
Trata tu clave de API como un secreto.Para ayudarte a proteger tu uso, ofrecemos:
Límites de tasa por clave (por hora, diario y límite total de uso)
Soporte para lista blanca de IPs, permitiendo solo IPs de servidores autorizados acceder a la API
Estas funciones ayudan a prevenir el uso excesivo accidental y solicitudes no autorizadas.
4. Encabezados de solicitud requeridos
Toda solicitud a la API debe incluir los encabezados correctos:Authorization: Bearer
Content-Type: application/json
{"code":401,"msg":"No tienes permisos de acceso"}Siempre verifica tus encabezados al depurar problemas de autenticación.
5. Registros y detalles de tareas
Puedes revisar todas tus tareas históricas aquí:
👉 https://kie.ai/logsPara cada tarea puedes ver:
Fecha de creación
Modelo utilizado
Parámetros de entrada
Estado de la tarea
Consumo de créditos
Resultados finales o detalles del errorSi en algún momento sospechas de un uso incorrecto de créditos, esta página es la fuente de verdad para verificarlo.
6. Política de retención de datos
Ten en cuenta nuestras reglas de retención:
Archivos multimedia generados: almacenados durante 14 días, luego eliminados automáticamente
Registros de logs (texto / metadatos): almacenados durante 2 meses, luego eliminados automáticamenteSi necesitas acceso a largo plazo, asegúrate de descargar y guardar los resultados en tu propio sistema a tiempo.
7. Modelo de tarea asíncrona
Todas las tareas de generación en KIE se ejecutan de forma asíncrona.Una solicitud exitosa devuelve:
HTTP 200
Un task_idUna respuesta 200 solo indica que la tarea fue creada, no que haya finalizado.Para obtener el resultado final, debes:
Proporcionar una URL de callback (webhook) en la solicitud, o
Consultar activamente la API de "obtener información del registro" usando el task_id
8. Límites de tasa y concurrencia
Por defecto, aplicamos los siguientes límites:
Hasta 20 solicitudes de generación cada 10 segundos
Esto permite típicamente más de 100 tareas concurrentes
Los límites se aplican por cuentaSi excedes el límite:
Las solicitudes serán rechazadas con el código HTTP 429
Las solicitudes rechazadas no entrarán en colaPara la mayoría de usuarios, esto es más que suficiente. Si constantemente recibes errores 429, puedes contactar al soporte para solicitar un límite mayor — las aprobaciones se manejan con cuidado.
9. Soporte para desarrolladores
Los canales de soporte recomendados se encuentran disponibles directamente desde el panel (menú inferior izquierdo):
Ayuda en Discord
Ayuda en TelegramLo que obtienes:
Canal privado y 1 a 1
Tus datos y conversaciones son confidenciales
Respuestas más rápidas y técnicasHorario de soporte: de UTC 21:00 a UTC 17:00 (día siguiente)
Puedes también enviarnos un correo a [email protected], aunque no es la opción preferida ni la más rápida.
10. Expectativas de estabilidad
Ofrecemos acceso a APIs de primer nivel, altamente competitivas, a precios muy competitivos.Sin embargo:
No somos perfectos
Nuestra estabilidad general puede ser ligeramente inferior a la de proveedores oficiales
Este es un compromiso conscienteEn la práctica, KIE es suficientemente estable para soportar cargas de trabajo en producción y el crecimiento a largo plazo de tu negocio, pero creemos en establecer expectativas realistas desde el principio.
11. Sobre el Equipo
KIE está construido por un pequeño equipo de una startup.
Nos movemos rápido
Nos importa profundamente la experiencia del desarrollador
Estamos siempre mejorandoAl mismo tiempo, reconocemos que:
No todo es perfecto
No podemos cubrir cada caso de uso de inmediatoTu opinión nos ayuda a mejorar — y realmente lo apreciamos.