# Aperçu de l'API

> URL de base, authentification et exemples rapides en Python, Node.js et curl pour l'API LLMoxy.

LLMoxy fournit une interface API Anthropic Messages entièrement compatible. Il suffit de changer l'URL de base pour utiliser le SDK officiel sans modification.

## URL de base

```txt
https://llmoxy.com/v1
```

> **ASTUCE**
> Des outils comme Claude Code utilisent l'adresse **sans** `/v1`, c'est-à-dire `https://llmoxy.com`. Les appels SDK incluent `/v1`.

## Authentification

### Méthode 1 : x-api-key (recommandée)

```http
x-api-key: YOUR_API_KEY
```

### Méthode 2 : Authorization

```http
Authorization: Bearer YOUR_API_KEY
```

## Démarrage rapide

### Python

```python
from anthropic import Anthropic

client = Anthropic(
api_key="YOUR_API_KEY",
base_url="https://llmoxy.com/v1"
)

message = client.messages.create(
model="claude-opus-5-5",
max_tokens=1024,
messages=[
{"role": "user", "content": "Bonjour !"}
]
)

print(message.content[0].text)
```

### Node.js

```js
import Anthropic from '@anthropic-ai/sdk';

const client = new Anthropic({
apiKey: 'YOUR_API_KEY',
baseURL: 'https://llmoxy.com/v1'
});

const message = await client.messages.create({
model: 'claude-opus-5-5',
max_tokens: 1024,
messages: [
{ role: 'user', content: 'Bonjour !' }
]
});

console.log(message.content[0].text);
```

### Compatible OpenAI (Chat Completions)

#### curl

```bash
curl https://llmoxy.com/v1/chat/completions \
  -H "Authorization: Bearer <LLMOXY_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4.7",
    "messages": [
      { "role": "user", "content": "Say hello in one short sentence." }
    ]
  }'
```

#### TypeScript

```ts
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.LLMOXY_API_KEY,
  baseURL: "https://llmoxy.com/v1",
});

const response = await client.chat.completions.create({
  model: "grok-4.7",
  messages: [{ role: "user", content: "Write a haiku about routers." }],
});

console.log(response.choices[0]?.message?.content);
```

#### Python

```py
from openai import OpenAI

client = OpenAI(
    api_key="<LLMOXY_API_KEY>",
    base_url="https://llmoxy.com/v1",
)

response = client.chat.completions.create(
    model="grok-4.7",
    messages=[{"role": "user", "content": "Write a haiku about routers."}],
)

print(response.choices[0].message.content)
```

## Sortie en flux

Définissez `stream: true` dans les requêtes Chat ou Responses, et LLMoxy renvoie un flux SSE compatible OpenAI.

```bash
curl https://llmoxy.com/v1/chat/completions \
  -H "Authorization: Bearer <LLMOXY_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4.7",
    "stream": true,
    "messages": [
      { "role": "user", "content": "Count from one to five." }
    ]
  }'
```

## Modèles pris en charge

### Série Claude (groupes disponibles : Claude)

| Modèle | Description |
| --- | --- |
| claude-fable-5-2 | Performance maximale |
| claude-opus-5-5 | Choix équilibré |

### Série Gemini (groupe disponible : Gemini)

| Modèle | Description |
| --- | --- |
| gemini-4-argon | Performance maximale |
| gemini-3.8-flash | Réponse rapide |

> **Liste des modèles récents**
> Consultez la [place de marché officielle](https://llmoxy.com/) pour les modèles actuellement disponibles.

## Facturation

Facturation selon l'utilisation réelle de tokens (y compris l'écriture et la lecture du cache). Les prix varient selon les modèles. Voir [Groupes et tarification](https://fr.llmoxy.com/docs/get-started/recharge-and-pricing) pour plus de détails.

## Prochaines étapes

- [Format Anthropic](https://fr.llmoxy.com/docs/api-reference/anthropic-format) — paramètres de requête, format de réponse, exemples de code
- [Chat Completions](https://fr.llmoxy.com/docs/api-reference/chat-completions) — format de requête compatible OpenAI
- [Routage, facturation et erreurs](https://fr.llmoxy.com/docs/api-reference/routing-billing-errors) — comprendre les frais et les codes d'erreur

Ceci est la version markdown de https://fr.llmoxy.com/docs/api-reference/api-overview.
