La tua prima chiamata

Prima di collegare un editor, vale la pena confermare che la tua chiave funzioni con una singola richiesta. Claudin.io parla il formato OpenAI Chat Completions (e anche il formato Anthropic Messages).

Questi esempi leggono la tua chiave da $CLAUDINIO_API_KEY — impostala una volta esportando la tua chiave. (Negli snippet degli SDK, sostituisci YOUR_API_KEY con la chiave della tua dashboard, o leggila dalla stessa variabile d'ambiente.)

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."}
    ]
  }'

Dovresti ricevere una normale risposta JSON in stile OpenAI con un array choices.

x-api-key funziona anche

Claudin.io accetta la chiave sia come Authorization: Bearer YOUR_API_KEY oppure come header x-api-key: YOUR_API_KEY. Usa quello che il tuo client invia.

Con l'SDK Python di OpenAI

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 l'SDK Node di OpenAI

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

Imposta stream: true e leggi gli eventi inviati dal server, esattamente come l'API 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."}]
  }'

---

Ricevuto una risposta valida? Ottimo — ora collega il tuo strumento preferito. Se qualcosa è fallito, controlla il riferimento API per gli errori comuni.