Primeros pasos con la API de 97AI.PRO (importante)
Te damos la bienvenida a 97AI.PRO. Esta guía te lleva por la información esencial para empezar a integrar las APIs de 97AI.PRO en tu producto, incluidos modelos, precios, autenticación, flujo de solicitudes, límites y soporte.
Buscamos ser transparentes, prácticos y cercanos a los desarrolladores. Léela con atención antes de pasar a producción.
1. Modelos disponibles y Playground
Encuentra los últimos modelos compatibles en nuestra página de Mercado: 👉 /market
Actualizamos e incorporamos nuevos modelos continuamente en cuanto son estables.
Cada página de modelo enlaza a su Playground, donde puedes probar y experimentar directamente en nuestra interfaz antes de llamar a la API. El Playground es el mejor lugar para entender el comportamiento del modelo, sus parámetros y los formatos de salida.
2. Precios
La lista de precios completa y actualizada está aquí: 👉 /pricing
Nuestros precios suelen ser entre un 30% y un 50% más bajos que las APIs oficiales. En algunos modelos, los descuentos llegan hasta el 80%.
Los precios pueden cambiar cuando los proveedores upstream ajustan sus costos, así que consulta siempre la página de precios para ver las cifras más recientes.
3. Crear y proteger tu API key
Crea y gestiona tus API keys aquí: 👉 /api-keys
Notas de seguridad importantes:
- Nunca expongas tu API key en código de frontend (navegador, apps móviles, repositorios públicos).
- Trata tu API key como un secreto.
Para ayudar a proteger tu uso, ofrecemos:
- Límites de tasa por clave (topes horarios, diarios y de uso total)
- Soporte de lista blanca de IP, que permite el acceso a la API solo a IPs de servidor aprobadas
4. Encabezados de solicitud requeridos
Cada solicitud a la API debe incluir los encabezados correctos:
Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/jsonSi estos encabezados faltan o son incorrectos, puedes recibir:
{"error":"Please log in or provide an API key"}5. Registros y detalles de la tarea
Puedes inspeccionar todas tus tareas históricas aquí: 👉 /logs
Para cada tarea puedes ver: hora de creación, modelo utilizado, parámetros de entrada, estado de la tarea, consumo de créditos y los resultados finales o detalles del error.
6. Política de retención de datos
- Archivos multimedia generados: se conservan 14 días y luego se eliminan automáticamente
- Registros de log (texto / metadatos): se conservan 2 meses y luego se eliminan automáticamente
Si necesitas acceso a largo plazo, asegúrate de descargar y guardar los resultados a tiempo en tu lado.
7. Modelo de tareas asíncronas
Todas las tareas de generación en 97AI.PRO son asíncronas. Un POST /api/generate exitoso devuelve HTTP 200 con un taskId y state: "waiting".
Eso solo significa que la tarea fue aceptada, no que haya terminado. Sondea GET /api/generate/{taskId} cada pocos segundos hasta que state sea success o fail. Las solicitudes de chat (POST /api/chat) son síncronas y devuelven la respuesta directamente.
8. Límites y uso justo
- Hoy no hay un límite estricto de tasa ni de concurrencia en el relay.
- Para iniciar una tarea debes tener un saldo mínimo (por defecto 50 créditos); se liquida al costo real al completarse.
- Las tareas fallidas no se facturan.
Aun así, llama de forma responsable — el tráfico abusivo puede limitarse. Si necesitas un rendimiento alto garantizado, contáctanos a través de la comunidad.
9. Soporte para desarrolladores
Haz preguntas y comparte comentarios en la comunidad — la forma más rápida de contactarnos a nosotros y a otros desarrolladores.
También puedes escribir a [email protected]. Incluye tu taskId al reportar una generación fallida.
10. Expectativas de estabilidad
Ofrecemos acceso a APIs de primer nivel y muy competitivas a precios muy agresivos. Nuestra estabilidad general puede ser algo menor que la de los proveedores oficiales — una compensación consciente. En la práctica, 97AI.PRO es lo bastante estable para soportar cargas de producción y el crecimiento del negocio a largo plazo.
11. Sobre el equipo
97AI.PRO está construido por un pequeño equipo de startup. Nos movemos rápido, nos importa profundamente la experiencia del desarrollador y mejoramos constantemente. Tus comentarios nos ayudan a mejorar — y de verdad los agradecemos.