FAQ
Respuestas a las preguntas que más nos hacen — precios, errores de protocolo, tareas atascadas, moderación de contenido, cuentas y límites.
General
¿Qué es Atlas Cloud?
Atlas Cloud es una plataforma de agregación de APIs de IA. Una sola clave de API y un solo saldo te dan acceso a más de 400 modelos — modelos de lenguaje, imagen, video, audio y 3D — de muchos proveedores, sin tener que registrarte por separado en cada uno.
¿Cómo empiezo?
- Crea una cuenta
- Crea una clave de API
- Sigue Inicio rápido para tu primera solicitud
¿Qué modelos están disponibles?
Explora la Biblioteca de modelos. El catálogo cambia con frecuencia, así que esa es la lista de referencia — la documentación evita deliberadamente fijar nombres de modelos que quedarían obsoletos.
¿La API es compatible con OpenAI?
Sí, y con más que eso. Atlas Cloud acepta seis formatos de solicitud: OpenAI Chat Completions, Completions, Responses e Images, además de Anthropic Messages y Google Gemini. Consulta Protocolos de API para LLM.
API y aspectos técnicos
Llamo a un modelo y recibo un 400. ¿Por qué?
La causa más habitual es usar el protocolo equivocado para ese modelo. No todos los modelos aceptan todos los formatos:
- Los modelos de la familia Anthropic esperan
POST /v1/messages, no/v1/chat/completions - Algunos modelos de razonamiento de OpenAI y de la familia codex esperan
POST /v1/responses, no/v1/chat/completions
Cada modelo publica los protocolos que admite. Revisa la referencia de API del modelo antes de cambiar de formato y consulta Protocolos de API para LLM para ver las diferencias entre ellos.
¿Cuáles son los endpoints de la API?
| Propósito | Endpoint |
|---|---|
| Chat con LLM | POST /v1/chat/completions |
| LLM (formato Anthropic) | POST /v1/messages |
| LLM (formato Responses) | POST /v1/responses |
| Generación de imagen y 3D | POST /api/v1/model/generateImage |
| Generación de video | POST /api/v1/model/generateVideo |
| Audio: voz, música, transcripción | POST /api/v1/model/generateAudio |
| Consultar el estado de una tarea | GET /api/v1/model/prediction/{id} |
| Subir un archivo | POST /api/v1/model/uploadMedia |
| Saldo y uso | GET /public/v1/balance |
Base URL: https://api.atlascloud.ai
Mi tarea lleva mucho tiempo en processing. ¿Puedo cancelarla?
La generación de imagen, video, audio y 3D es asíncrona. Envía la tarea y luego consulta GET /api/v1/model/prediction/{id} hasta que alcance un estado terminal. Las tareas de video, en particular, pueden tardar minutos.
No existe un endpoint de cancelación. Las tareas que superan el tiempo de espera de la plataforma se terminan y se reembolsan automáticamente.
Si estás consultando el estado con mucha frecuencia, cambia a webhooks — recibes una llamada de vuelta cuando la tarea se resuelve, en lugar de mantener abierto un bucle de sondeo.
¿Admiten webhooks?
Sí, para tareas de imagen, video y audio. Consulta Webhooks para conocer el formato del payload y la verificación de firma.
¿Cómo subo archivos?
Usa POST /api/v1/model/uploadMedia y pasa la URL devuelta a tu solicitud de generación. También puedes proporcionar directamente una URL pública, o Base64 en línea para la mayoría de los campos de imagen y audio. Consulta Subir archivos.
¿Hay límites de tasa?
Sí, aplicados por cuenta y por modelo. Superar uno devuelve 429.
Ten en cuenta que los endpoints de LLM y de medios no devuelven encabezados de límite de tasa, así que no puedes leer tu cuota restante desde una respuesta — implementa backoff exponencial en su lugar. Consulta Errores y límites de tasa.
¿Necesitas límites más altos? Contáctanos indicando tu volumen previsto.
Recibo errores 401. ¿Cómo lo depuro?
Comprueba en este orden:
- ¿La clave es correcta y sigue activa? Revisa Claves de API
- ¿La clave tiene el alcance adecuado? Una clave de Coding Plan no puede llamar a modelos que no la aceptan
- En un contexto de equipo, ¿estás usando una clave creada en la cuenta correcta?
- ¿La ruta de la URL es correcta? La pasarela autentica antes de enrutar, así que una errata en la ruta también devuelve
401en lugar de404
¿Qué es el servidor MCP?
Un servidor MCP oficial que expone Atlas Cloud como herramientas dentro de los IDE asistidos por IA — genera medios, chatea con modelos y consulta tu saldo sin salir del editor.
Precios y facturación
¿El precio de la ficha de un modelo es el costo total?
No — en los modelos de imagen y video es un precio unitario. El costo final depende de parámetros como la duración, la resolución y el número de salidas. Un modelo de video con precio por segundo costará esa tarifa multiplicada por la duración del clip.
Para obtener una cifra exacta antes de gastar nada, usa la estimación de precio antes de enviar. Consulta Cómo se facturan los modelos para ver ejemplos resueltos.
¿Por qué el precio que vi no coincide con mi factura?
Tres cosas pueden diferir:
- La ficha del modelo muestra un precio unitario de lista
- El playground recalcula a medida que cambias los parámetros
- Tu factura también refleja descuentos y promociones de la cuenta
Imagen y video usan facturación asíncrona: se retiene un importe al enviar y se liquida contra el uso real cuando la tarea termina. Una retención pendiente no es un cargo definitivo.
¿Las solicitudes fallidas cuestan dinero?
No. Las tareas que fallan, agotan el tiempo de espera o son rechazadas por la moderación de contenido no se facturan. Si ves un cargo que no puedes explicar, contacta con soporte indicando el ID de la predicción.
¿Mi saldo puede volverse negativo?
Puede quedar ligeramente en negativo con un uso de LLM de alta concurrencia, ya que las llamadas a modelos de lenguaje no se preautorizan. Un saldo negativo bloquea las solicitudes posteriores. Activa la recarga automática para evitar interrupciones.
¿Los créditos del Coding Plan se pueden usar para imagen o video?
No. Un Coding Plan es una asignación de suscripción independiente destinada al uso de modelos de lenguaje, y no se puede gastar en generación de imagen, video ni audio. Esas se descuentan de tu saldo habitual. Los créditos del Coding Plan tampoco se pueden convertir en saldo de la cuenta.
¿Cómo obtengo una factura?
Solicítala o vuelve a emitirla desde el historial de facturación de tu panel. Los enlaces de descarga tienen validez limitada, así que guarda el PDF en el momento en que lo generes.
¿Qué métodos de pago se aceptan?
Tarjetas de crédito y débito (a través de Stripe), WeChat Pay, Alipay y criptomonedas. Los pagos se procesan en USD.
¿Hay bonos de registro o programa de referidos?
Atlas Cloud lanza promociones de recarga de vez en cuando — consulta la página de facturación para ver cuáles están activas. También existe un programa de referidos: comparte tu enlace y gana créditos cuando alguien a quien refieres completa su primera recarga. Consulta Saldo y créditos.
¿Los créditos caducan?
Los créditos prepagados son válidos durante un periodo definido desde la fecha de compra, y los créditos promocionales pueden tener sus propias condiciones. Consulta Saldo y créditos y la Política de uso aceptable.
Contenido y moderación
Mi generación de video falló con un error de copyright o de audio sensible. ¿Qué hago?
Esto suele venir de la pista de audio, no del video. Opciones:
- Desactiva la generación de audio si no la necesitas — muchos modelos de video aceptan un indicador como
generate_audio: false - Aporta tu propio audio libre de derechos como banda sonora
- Reformula el prompt para pedir música original en lugar de nombrar una pista o un artista existente
Las solicitudes bloqueadas por la moderación no se facturan.
Mi generación fue bloqueada por la moderación de contenido. ¿Por qué?
Se rechazan los prompts que describen personas reales, menores u otro contenido restringido. Algunos modelos admiten la generación guiada por referencias con material que tú subes, que es la vía admitida para trabajar con parecidos. Consulta la Política de uso aceptable.
Un modelo que estaba usando ha desaparecido. ¿Qué pasó?
De vez en cuando se retiran modelos cuando un proveedor los discontinúa o su fiabilidad baja. La Biblioteca de modelos siempre refleja lo que está disponible en este momento. Si ha desaparecido un modelo del que dependes, contacta con soporte y podremos sugerirte un reemplazo.
Cuentas y equipos
Inicié sesión con GitHub pero no puedo añadir saldo.
GitHub no siempre devuelve una dirección de correo, y la facturación requiere una. Añade un correo desde la configuración de la cuenta y luego recarga con normalidad.
Inicié sesión y mi saldo no aparece.
Puede que hayas creado una segunda cuenta. Iniciar sesión con Google, GitHub o correo genera cuentas separadas incluso con la misma dirección, salvo que se hayan vinculado. Inicia sesión de la misma forma con la que te registraste originalmente. Si existen duplicados, contacta con soporte.
¿Qué pueden hacer los equipos?
Las cuentas de equipo comparten un saldo, admiten varios miembros con roles y te permiten crear claves de API con alcance de equipo. El gasto se puede desglosar por clave y por miembro, y el saldo se puede transferir entre una cuenta personal y un equipo. Consulta Cuenta de equipo y Control de acceso basado en roles.
¿Cómo elimino mi cuenta?
Contacta con soporte desde tu dirección de correo registrada indicando el UUID de tu cuenta. Ten en cuenta que:
- El saldo restante no es reembolsable — gástalo antes
- Hay un periodo de reflexión durante el cual puedes cancelar la solicitud
- Tras el cierre, ese mismo correo no se puede usar para registrarse de nuevo
Si solo quieres eliminar el contenido generado sin cerrar la cuenta, puedes borrar los registros del historial directamente. Consulta la Política de eliminación de datos.
Datos y seguridad
¿Cómo se tratan mis datos?
Las solicitudes se transmiten por TLS. Atlas Cloud conserva el contenido de las solicitudes solo brevemente, para prestar el servicio y facturar, y cada proveedor upstream tiene su propia política de retención. Consulta Retención de datos y la Política de privacidad.
¿Se usa mi contenido para entrenar modelos?
No. Atlas Cloud no usa el contenido enviado a través de la plataforma para entrenar, ajustar, evaluar ni comparar sus modelos alojados, salvo que lo autorices por escrito.
¿Puedo controlar cuánto tiempo se conservan mis datos?
Sí. Las solicitudes de generación de medios aceptan encabezados de retención por solicitud que acortan el tiempo que se conservan los archivos generados y los registros de la solicitud. Consulta Retención de datos.
¿Qué pasa con los derechos de protección de datos?
Puedes solicitar acceso, eliminación o exportación de tus datos personales en cualquier momento. Escribe a [email protected]. Consulta la Política de eliminación de datos para saber qué se elimina y qué debe conservarse por motivos legales y contables.
Cómo obtener ayuda
- Documentación — explora la barra lateral, o empieza por Inicio rápido
- Soporte por correo — [email protected]
- Comunidad — Discord
- Ventas y precios por volumen — [email protected]
- Solicitudes de privacidad — [email protected]
Cuando reportes un problema de la API, incluye el encabezado X-Request-ID de la respuesta fallida, o el ID de la predicción si se trata de una tarea de generación. Consulta Errores y límites de tasa.
Last updated on