MercadoSoporte← Volver a la app

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/json

Si 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.