Tu primera llamada

Antes de conectar un editor, vale la pena confirmar que tu clave funciona con una sola solicitud. Claudin.io habla el formato OpenAI Chat Completions (y también el formato Anthropic Messages).

Estos ejemplos leen tu clave de $CLAUDINIO_API_KEY — establécela una vez exportando tu clave. (En los fragmentos del SDK, reemplaza YOUR_API_KEY con la clave de tu panel de control, o léela de la misma variable de entorno).

Con cURL

curl https://api.claudin.io/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $CLAUDINIO_API_KEY" \
  -d '{
    "model": "claudinio",
    "messages": [
      {"role": "user", "content": "Say hello in one short sentence."}
    ]
  }'

Deberías recibir una respuesta JSON normal al estilo de OpenAI con un arreglo choices.

x-api-key también funciona

Claudin.io acepta la clave ya sea como Authorization: Bearer YOUR_API_KEY o como un encabezado x-api-key: YOUR_API_KEY. Usa el que envíe tu cliente.

Con el SDK de OpenAI para Python

from openai import OpenAI

client = OpenAI(
    base_url="https://api.claudin.io/v1",
    api_key="YOUR_API_KEY",
)

resp = client.chat.completions.create(
    model="claudinio",
    messages=[{"role": "user", "content": "Say hello in one short sentence."}],
)

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

Con el SDK de OpenAI para Node

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.claudin.io/v1",
  apiKey: "YOUR_API_KEY",
});

const resp = await client.chat.completions.create({
  model: "claudinio",
  messages: [{ role: "user", content: "Say hello in one short sentence." }],
});

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

Streaming

Configura stream: true y lee eventos enviados por el servidor, exactamente como la API de OpenAI:

curl https://api.claudin.io/v1/chat/completions \
  -H "Authorization: Bearer $CLAUDINIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claudinio",
    "stream": true,
    "messages": [{"role": "user", "content": "Count to five."}]
  }'

---

¿Obtuviste una respuesta válida? Genial — ahora conecta tu herramienta favorita. Si algo falló, consulta la referencia de la API para errores comunes.