Primeros pasos

Inicio rápido

Tu primera petición en menos de cinco minutos.

1. Crea una clave

Entra en Claves de API, ponle un nombre (por ejemplo, el de tu aplicación) y pulsa Crear clave. Cópiala en ese momento: por seguridad solo se muestra una vez.

Guárdala como variable de entorno en lugar de escribirla en el código:

Bash

export SABIUCO_API_KEY="hx_..."

2. Haz tu primera petición

Con curl:

Bash

curl https://sabiuco.app/api/v1/chat/completions \
  -H "Authorization: Bearer $SABIUCO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sabiuco-rapido",
    "messages": [
      {"role": "system", "content": "Responde en una sola frase."},
      {"role": "user", "content": "¿Qué es un agujero negro?"}
    ]
  }'

Con Python (librería oficial de OpenAI):

Python

# pip install openai
import os
from openai import OpenAI

cliente = OpenAI(base_url="https://sabiuco.app/api/v1", api_key=os.environ["SABIUCO_API_KEY"])

respuesta = cliente.chat.completions.create(
    model="sabiuco-rapido",
    messages=[
        {"role": "system", "content": "Responde en una sola frase."},
        {"role": "user", "content": "¿Qué es un agujero negro?"},
    ],
)
print(respuesta.choices[0].message.content)

Con JavaScript o TypeScript:

JavaScript

// npm install openai
import OpenAI from "openai"

const cliente = new OpenAI({ baseURL: "https://sabiuco.app/api/v1", apiKey: process.env.SABIUCO_API_KEY })

const respuesta = await cliente.chat.completions.create({
  model: "sabiuco-rapido",
  messages: [{ role: "user", content: "¿Qué es un agujero negro?" }],
})
console.log(respuesta.choices[0].message.content)

3. Lee la respuesta

JSON

{
  "id": "chatcmpl-hx9ae13dbed34c0d544b4879d1",
  "object": "chat.completion",
  "created": 1790264396,
  "model": "sabiuco-rapido",
  "choices": [
    {
      "index": 0,
      "message": { "role": "assistant", "content": "Una región del espacio donde la gravedad es tan intensa que nada, ni siquiera la luz, puede escapar." },
      "finish_reason": "stop"
    }
  ],
  "usage": { "prompt_tokens": 252, "completion_tokens": 24, "total_tokens": 276, "completion_tokens_details": { "reasoning_tokens": 0 } }
}

El texto está en choices[0].message.content y lo que ha costado, en usage.

Siguientes pasos

Recibe la respuesta palabra a palabra con Streaming.
Crea tu primer asistente propio y úsalo como modelo.
Revisa los Límites antes de llevarlo a producción.