# API Claude Opus 5.5 (https://wanapi.app/fr/docs/claude-opus-5-5)





Cette référence présente **Claude Opus 5.5** et ses paramètres Messages spécifiques. Utilisez `claude-opus-5-5` avec `POST https://api.wanapi.app/v1/messages`. [Comparer les modèles Claude](/fr/docs/claude-api).

## Paramètres du modèle [#paramètres-du-modèle]

| Paramètre                               | Claude Opus 5.5                   |
| --------------------------------------- | --------------------------------- |
| Identifiant du modèle                   | `claude-opus-5-5`                 |
| Fenêtre de contexte                     | 1M tokens                         |
| Sortie synchrone maximale               | 128000 tokens, réflexion comprise |
| Modes de réflexion                      | Adaptative, toujours active       |
| Effort par défaut                       | `medium`                          |
| Appels d’outils forcés (`any` / `tool`) | Non pris en charge                |

## Connexion et envoi d’une requête [#connexion-et-envoi-dune-requête]

Créez une clé dans les [paramètres des clés API](/fr/settings/apikeys). Une seule clé API donne accès à tous les modèles et groupes. Conservez-la dans l’environnement de votre serveur sous `WAN_API_KEY`. Envoyez `anthropic-version: 2023-06-01` ; ajoutez `anthropic-beta` uniquement pour les fonctionnalités qui le nécessitent.

```bash
curl https://api.wanapi.app/v1/messages \
  -H "x-api-key: $WAN_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-5-5",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Explain the purpose of a database index in three sentences."}]
  }'
```

```python
import os
import anthropic

client = anthropic.Anthropic(
    api_key=os.environ["WAN_API_KEY"],
    base_url="https://api.wanapi.app",
)
message = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Explain the purpose of a database index in three sentences."}],
)
print("".join(block.text for block in message.content if block.type == "text"))
```

## Prise en charge actuelle de l’API [#prise-en-charge-actuelle-de-lapi]

Le tableau ci-dessous décrit le contrat natif de ce modèle. Wan API transmet actuellement les requêtes par une couche de compatibilité. **Utilisez une valeur `max_tokens` strictement positive** : la passerelle remplace actuellement `0` par un budget de génération ; cette valeur ne permet donc pas ici de précharger uniquement le cache.

La passerelle actuelle ne transmet pas `diagnostics`, `compaction`, `fallbacks`, `fallback_credit_token` ni `thread`. Elle filtre également `speed`, `service_tier` et `inference_geo` dans la configuration actuelle du canal. Ces champs sont documentés ci-dessous pour expliquer le contrat du modèle, mais ils ne sont pas encore disponibles via cette connexion. Une réponse réussie ne signifie pas qu’un champ ignoré a été appliqué. Les fonctionnalités bêta qui nécessitent ces champs ont la même limite.

## Paramètres [#paramètres]

| Nom                                                                                                       | Type                | Obligatoire | Valeur par défaut      | Notes                                                                                                                                                                                                                                                   |
| --------------------------------------------------------------------------------------------------------- | ------------------- | ----------- | ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `model`                                                                                                   | chaîne              | Oui         | —                      | `claude-opus-5-5`.                                                                                                                                                                                                                                      |
| `max_tokens`                                                                                              | entier              | Oui         | —                      | 0–128000. Inclut les tokens consacrés à la réflexion. `0` ne fait que précharger le cache du prompt.                                                                                                                                                    |
| `messages`                                                                                                | object\[]           | Oui         | —                      | Alternance de tours `user` et `assistant` ; `content` est une chaîne ou un tableau de blocs de contenu. Le dernier tour doit être `user`. Exception : pour poursuivre une réponse `pause_turn`, renvoyez son contenu comme dernier message `assistant`. |
| `system`                                                                                                  | chaîne ou object\[] | Non         | —                      | Prompt système.                                                                                                                                                                                                                                         |
| `thinking`                                                                                                | objet               | Non         | `{"type": "adaptive"}` | La réflexion est adaptative et toujours active. `display` : `omitted` (par défaut) ou `summarized`.                                                                                                                                                     |
| `output_config.effort`                                                                                    | énumération         | Non         | `medium`               | `low`, `medium`, `high`, `xhigh`, `max`. Oriente l’ampleur de la réflexion du modèle.                                                                                                                                                                   |
| `output_config.format`                                                                                    | objet               | Non         | —                      | Un schéma JSON pour une sortie structurée.                                                                                                                                                                                                              |
| `stop_sequences`                                                                                          | string\[]           | Non         | —                      | Arrêt dès qu’une de ces chaînes est générée.                                                                                                                                                                                                            |
| `stream`                                                                                                  | booléen             | Non         | `false`                | Envoie la réponse en flux sous forme d’événements SSE.                                                                                                                                                                                                  |
| `temperature`                                                                                             | nombre              | Non         | —                      | Seul `1` (valeur par défaut) est accepté pour rétrocompatibilité ; toute autre valeur renvoie une erreur 400. Omettez ce champ.                                                                                                                         |
| `top_p`                                                                                                   | nombre              | Non         | —                      | Seules les valeurs de `0.99` à `1` sont acceptées pour rétrocompatibilité ; toute autre valeur renvoie une erreur 400. Omettez ce champ.                                                                                                                |
| `top_k`                                                                                                   | entier              | Non         | —                      | Non accepté : toute valeur renvoie une erreur 400. Omettez ce champ.                                                                                                                                                                                    |
| `tools`                                                                                                   | object\[]           | Non         | —                      | Définitions des outils.                                                                                                                                                                                                                                 |
| `tool_choice`                                                                                             | objet               | Non         | —                      | `auto` ou `none` ; ce modèle ne permet pas de forcer un outil (`any` ou `tool`).                                                                                                                                                                        |
| `metadata.user_id`                                                                                        | chaîne              | Non         | —                      | Identifiant opaque de l’utilisateur final, jusqu’à 512 caractères.                                                                                                                                                                                      |
| `cache_control`                                                                                           | objet               | Non         | —                      | Point de mise en cache du prompt à la racine.                                                                                                                                                                                                           |
| `container`, `context_management`, `mcp_servers`, `diagnostics`, `service_tier`, `inference_geo`, `speed` | —                   | Non         | —                      | Champs natifs facultatifs ; consultez la section sur la prise en charge actuelle de l’API pour les champs filtrés par cette connexion.                                                                                                                  |

## Réflexion et outils [#réflexion-et-outils]

Claude Opus 5.5 utilise toujours la réflexion adaptative : le modèle décide de l’ampleur de sa réflexion, orientée par `output_config.effort`. Un effort plus élevé signifie généralement davantage de tokens de sortie, une attente plus longue et un coût supérieur. Avec `thinking.display` défini sur `summarized`, la réponse inclut des blocs `thinking` que vous pouvez afficher ; avec `omitted`, ils sont omis. Les tokens de réflexion sont facturés comme des tokens de sortie.

## Entrées multimédias [#entrées-multimédias]

Pour les images et les PDF, utilisez des URL HTTP(S) accessibles publiquement dans les blocs `content` d’un message utilisateur. Hébergez vos fichiers vous-même ; cette intégration ne fournit ni API Files ni téléversement. Exemple d’entrée image :

```json
{"role":"user","content":[
  {"type":"image","source":{"type":"url","url":"https://example.com/chart.png"}},
  {"type":"text","text":"What does this chart show?"}
]}
```

Utilisez un bloc `document` pour un PDF. Conservez les identifiants d’appels d’outils, les blocs de réflexion complets et les signatures à l’identique lorsque vous poursuivez une conversation. Votre application exécute les outils client et renvoie leurs résultats ; déclarer un outil ne l’exécute pas.

## Tarifs [#tarifs]

USD par million de tokens

Les tarifs actuels incluent le coefficient de chaque groupe. Ils sont mis en cache pendant 2 minutes au maximum.

Une seule clé API donne accès à tous les modèles et groupes. La mention « Par défaut » désigne le premier groupe éligible dans l’ordre du routage automatique ; la requête est facturée aux tarifs du groupe effectivement sélectionné.

### Claude Opus 5.5

`claude-opus-5-5`

| Tokens facturables | claude · Par défaut · Toutes les longueurs d’entrée |
| --- | ---: |
| Entrée (hors cache) | 2 $US |
| Sortie | 10 $US |
| Lecture du cache | 0,1 $US |
| Écriture du cache · 5 minutes | 2,5 $US |
| Écriture du cache · 1 heure | 4 $US |

— signifie qu’aucun tarif vérifié n’est disponible ; cela ne signifie pas que le service est gratuit.

Les tarifs du cache s’appliquent uniquement lorsque la réponse indique l’usage correspondant. Ne comptez pas à nouveau les tokens en cache comme des tokens d’entrée hors cache.

Multipliez chaque nombre de tokens facturables par son tarif et divisez le total par 1 000 000. Les tokens de réflexion sont inclus dans les tokens de sortie, sans être facturés une seconde fois. Les lectures du cache, les écritures de 5 minutes et celles d’1 heure ont des tarifs distincts. Pour une tarification selon la longueur, choisissez le palier applicable avant de calculer le coût de la requête.

## Réponse et flux [#réponse-et-flux]

Un message terminé comprend `id`, `type`, `role`, `model`, `content`, `stop_reason` et `usage`. Lisez les blocs de texte dans `content` ; le premier bloc peut être un bloc de réflexion ou un appel d’outil. Cet exemple est fourni à titre indicatif :

```json
{
  "id": "msg_example",
  "type": "message",
  "role": "assistant",
  "model": "claude-opus-5-5",
  "content": [{"type": "text", "text": "A database index helps locate rows without scanning the whole table."}],
  "stop_reason": "end_turn",
  "usage": {"input_tokens": 24, "output_tokens": 18}
}
```

Définissez `stream: true` pour SSE et utilisez `curl -N`. Traitez `message_start`, `content_block_start`, `content_block_delta`, `content_block_stop`, `message_delta` et `message_stop`, ainsi que `ping` et les erreurs de flux. Lisez l’usage final au lieu de considérer chaque fragment comme une réponse complète.

## Formats compatibles OpenAI [#formats-compatibles-openai]

Le même identifiant de modèle fonctionne avec `POST /v1/chat/completions` et `POST /v1/responses`. Utilisez `Authorization: Bearer YOUR_API_KEY` et l’URL de base du SDK OpenAI `https://api.wanapi.app/v1`. Chat Completions utilise `messages` ; Responses utilise `input`. Leurs champs sont convertis vers Messages : utilisez donc `/v1/messages` pour les paramètres natifs documentés ci-dessus.

```bash
curl https://api.wanapi.app/v1/chat/completions \
  -H "Authorization: Bearer $WAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-opus-5-5","max_tokens":256,"messages":[{"role":"user","content":"Reply with OK."}]}'
```

## Journaux d’utilisation et erreurs [#journaux-dutilisation-et-erreurs]

Les [journaux LLM](/fr/usage) affichent les appels terminés des 7 derniers jours, avec le modèle, les tokens d’entrée et de sortie et le coût. Actualisez après un appel et filtrez par `claude-opus-5-5`. Utilisez les [journaux des tâches](/fr/tasks) pour les images et les vidéos.

En cas d’échec, examinez le statut HTTP et l’objet `error`. Vérifiez la clé, le [solde](/fr/docs/balance), l’identifiant du modèle et les combinaisons de paramètres prises en charge. Un refus ou un arrêt à la limite de sortie est différent d’une erreur HTTP. Si une requête ou un flux est interrompu, consultez les journaux avant de réessayer : une nouvelle requête peut entraîner de nouveaux frais.
