Votre premier appel

Avant de connecter un éditeur, il est utile de confirmer que votre clé fonctionne avec une seule requête. Claudin.io parle le format OpenAI Chat Completions (et le format Anthropic Messages aussi).

Ces exemples lisent votre clé depuis $CLAUDINIO_API_KEY — définissez-la une fois en exportant votre clé. (Dans les extraits SDK, remplacez YOUR_API_KEY par la clé depuis votre tableau de bord, ou lisez-la depuis la même variable d'environnement.)

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

Vous devriez recevoir une réponse JSON normale de style OpenAI avec un tableau choices.

x-api-key fonctionne aussi

Claudin.io accepte la clé soit comme Authorization: Bearer YOUR_API_KEY ou comme un en-tête x-api-key: YOUR_API_KEY. Utilisez celui que votre client envoie.

Avec le SDK Python 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)

Avec le SDK Node 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

Définissez stream: true et lisez les événements envoyés par le serveur, exactement comme 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."}]
  }'

---

Vous avez reçu une réponse valide ? Super — maintenant connectez votre outil favori. Si quelque chose a échoué, consultez la référence API pour les erreurs courantes.