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/market Actualizamos 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/pricing Nuestros 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-key Notas 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
5. Registros y detalles de tareas
Puedes revisar todas tus tareas históricas aquí: 👉 https://kie.ai/logs Para 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 error Si 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áticamente Si 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_id Una 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 cuenta Si excedes el límite: Las solicitudes serán rechazadas con el código HTTP 429 Las solicitudes rechazadas no entrarán en cola Para 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 Telegram Lo que obtienes: Canal privado y 1 a 1 Tus datos y conversaciones son confidenciales Respuestas más rápidas y técnicas Horario 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 consciente En 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 mejorando Al mismo tiempo, reconocemos que: No todo es perfecto No podemos cubrir cada caso de uso de inmediato Tu opinión nos ayuda a mejorar — y realmente lo apreciamos.