Claves API

Las claves API se utilizan para autenticar tus solicitudes a las APIs de Atlas Cloud. Cada llamada API requiere una clave API válida.

Crear una clave API

Inicia sesión en la Consola de Atlas Cloud
Ve a Configuración de la cuenta
Expande la sección Gestión de claves API
Haz clic en Crear clave API
Copia tu nueva clave API y guárdala de forma segura

Crear clave API

Tu clave API solo se mostrará una vez al crearla. Si la pierdes, deberás crear una nueva.

Uso de tu clave API

Incluye tu clave API en el encabezado Authorization de cada solicitud API:

Authorization: Bearer your-api-key

LLM / Completado de chat (compatible con OpenAI)

URL base: https://api.atlascloud.ai/v1

from openai import OpenAI

client = OpenAI(
    api_key="your-api-key",
    base_url="https://api.atlascloud.ai/v1"
)

response = client.chat.completions.create(
    model="deepseek-v3",
    messages=[{"role": "user", "content": "Hello!"}]
)

Generación de imágenes / videos

URL base: https://api.atlascloud.ai/api/v1

import requests

response = requests.post(
    "https://api.atlascloud.ai/api/v1/model/generateImage",
    headers={"Authorization": "Bearer your-api-key"},
    json={
        "model": "seedream-3.0",
        "prompt": "A cat sitting on a rainbow"
    }
)

Subir archivos multimedia

import requests

response = requests.post(
    "https://api.atlascloud.ai/api/v1/model/uploadMedia",
    headers={"Authorization": "Bearer your-api-key"},
    files={"file": open("photo.jpg", "rb")}
)

# Devuelve una URL temporal para usar con tareas de generación
print(response.json())

Integración con herramientas de terceros

Puedes usar tu clave API de Atlas Cloud con cualquier herramienta o aplicación compatible con OpenAI. Las opciones populares incluyen:

Herramienta	Tipo	Configuración
Chatbox	App de escritorio	Configura el host API como `https://api.atlascloud.ai/v1`
Cherry Studio	App de escritorio	Añadir como proveedor OpenAI personalizado
OpenWebUI	Interfaz web	Configurar endpoint compatible con OpenAI
Cursor	IDE	Usar vía Servidor MCP
Claude Code	CLI	Usar vía Servidor MCP o Skills

Al configurar herramientas de terceros:

Host API / URL base: https://api.atlascloud.ai/v1 (el sufijo /v1 es obligatorio)
Clave API: Tu clave API de Atlas Cloud
Nombre del modelo: Cualquier modelo de la Biblioteca de modelos

Mejores prácticas de seguridad

Nunca compartas tu clave API ni la incluyas en el control de versiones
Usa variables de entorno para almacenar tu clave API:
```
export ATLASCLOUD_API_KEY="your-api-key"
```
Rota las claves regularmente — elimina las claves antiguas y crea nuevas
Usa claves separadas para entornos de desarrollo y producción
Monitorea el uso en la Consola para detectar uso no autorizado

Gestión de claves

Puedes gestionar tus claves API en Configuración de la cuenta:

Crear — Genera nuevas claves API según sea necesario
Eliminar — Revoca claves API que ya no se necesiten o que puedan haberse comprometido
Ver uso — Monitorea el uso y los costos de la API asociados a cada clave

Límites de velocidad

Los límites de velocidad de la API varían según el nivel de cuenta y el tipo de modelo. Si encuentras errores de límite de velocidad (429 Too Many Requests), considera:

Añadir un pequeño retraso entre solicitudes
Usar retroceso exponencial para reintentos
Contactar a [email protected] para límites más altos

En esta página