Documentación

Todo lo que necesitas para integrar IA Box en tu aplicación

Quick Start

Comienza a usar IA Box en 5 minutos: 

from openai import OpenAI

client = OpenAI(
    base_url="https://clouds.com.bo/v1",
    api_key="sk-air-your-api-key-here"
)

response = client.chat.completions.create(
    model="openai/gpt-3.5-turbo",
    messages=[
        {"role": "user", "content": "¡Hola!"}
    ]
)

print(response.choices[0].message.content)

Tip: IA Box es compatible con la SDK de OpenAI, así que solo necesitas cambiar la URL base y tu API key.

Autenticación

IA Box soporta dos métodos de autenticación:

1. Header X-API-Key

curl -X POST https://clouds.com.bo/airouter/v1/chat/completions \
  -H "X-API-Key: sk-air-your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{...}'

2. Bearer Token

curl -X POST https://clouds.com.bo/airouter/v1/chat/completions \
  -H "Authorization: Bearer sk-air-your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{...}'

Endpoints Disponibles

POST /airouter/v1/chat/completions

Envía una solicitud de chat completion a OpenRouter.

Parámetros:

  • model (required) - El modelo a usar
  • messages (required) - Array de mensajes
  • temperature (optional) - Creatividad (0-2)
  • max_tokens (optional) - Máximo de tokens
GET /airouter/v1/models

Obtén la lista de modelos disponibles de OpenRouter.

GET /airouter/user/info

Obtén información sobre el usuario actual y su uso de tokens.

Respuesta:

{
  "email": "user@example.com",
  "name": "John Doe",
  "plan": "pro",
  "tokens_used": 12500,
  "tokens_limit": 3000000,
  "tokens_remaining": 2987500,
  "usage_percentage": 0.42,
  "is_active": true,
  "last_request_at": "2025-01-26T10:30:00Z"
}
GET /airouter/health

Verifica el estado del gateway (no requiere autenticación).

Ejemplos

JavaScript / TypeScript

import OpenAI from 'openai';

const client = new OpenAI({
  baseURL: 'https://clouds.com.bo/v1',
  apiKey: 'sk-air-your-api-key-here',
});

const response = await client.chat.completions.create({
  model: 'openai/gpt-3.5-turbo',
  messages: [{ role: 'user', content: 'Hola' }],
});

console.log(response.choices[0].message.content);

PHP

$ch = curl_init('https://clouds.com.bo/v1/chat/completions');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer sk-air-your-api-key-here',
    'Content-Type: application/json'
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
    'model' => 'openai/gpt-3.5-turbo',
    'messages' => [
        ['role' => 'user', 'content' => 'Hola']
    ]
]));

$response = curl_exec($ch);
$data = json_decode($response, true);
echo $data['choices'][0]['message']['content'];

cURL

curl -X POST https://clouds.com.bo/airouter/v1/chat/completions \
  -H "Authorization: Bearer sk-air-your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-3.5-turbo",
    "messages": [{"role": "user", "content": "Hola"}]
  }'

Manejo de Errores

401 - Autenticación Inválida

{
  "error": {
    "message": "Invalid API key",
    "type": "authentication_error",
    "code": "invalid_api_key"
  }
}

Verifica que tu API key sea correcta y esté activa.

429 - Límite Excedido

{
  "error": {
    "message": "Token limit exceeded",
    "type": "rate_limit_error",
    "code": "token_limit_exceeded",
    "details": {
      "tokens_used": 3000000,
      "tokens_limit": 3000000,
      "plan": "pro"
    }
  }
}

Has agotado tu límite de tokens. Actualiza tu plan o espera al próximo mes.

500 - Error del Servidor

{
  "error": {
    "message": "Server error",
    "type": "server_error"
  }
}

Algo salió mal en nuestro servidor. Por favor, intenta de nuevo o contacta a soporte.

whatsapp
WhatsApp