AI

Usa la API de AI en tus aplicaciones y automatizaciones con una clave API propia, entradas de texto e imágenes, transmisión y respuestas estructuradas.

Enlace: AI

Iniciar sesión/Registrarse

1. Abre Iniciar sesión.
2. Accede con Apple, Google o un código por correo. Los nuevos usuarios se registran automáticamente.
3. La misma cuenta gestiona tus servicios AI, saldo y documentos de facturación.

Recargar saldo

1. Abre Métodos de pago y añade fondos con un método disponible.
2. Mantén saldo suficiente para el precio mensual indicado antes de la compra y para las futuras renovaciones.

Comprar el servicio

1. Abre AI.
2. Introduce un nombre para tu aplicación o integración y pulsa Continuar.
3. Revisa el precio mensual y confirma la creación. Abre el pedido AI en Perfil para ver su clave API y el límite de solicitudes por minuto.

Conectar tu aplicación

Asigna de forma segura la clave generada a AI_API_KEY. Guárdala en tu servidor; no la incluyas en el código público de tu sitio web ni en los paquetes de tu aplicación móvil.

En clientes con una URL base de API configurable, usa https://yoosolutions.com/api/v1/ai y el modelo ai. El proveedor y el modelo asignados a tu pedido procesan la solicitud; las funciones disponibles dependen de ese modelo.

curl --request POST 'https://yoosolutions.com/api/v1/ai/chat/completions' \
  --header "Authorization: Bearer ${AI_API_KEY}" \
  --header 'Content-Type: application/json' \
  --data '{"model":"ai","messages":[{"role":"user","content":"Resume el progreso de este proyecto."}]}'

Lee la respuesta en choices[0].message.content del resultado JSON.

Solicitudes compatibles

• Envía texto en messages. Los mensajes del usuario también pueden incluir partes image_url con datos JPEG, PNG o WebP en base64; las URL de imágenes remotas se rechazan.
• Usa response_format con text, json_object o json_schema. La salida con esquema JSON requiere strict: true.
• Establece stream: true para la transmisión. Para incluir el uso, añade también stream_options.include_usage: true.
• Controla la longitud de la respuesta con max_completion_tokens. Si se envía store, debe ser false; se rechazan los demás campos no documentados.
• Las solicitudes no conservan el estado de la conversación. Incluye en messages el historial necesario para cada solicitud.

Límites y facturación

• Las solicitudes tienen un límite de 20 MiB, 120 segundos y 16384 tokens de salida, con 4096 tokens de salida por defecto.
• El límite de solicitudes por minuto indicado en tu pedido usa una ventana móvil de 60 segundos y se mantiene al restablecer la clave.
• Las renovaciones se cobran del saldo. Si una renovación queda sin pagar, el acceso a la API se bloquea hasta que se pague correctamente. El historial de facturación, las facturas y los recibos están disponibles en Perfil.

Gestionar tu servicio

• Editar cambia el nombre del servicio sin modificar la clave, el modelo ni el límite.
• Restablecer genera una nueva clave API y revoca inmediatamente la anterior. Actualiza la clave en tu aplicación; restablecerla no reinicia el límite de solicitudes.
• Eliminar revoca el acceso a la API y detiene los futuros cobros del servicio.

Solución de problemas

• 400: comprueba los campos de la solicitud, el modelo ai y el formato de los mensajes.
• 401: comprueba la clave bearer y actualízala después de restablecerla.
• 402: comprueba el saldo y el pago de la renovación en Perfil.
• 429: antes de reintentarlo, espera los segundos indicados en la cabecera Retry-After.
• 503: el modelo o proveedor asignado no está disponible. Inténtalo más tarde o contacta con Soporte.