Documentation

Documentation d'intégration

666 AI prend en charge trois protocoles courants. L'outil que vous utilisez déjà fonctionnera presque certainement : changez une adresse, collez une API Key, ne touchez à rien d'autre.

Dans les exemples ci-dessous, remplacez YOUR-ENDPOINT par votre propre adresse — elle figure sur la page d'accueil de la console, ou laissez le guide de démarrage générer la configuration pour vous.

Connexion en trois étapes

De l'inscription à la première requête, comptez moins de trois minutes.

1. Récupérez votre API Key

Créez-en une dans la page « API Key » de la console. Nous conseillons une clé par projet, avec un plafond de dépense.

2. Renseignez l'adresse

BASE URL
https://YOUR-ENDPOINT/v1

3. Vérifiez

curl
curl https://YOUR-ENDPOINT/v1/chat/completions \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"deepseek-v4-flash",
       "messages":[{"role":"user","content":"hi"}]}'

# A JSON response means it works

Protocoles pris en charge

Une seule API Key, un seul solde, trois protocoles au choix. Inutile de prévoir une clé différente par outil.

Disponible
OpenAI
Le plus répandu. Pris en charge par défaut par la quasi-totalité des outils et SDK.
/v1/chat/completions
Disponible
Anthropic
Le format natif de Claude Code et Cline, sans couche d'adaptation.
/v1/messages
En préparation
Gemini
Le format natif de Google, adapté aux projets déjà écrits pour Gemini.
/v1beta/models
Vous hésitez ? Prenez le format OpenAI : meilleure compatibilité, et changer de modèle n'impose aucune modification de code.

Format OpenAI

La bibliothèque officielle openai fonctionne telle quelle : seule base_url change.

Python
from openai import OpenAI

client = OpenAI(
    api_key="YOUR_KEY",
    base_url="https://YOUR-ENDPOINT/v1"
)

resp = client.chat.completions.create(
    model="deepseek-v4-flash",
    messages=[{"role": "user", "content": "你好"}]
)
print(resp.choices[0].message.content)
Node.js
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "YOUR_KEY",
  baseURL: "https://YOUR-ENDPOINT/v1"
});

const resp = await client.chat.completions.create({
  model: "deepseek-v4-flash",
  messages: [{ role: "user", content: "你好" }]
});
console.log(resp.choices[0].message.content);

Format Anthropic

Si vous utilisez Claude Code ou le SDK officiel d'Anthropic, prenez ce format, aucune conversion nécessaire. Attention : cette adresse ne comporte pas /v1.

Claude Code
# Add to ~/.zshrc or ~/.bashrc
export ANTHROPIC_BASE_URL="https://YOUR-ENDPOINT"
export ANTHROPIC_AUTH_TOKEN="YOUR_KEY"

# Reopen the terminal, then just run
claude
Python SDK
from anthropic import Anthropic

client = Anthropic(
    api_key="YOUR_KEY",
    base_url="https://YOUR-ENDPOINT"
)

msg = client.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "你好"}]
)
print(msg.content[0].text)

Format Gemini

En préparation. En attendant, les modèles Gemini restent accessibles via le format OpenAI ci-dessus, avec les mêmes fonctionnalités.

curl
# Call Gemini like this
curl https://YOUR-ENDPOINT/v1/chat/completions \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gemini-3.5-flash","messages":[{"role":"user","content":"hi"}]}'

Éditeurs et agents

Cursor

  1. Settings → Models → OpenAI API Key
  2. Activez Override Base URL
  3. Saisissez l'adresse et l'API Key, puis cliquez sur Verify

Claude Code

  1. Définissez ANTHROPIC_BASE_URL
  2. Définissez ANTHROPIC_AUTH_TOKEN
  3. Rouvrez le terminal et lancez claude

Cline / Roo Code

  1. Choisissez OpenAI Compatible comme Provider
  2. Renseignez Base URL et API Key
  3. Indiquez dans Model ID l'identifiant du catalogue

Continue

  1. Modifiez config.json
  2. Mettez openai comme provider
  3. Ajoutez le champ apiBase

Applications et extensions

ChatBox / NextChat

  1. Choisissez OpenAI comme service de modèle
  2. Indiquez l'adresse de la passerelle comme domaine d'API
  3. Saisissez le nom du modèle à la main

Immersive Translate

  1. Ajoutez une interface IA personnalisée
  2. Adresse : /v1/chat/completions
  3. Préférez un modèle rapide et peu coûteux

Open WebUI

  1. Réglages → Connexions externes
  2. Ajoutez une connexion OpenAI API
  3. Renseignez l'adresse et l'API Key, puis enregistrez

Frameworks de développement

Dify

  1. Choisissez OpenAI-API-compatible comme fournisseur
  2. Renseignez l'API endpoint et l'API Key
  3. Le reste de la configuration ne change pas

n8n

  1. Créez des identifiants OpenAI
  2. Indiquez l'adresse de la passerelle dans Base URL
  3. Sélectionnez ces identifiants dans le nœud

LangChain

  1. Utilisez ChatOpenAI
  2. Passez base_url
  3. Le reste de la chaîne ne change pas

Flux / Appels d'outils / Vision

Ces trois fonctions s'utilisent exactement comme sur les interfaces officielles, sans changer de paramètres. La prise en charge dépend du modèle : elle est indiquée dans le catalogue.

Réponse en flux
stream = client.chat.completions.create(
    model="deepseek-v4-flash",
    messages=[{"role":"user","content":"写一首诗"}],
    stream=True
)
for chunk in stream:
    print(chunk.choices[0].delta.content or "", end="")

Mise en cache des prompts

Si chaque requête reprend le même long préfixe — prompt système, code du projet, documents — la partie mise en cache est facturée avec une forte remise. Le gain est le plus net pour le code et les agents.

Placez d'abord ce qui ne change pas, puis ce qui varie. C'est l'ordre qui détermine le taux de succès du cache.

Codes d'erreur

CodeSignificationQue faire
401API Key invalide ou désactivéeVérifiez que l'API Key a été copiée entièrement et qu'elle existe toujours
402Solde insuffisantRechargez depuis la console
404Modèle introuvableVérifiez l'orthographe de l'identifiant dans le catalogue
429Trop de requêtesRéduisez la concurrence ou réessayez plus tard
500Erreur en amontLa passerelle bascule automatiquement sur une route de secours. Contactez-nous si l'erreur persiste

Quotas et limites

Chaque API Key peut avoir son propre plafond de dépense et sa liste de modèles autorisés. Prévoyez une clé par projet : en cas de fuite, la perte est plafonnée et il suffit de supprimer la clé et d'en créer une autre.

Les requêtes en échec ne sont pas facturées. Les délais dépassés et les erreurs en amont n'apparaissent pas sur votre facture.
←