Autenticación

Todos los endpoints /api/v1 requieren una clave API Bearer.

Encabezado de Autorización

Envía tu clave en el encabezado Authorization:

Authorization: Bearer sk_live_your_key_here

Si el encabezado falta o es inválido, la API devuelve:

{ "error": "Missing Authorization Bearer token" }

{ "error": "Invalid API key" }

Crear y Gestionar Claves API

Crea, lista y revoca claves desde:

https://armox.ai/app/settings/api-keys

Cada clave tiene:

name
key_prefix
expires_at (opcional)
rate_limit_per_minute
is_active

Importante: los valores completos de las claves se muestran solo una vez en el momento de la creación.

Formato de Clave

Las claves API de Armox usan este prefijo:

sk_live_...

Trata las claves como contraseñas.

Ejemplos de Solicitudes

cURL

curl -X GET "https://armox.ai/api/v1/models" \
  -H "Authorization: Bearer sk_live_your_key_here"

JavaScript (fetch)

const response = await fetch("https://armox.ai/api/v1/models", {
  method: "GET",
  headers: {
    Authorization: "Bearer sk_live_your_key_here",
  },
});

const data = await response.json();
console.log(data);

Python

import requests

response = requests.get(
    "https://armox.ai/api/v1/models",
    headers={"Authorization": "Bearer sk_live_your_key_here"},
)

print(response.status_code)
print(response.json())

Go

package main

import (
  "fmt"
  "net/http"
)

func main() {
  req, _ := http.NewRequest("GET", "https://armox.ai/api/v1/models", nil)
  req.Header.Set("Authorization", "Bearer sk_live_your_key_here")

  client := &http.Client{}
  resp, _ := client.Do(req)
  defer resp.Body.Close()

  fmt.Println("Status:", resp.StatusCode)
}

Requisitos de Acceso

El acceso a la API Pública requiere una suscripción elegible:

Agency
Master / Business
Enterprise

Si la cuenta de usuario no es elegible, la API devuelve:

{
  "error": "Public API access requires Agency, Master/Business, or Enterprise plan."
}

Mejores Prácticas de Seguridad

Usa una clave por entorno (desarrollo, staging, producción)
Rota las claves regularmente
Revoca las claves comprometidas inmediatamente
Nunca expongas claves API en código frontend/navegador
Almacena las claves en gestores de secretos del lado del servidor
Restringe el acceso interno por servicio/cuenta