Configuration de l'API LLM pour Cursor, Claude Code, Codex

API_KEY="YOUR_CKEY_API_KEY" curl https://api.xah.io/v1/chat/completions \ -H "Authorization: Bearer $API_KEY" \ -H 'Content-Type: application/json' \ -d '{ "model": "MODEL", "messages": [{"role": "user", "content": "Hello"}], "stream": false }'

API_KEY="YOUR_CKEY_API_KEY" curl https://api.xah.io/v1/completions \ -H "Authorization: Bearer $API_KEY" \ -H 'Content-Type: application/json' \ -d '{ "model": "MODEL", "prompt": "Hello", "max_tokens": 256 }'

API_KEY="YOUR_CKEY_API_KEY" curl https://api.xah.io/v1/messages \ -H "Authorization: Bearer $API_KEY" \ -H 'Content-Type: application/json' \ -H 'anthropic-version: 2023-06-01' \ -d '{ "model": "MODEL", "max_tokens": 1024, "messages": [{"role": "user", "content": "Hello"}] }'

API_KEY="YOUR_CKEY_API_KEY" curl https://api.xah.io/v1/images/generations \ -H "Authorization: Bearer $API_KEY" \ -H 'Content-Type: application/json' \ -d '{ "model": "MODEL", "prompt": "A red fox in snow", "n": 1, "size": "1024x1024" }'

API_KEY="YOUR_CKEY_API_KEY" curl https://api.xah.io/v1/images/generations \ -H "Authorization: Bearer $API_KEY" \ -H 'Content-Type: application/json' \ -d '{ "model": "MODEL", "prompt": "Turn the reference into a watercolor illustration", "image_url": "https://example.com/reference.png", "n": 1, "size": "1024x1024" }'

API_KEY="YOUR_CKEY_API_KEY" curl https://api.xah.io/v1/audio/speech \ -H "Authorization: Bearer $API_KEY" \ -H 'Content-Type: application/json' \ -d '{ "model": "MODEL", "input": "Hello from CKEY", "voice": "alloy", "response_format": "mp3" }'

API_KEY="YOUR_CKEY_API_KEY" curl https://api.xah.io/v1/videos/generations \ -H "Authorization: Bearer $API_KEY" \ -H 'Content-Type: application/json' \ -d '{ "model": "MODEL", "prompt": "A gentle camera move across a mountain", "seconds": 8 } # Poll: GET https://api.xah.io/v1/videos/JOB_ID'

API_KEY="YOUR_CKEY_API_KEY" curl https://api.xah.io/v2/video_generation \ -H "Authorization: Bearer $API_KEY" \ -H 'Content-Type: application/json' \ -d '{ "model": "MODEL", "content": [{"type": "text", "text": "A gentle camera move across a mountain"}], "duration": 6, "ratio": "16:9" } # Poll: GET https://api.xah.io/v2/query/video_generation/JOB_ID # Cancel: DELETE https://api.xah.io/v2/video_generation/JOB_ID'

API_KEY="YOUR_CKEY_API_KEY" curl https://api.xah.io/v1/embeddings \ -H "Authorization: Bearer $API_KEY" \ -H 'Content-Type: application/json' \ -d '{ "model": "MODEL", "input": ["first text", "second text"] }'

API_KEY="YOUR_CKEY_API_KEY" curl https://api.xah.io/v1/rerank \ -H "Authorization: Bearer $API_KEY" \ -H 'Content-Type: application/json' \ -d '{ "model": "MODEL", "query": "latest AI news", "documents": ["doc A", "doc B"], "top_n": 2 }'

API_KEY="YOUR_CKEY_API_KEY" curl https://api.xah.io/v1/moderations \ -H "Authorization: Bearer $API_KEY" \ -H 'Content-Type: application/json' \ -d '{ "model": "MODEL", "input": "Text to classify" }'

API_KEY="YOUR_CKEY_API_KEY" curl https://api.xah.io/v1/search \ -H "Authorization: Bearer $API_KEY" \ -H 'Content-Type: application/json' \ -d '{ "model": "MODEL", "query": "latest AI news", "max_results": 5 }'

API_KEY="YOUR_CKEY_API_KEY" curl https://api.xah.io/v1beta/models/MODEL:generateContent \ -H "Authorization: Bearer $API_KEY" \ -H 'Content-Type: application/json' \ -d '{ "contents": [{"role": "user", "parts": [{"text": "Hello"}]}] }'

API_KEY="YOUR_CKEY_API_KEY" curl https://api.xah.io/api/chat \ -H "Authorization: Bearer $API_KEY" \ -H 'Content-Type: application/json' \ -d '{ "model": "MODEL", "messages": [{"role": "user", "content": "Hello"}], "stream": false }'

API_KEY="YOUR_CKEY_API_KEY" curl https://api.xah.io/api/generate \ -H "Authorization: Bearer $API_KEY" \ -H 'Content-Type: application/json' \ -d '{ "model": "MODEL", "prompt": "Hello", "stream": false }'

OpenAI-compatible chat/completions /v1

Cursor

Cursor doit utiliser le mode compatible OpenAI avec une clé API personnalisée et une URL de base personnalisée.

Informations requises

Provider: OpenAI-compatible
API Key: sk-YOUR_API_KEY
Base URL: https://api.xah.io/v1
Modèle: gpt-5.4
Route: chat/completions
Exigence du forfait: Nécessite un forfait Cursor prenant en charge les endpoints API personnalisés.

Étapes recommandées

1Ouvrez les paramètres de Cursor puis allez dans AI / Models / API Keys.
2Activez la clé OpenAI personnalisée ou le provider personnalisé si votre version de Cursor utilise un autre libellé.
3Collez la clé API et l'URL de base indiquées ci-dessous.
4Choisissez le modèle suggéré ou un autre modèle actuellement actif.

Bloc prêt à copier

Provider: OpenAI-compatible
API Key: sk-YOUR_API_KEY
Base URL: https://api.xah.io/v1
Model: gpt-5.4
Route: chat/completions

Modèles recommandés

gpt-5.4
claude-opus-4.6
claude-opus-4.7
claude-opus-4.8
claude-sonnet-4.6
deepseek-4.1-flash-ckey

Notes

Cursor utilise le flux compatible OpenAI, donc l'URL de base doit inclure `/v1`.
Si un modèle ne fonctionne pas dans Cursor, essayez un autre modèle compatible OpenAI de la liste active.
Après l'enregistrement, envoyez un court prompt pour confirmer que la route `chat/completions` fonctionne.

Anthropic-compatible messages root URL

Claude Code

Claude Code doit être configuré via les variables d'environnement Anthropic, mais l'URL de base doit rester sur le domaine racine.

Installer Claude Code

macOS / Linux / Windows (Node 18+) : npm install -g @anthropic-ai/claude-code
Après l'installation, exécutez `claude` pour confirmer. La configuration est enregistrée dans `~/.claude/settings.json`.
Linux / macOS : `~/.claude/settings.json`
Windows : `%USERPROFILE%\.claude\settings.json`

Informations requises

API Key: sk-YOUR_API_KEY
Base URL: https://api.xah.io
Modèle: claude-opus-5
Route: messages
Max tokens: 1024

Notes

`ANTHROPIC_BASE_URL` ne doit pas inclure `/v1`.
Privilégiez un modèle prenant en charge la route `messages`.
Si Claude Code vous demande de vous connecter d'abord, terminez cette connexion une fois puis relancez-le avec les variables d'environnement ci-dessous.
Les requêtes passant par la route `messages` doivent inclure le champ `max_tokens`.

Session terminal temporaire

export ANTHROPIC_BASE_URL="https://api.xah.io"
export ANTHROPIC_AUTH_TOKEN="sk-YOUR_API_KEY"
claude --bare

Session PowerShell temporaire

$env:ANTHROPIC_BASE_URL = "https://api.xah.io"
$env:ANTHROPIC_AUTH_TOKEN = "sk-YOUR_API_KEY"
claude --bare

Paramètres persistants

{
    "env": {
        "ANTHROPIC_BASE_URL": "https://api.xah.io",
        "ANTHROPIC_AUTH_TOKEN": "sk-YOUR_API_KEY",
        "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5",
        "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4.6",
        "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4.5"
    }
}

Modèles recommandés

claude-opus-5
claude-opus-4.6
claude-opus-4.7
claude-opus-4.8
claude-opus-5-5
claude-sonnet-4.6

OpenAI-compatible VS Code /v1

VS Code Extensions

La plupart des extensions VS Code fonctionnent le mieux en mode compatible OpenAI avec une URL de base personnalisée.

Informations requises

Provider: OpenAI-compatible
API Key: sk-YOUR_API_KEY
Base URL: https://api.xah.io/v1
Modèle: claude-opus-5
Route: messages or chat/completions
Max tokens: 1024

Continue

name: CKEY API
version: 1.0.0
schema: v1
models:
  - name: claude-opus-5
    provider: anthropic
    model: claude-opus-5
    apiBase: https://api.xah.io/v1
    apiKey: sk-YOUR_API_KEY
    roles:
      - chat
      - edit
      - apply

Cline

Utilisez le provider compatible OpenAI, l'URL de base `/v1` et votre clé API depuis la Console.

Roo Code

Utilisez le provider compatible OpenAI, l'URL de base `/v1` et votre clé API depuis la Console.

Kilo Code

Utilisez le provider compatible OpenAI, l'URL de base `/v1` et votre clé API depuis la Console.

Modèles recommandés

gpt-5.4
claude-opus-4.6
claude-opus-4.7
claude-opus-4.8
claude-sonnet-4.6
deepseek-4.1-flash-ckey

Notes

Utilisez le provider compatible OpenAI, l'URL de base `/v1` et votre clé API depuis la Console.
Cursor utilise le flux compatible OpenAI, donc l'URL de base doit inclure `/v1`.
Après l'enregistrement, envoyez un court prompt pour confirmer que la route `chat/completions` fonctionne.
Les requêtes passant par la route `messages` doivent inclure le champ `max_tokens`.

OpenAI-compatible ~/.codex /v1

Codex CLI

L'extension Codex pour VS Code prend en charge l'API compatible OpenAI avec une URL de base personnalisée et une clé API.

Installer Codex CLI

macOS / Linux / Windows (Node 18+) : npm install -g @openai/codex
Après l'installation, exécutez `codex` pour vérifier. Codex lit l'authentification depuis `~/.codex/auth.json` et la config depuis `~/.codex/config.toml`.
Config : `~/.codex/config.toml` (Windows : `%USERPROFILE%\.codex\config.toml`)
Auth : `~/.codex/auth.json` (Windows : `%USERPROFILE%\.codex\auth.json`)

Informations requises

Provider: OpenAI-compatible
API Key: sk-YOUR_API_KEY
Base URL: https://api.xah.io/v1
Modèle: gpt-5.4
Route: chat/completions

Étapes recommandées

1Installez l'extension Codex depuis le VS Code Marketplace.
2Ouvrez les paramètres de VS Code et cherchez la section de configuration Codex.
3Saisissez la clé API et l'URL de base dans la section de configuration Codex.
4Sélectionnez un modèle dans la liste des modèles actifs.

Contenu de `~/.codex/config.toml` :

model = "gpt-5.4"
model_reasoning_effort = "xhigh"
personality = "pragmatic"

openai_base_url = "https://api.xah.io/v1"

Contenu de `~/.codex/auth.json` :

{
    "auth_mode": "apikey",
    "OPENAI_API_KEY": "sk-YOUR_API_KEY"
}

Modèles recommandés

gpt-5.4
claude-opus-4.6
claude-opus-4.7
claude-opus-4.8
claude-sonnet-4.6
deepseek-4.1-flash-ckey

Notes

Codex utilise des endpoints compatibles OpenAI, donc l'URL de base doit inclure /v1.
Après la configuration, rechargez VS Code pour appliquer les changements.
Testez en ouvrant un fichier de code et en essayant de discuter avec Codex.

OpenAI-compatible ~/.factory /v1

Factory Droid

Factory Droid est un assistant CLI qui permet de configurer un modèle personnalisé via un fichier `settings.json`.

Installer Droid CLI

macOS / Linux : curl -fsSL https://app.factory.ai/cli | sh
Windows (PowerShell): iwr -useb https://app.factory.ai/cli/install.ps1 | iex
Après l'installation, exécutez `droid` pour vérifier.
Linux / macOS : `~/.factory/settings.json`
Windows : `%USERPROFILE%\.factory\settings.json`

Informations requises

Provider: openai
API Key: sk-YOUR_API_KEY
Base URL: https://api.xah.io/v1
Modèle: gpt-5.4
Route: chat/completions

Notes

Chaque entrée dans `customModels` nécessite un `id` unique et un `index` croissant (0, 1, 2...).
Définissez `provider` sur `openai` pour que Droid utilise le flux compatible OpenAI.
Vous pouvez ajouter plus de modèles en dupliquant l'objet dans le tableau et en modifiant `model` + `id`.

Contenu de `~/.factory/settings.json` :

{
    "customModels": [
        {
            "model": "gpt-5.4",
            "id": "custom:ckey-0",
            "index": 0,
            "baseUrl": "https://api.xah.io/v1",
            "apiKey": "sk-YOUR_API_KEY",
            "displayName": "gpt-5.4",
            "maxOutputTokens": 131072,
            "noImageSupport": false,
            "provider": "openai"
        }
    ]
}

Modèles recommandés

gpt-5.4
claude-opus-4.6
claude-opus-4.7
claude-opus-4.8
claude-sonnet-4.6
deepseek-4.1-flash-ckey

Anthropic-compatible JSONC /v1

OpenCode

OpenCode peut pointer son provider Anthropic vers votre endpoint et utiliser la même clé API.

Installer OpenCode

Installer via npm : npm install -g opencode-ai
Après l'installation, exécutez `opencode` pour vérifier. La config se trouve dans `~/.config/opencode/opencode.json` (ou `.jsonc`).

Chemin de config

Windows : `%USERPROFILE%\.config\opencode\opencode.json`
Linux / macOS : `~/.config/opencode/opencode.json`

Informations requises

API Key: sk-YOUR_API_KEY
Base URL: https://api.xah.io/v1
Modèle: claude-opus-5
Route: messages
Max tokens: 1024

Bloc prêt à copier

{
    "$schema": "https://opencode.ai/config.json",
    "provider": {
        "ckey": {
            "npm": "@ai-sdk/openai-compatible",
            "options": {
                "baseURL": "https://api.xah.io/v1",
                "apiKey": "sk-YOUR_API_KEY"
            },
            "models": {
                "claude-opus-5": {
                    "name": "claude-opus-5"
                },
                "claude-opus-4.6": {
                    "name": "claude-opus-4.6"
                },
                "claude-opus-4.7": {
                    "name": "claude-opus-4.7"
                },
                "claude-opus-4.8": {
                    "name": "claude-opus-4.8"
                },
                "claude-opus-5-5": {
                    "name": "claude-opus-5-5"
                },
                "claude-sonnet-4.6": {
                    "name": "claude-sonnet-4.6"
                }
            }
        }
    },
    "model": "ckey/claude-opus-5",
    "agent": {
        "explorer": {
            "description": "Fast explorer subagent for codebase exploration",
            "mode": "subagent",
            "model": "ckey/claude-opus-5"
        }
    }
}

Modèles recommandés

claude-opus-5
claude-opus-4.6
claude-opus-4.7
claude-opus-4.8
claude-opus-5-5
claude-sonnet-4.6

Notes

OpenCode doit pointer vers un endpoint avec `/v1`.
Privilégiez un modèle Claude actif si votre workflow s'appuie sur des outils de type Anthropic.
Si vous changez de modèle ailleurs dans la config, conservez les mêmes valeurs d'URL de base et de clé API.
Les requêtes passant par la route `messages` doivent inclure le champ `max_tokens`.

OpenAI-compatible openclaw.json /v1

OpenClaw

OpenClaw peut utiliser un provider compatible OpenAI via le fichier `openclaw.json` avec l'alias de provider `ckey`.

Chemin de config

Racine du projet : `./openclaw.json`
Windows : `%USERPROFILE%\.openclaw\openclaw.json`
Linux / macOS : `~/.openclaw/openclaw.json`

Informations requises

Provider: ckey / OpenAI-compatible
API Key: sk-YOUR_API_KEY
Base URL: https://api.xah.io/v1
Modèle: ckey/gpt-5.4
Route: chat/completions

Bloc prêt à copier

{
    "agents": {
        "defaults": {
            "model": {
                "primary": "ckey/gpt-5.4"
            }
        }
    },
    "models": {
        "providers": {
            "ckey": {
                "baseUrl": "https://api.xah.io/v1",
                "apiKey": "sk-YOUR_API_KEY",
                "api": "openai-completions",
                "models": [
                    {
                        "id": "gpt-5.4",
                        "name": "gpt-5.4"
                    },
                    {
                        "id": "claude-opus-4.6",
                        "name": "claude-opus-4.6"
                    },
                    {
                        "id": "claude-opus-4.7",
                        "name": "claude-opus-4.7"
                    },
                    {
                        "id": "claude-opus-4.8",
                        "name": "claude-opus-4.8"
                    },
                    {
                        "id": "claude-sonnet-4.6",
                        "name": "claude-sonnet-4.6"
                    },
                    {
                        "id": "deepseek-4.1-flash-ckey",
                        "name": "deepseek-4.1-flash-ckey"
                    }
                ]
            }
        }
    }
}

Modèles recommandés

ckey/gpt-5.4
ckey/claude-opus-4.6
ckey/claude-opus-4.7
ckey/claude-opus-4.8
ckey/claude-sonnet-4.6
ckey/deepseek-4.1-flash-ckey

Notes

OpenClaw doit utiliser une `baseUrl` avec `/v1`.
Conservez `api` défini sur `openai-completions` pour suivre le flux compatible OpenAI.
Vous pouvez ajouter ou retirer des modèles de la liste, mais gardez l'alias `ckey/` et la clé API conformes à l'exemple.

Configurez chaque client de la bonne façon

Avant de configurer

Règles d'URL de base

Endpoints and commands

Text / hội thoại

Images

Audio

Video (task / async)

Embeddings / ranking / safety / search

Native provider routes

Cursor

Informations requises

Étapes recommandées

Bloc prêt à copier

Modèles recommandés

Notes

Claude Code

Installer Claude Code

Informations requises

Notes

Session terminal temporaire

Session PowerShell temporaire

Paramètres persistants

Modèles recommandés

VS Code Extensions

Informations requises

Continue

Cline

Roo Code

Kilo Code

Modèles recommandés

Notes

Codex CLI

Installer Codex CLI

Informations requises

Étapes recommandées

Contenu de `~/.codex/config.toml` :

Contenu de `~/.codex/auth.json` :

Modèles recommandés

Notes

Factory Droid

Installer Droid CLI

Informations requises

Notes

Contenu de `~/.factory/settings.json` :

Modèles recommandés

OpenCode

Installer OpenCode

Chemin de config

Informations requises

Bloc prêt à copier

Modèles recommandés

Notes

OpenClaw

Chemin de config

Informations requises

Bloc prêt à copier

Modèles recommandés

Notes