La API de IA de OIMA

🚀 Inicio rápido

1. Creá tu cuenta en oima.pro y activá un plan Pro o superior.
2. Generá tu API key en la Consola Developer (empieza con sk-oima-).
3. Hacé tu primera llamada:

curl https://api.oima.pro/v1/chat/completions \
  -H "Authorization: Bearer sk-oima-tu-key" \
  -H "Content-Type: application/json" \
  -d '{"model":"deepseek-chat","messages":[{"role":"user","content":"Hola"}]}'

🔑 Autenticación

Todas las llamadas llevan tu key en el header Authorization:

Authorization: Bearer sk-oima-tu-key

• La key completa se muestra una sola vez al crearla. Guardala en un lugar seguro.
• Nunca publiques tu key en código cliente (webs, apps móviles) — usala solo desde tu servidor.
• ¿Key comprometida? Revocala al instante desde la consola y creá una nueva.

🧠 Modelos disponibles

La lista viva siempre está en GET https://api.oima.pro/v1/models.

⚡ Streaming

Agregá "stream": true y recibí la respuesta token a token por SSE, igual que con OpenAI:

stream = client.chat.completions.create(
    model="deepseek-chat",
    messages=[{"role": "user", "content": "Contame un chiste"}],
    stream=True
)
for chunk in stream:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="")

📊 Límites por plan

Al superar un límite la API devuelve 429 rate_limit_exceeded. ¿Necesitás más volumen? Mejorá tu plan o escribinos para un plan a medida.

💰 Facturación

• Cada llamada consume tokens de tu saldo (el mismo saldo de tu workspace OIMA), medidos por el uso real reportado del modelo.
• Tu saldo y tu gráfica de consumo diario están siempre visibles en la consola.
• Recargá saldo o cambiá de plan en oima.pro/pricing — los precios vigentes están siempre ahí.
• Sin saldo, las llamadas devuelven 402. Nada se corta a mitad de una respuesta ya iniciada.

⚠️ Errores

Formato estándar OpenAI: { "error": { "message", "type", "code" } }

❓ Preguntas frecuentes