API Inteligencia Artificial

Base URL: https://sushell.com

API de IA de Sushell. Eliges el model. En el ecosistema, Orbit es el modelo multiagente propio de Sushell (Orbit AI); también forman parte del ecosistema Sushell Chat y FELvus.

Planes mensuales

Los tokens del plan no descuentan billetera. Al agotar el cupo, el excedente se cobra de la billetera según tarifas Sushell en GTQ (publicadas en el panel). Mínimo Q0.05 por request en overage.

Costos de referencia (USD / 1M tokens)

Incluyen GPT-4.1 nano/mini/full y Gemini Flash / Pro. GET /api/v1/ai/models muestra tarifas al cliente en GTQ.

Listar modelos y tarifas

GET https://sushell.com/api/v1/ai/models
Authorization: Bearer sh_tu_clave

Chat

POST https://sushell.com/api/v1/ai/chat
Authorization: Bearer sh_tu_clave
Content-Type: application/json

Body (prompt corto)

{
  "model": "gpt-4o-mini",
  "system": "Responde en español, breve.",
  "prompt": "Explica qué es un NIT en Guatemala"
}

Body (historial)

{
  "model": "gemini-2.0-flash",
  "messages": [
    { "role": "user", "content": "Hola" },
    { "role": "assistant", "content": "¡Hola! ¿En qué ayudo?" },
    { "role": "user", "content": "Dame 3 ideas de asunto para un correo OTP" }
  ]
}

Respuesta

{
  "ok": true,
  "data": { "content": "…", "model": "gpt-4o-mini" },
  "usage": {
    "prompt_tokens": 40,
    "completion_tokens": 120,
    "tokens": 160,
    "cost_gtq": 0.0256,
    "wallet_balance": 49.97,
    "currency": "GTQ"
  }
}

Ejemplo cURL

curl -X POST "https://sushell.com/api/v1/ai/chat" \
  -H "Authorization: Bearer sh_..." \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-4o-mini","prompt":"Hola"}'

Ejemplo JavaScript

const res = await fetch("https://sushell.com/api/v1/ai/chat", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.SUSHELL_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "gemini-2.0-flash",
    prompt: "Resume este texto…",
  }),
});
const json = await res.json();

Errores

Recarga saldo en Panel ? Billetera.