Sommaire

Documentation

Gardez le SDK OpenAI ou Anthropic que vous utilisez déjà, et envoyez votre première requête en quelques minutes.

Démarrage rapide

Créez une clé, définissez deux variables d'environnement, puis envoyez une requête.

Deux changements, rien d'autre

Pointez votre SDK OpenAI vers http://127.0.0.1:3001/v1, ou votre SDK Anthropic vers http://127.0.0.1:3001, et utilisez votre clé yourbrand. Les requêtes, les réponses et les flux gardent les formats que votre code attend déjà. Un champ que nous ne prenons pas en charge reçoit une erreur 400 au lieu d'être ignoré. Le fine-tuning, le batch, les fichiers et les assistants ne sont pas offerts.

  1. 1
    Créer une clé

    Inscrivez-vous avec un nom d'utilisateur, achetez des bons de 5 $ et utilisez-les pour obtenir du crédit, puis créez une clé depuis le tableau de bord.

  2. 2
    Définir l'URL de base
    export YOURBRAND_BASE_URL=http://127.0.0.1:3001/v1
    export YOURBRAND_KEY=sk_...
  3. 3
    Envoyer une requête
    curl $YOURBRAND_BASE_URL/chat/completions \
      -H "Authorization: Bearer $YOURBRAND_KEY" \
      -H "Content-Type: application/json" \
      -d '{"model":"qwen3.8-27b-abliterated","messages":[{"role":"user","content":"hello"}]}'

Configurer un agent

Tout agent qui accepte une URL de base OpenAI fonctionne. Voici les réglages des plus courants. OpenCode lit ses réglages dans ~/.config/opencode/opencode.json.

export OPENAI_API_BASE=http://127.0.0.1:3001/v1
export OPENAI_API_KEY=$YOURBRAND_KEY
aider --model openai/qwen3.8-27b-abliterated

Streaming

Passez stream: true et la réponse arrive en server-sent events pendant que le modèle l'écrit. Les SDK s'occupent de l'analyse ; voici ce qu'ils font en coulisses, pour quand vous lisez le flux vous-même.

curl -N $YOURBRAND_BASE_URL/chat/completions \
  -H "Authorization: Bearer $YOURBRAND_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"qwen3.8-27b-abliterated","stream":true,"messages":[{"role":"user","content":"hello"}]}'
  • Chaque événement est une ligne data: contenant un chat.completion.chunk.
  • Le dernier fragment contient usage : vous pouvez compter les tokens d'un flux sans seconde requête.
  • Le flux se termine par data: [DONE]. Fermer la connexion plus tôt arrête la génération.

Le format de chaque événement, flux Anthropic compris, est dans la référence API.

Gérer les erreurs

Trois erreurs valent une nouvelle tentative : 429 quand vous dépassez la limite de parallélisme de votre forfait, avec un en-tête Retry-After en secondes ; 500 quand quelque chose échoue de notre côté ; et 503 quand un modèle est brièvement hors service. Tout le reste demande de corriger la requête, et réessayer n'y changera rien.

// Le SDK OpenAI réessaie déjà les 429 et 5xx avec backoff et respecte Retry-After.
const client = new OpenAI({
  apiKey: process.env.YOURBRAND_KEY,
  baseURL: process.env.YOURBRAND_BASE_URL,
  maxRetries: 5,
});

Tous les codes de statut et les deux formats d'erreur sont listés sous Erreurs ; les limites des forfaits sous Limites de débit.

↑↓ naviguerEnter ouvrirEsc fermer