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





Cette référence présente **Claude Sonnet 5.5** et ses paramètres Messages spécifiques. Utilisez `claude-sonnet-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 Sonnet 5.5                 |
| --------------------------------------- | --------------------------------- |
| Identifiant du modèle                   | `claude-sonnet-5-5`               |
| Fenêtre de contexte                     | 1M tokens                         |
| Sortie synchrone maximale               | 128000 tokens, réflexion comprise |
| Modes de réflexion                      | Adaptative ou between\_tools      |
| Effort par défaut                       | `high`                            |
| 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-sonnet-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-sonnet-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]

| Paramètre                         | Type / obligatoire                     | Contraintes et valeurs par défaut officielles                                                                                                                                                                                                                                                                                        |
| --------------------------------- | -------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `model`                           | chaîne, obligatoire                    | `claude-sonnet-5-5`.                                                                                                                                                                                                                                                                                                                 |
| `max_tokens`                      | entier, obligatoire                    | 0–128000, tokens de réflexion compris. Officiellement, 0 remplit le cache du prompt sans produire de sortie ; voir la section sur la prise en charge actuelle de l’API.                                                                                                                                                              |
| `messages`                        | tableau d’objets, obligatoire          | Au moins un message de conversation, au maximum 100000. Chacun contient `role` et `content` ; le contenu est une chaîne ou un tableau de blocs. Les tours ordinaires utilisent `user`/`assistant`. Les messages `system` en cours de conversation suivent les règles officielles de placement.                                       |
| `system`                          | chaîne ou tableau de blocs de texte    | Instructions à la racine. Les blocs de texte peuvent inclure des points de mise en cache.                                                                                                                                                                                                                                            |
| `thinking`                        | objet                                  | Valeur par défaut : `{"type":"adaptive"}`. L’autre mode pris en charge est `{"type":"between_tools"}`. Les budgets manuels et `disabled` sont refusés.                                                                                                                                                                               |
| `thinking.display`                | énumération                            | Mode adaptatif uniquement : `omitted` (par défaut) ou `summarized`. L’absence de résumé ne signifie pas que la réflexion est désactivée.                                                                                                                                                                                             |
| `thinking.block_binding`          | objet, bêta                            | Mode adaptatif uniquement. Nécessite `thinking-binding-controls-2026-08-01` ; respectez le contrat officiel de conservation de la réflexion.                                                                                                                                                                                         |
| `output_config.effort`            | énumération ou null                    | `low`, `medium`, `high`, `xhigh`, `max` ; `high` par défaut. Null conserve la valeur par défaut.                                                                                                                                                                                                                                     |
| `output_config.format`            | objet ou null                          | Sortie JSON structurée : `{"type":"json_schema","schema":{...}}`. Utilisez le sous-ensemble JSON Schema pris en charge.                                                                                                                                                                                                              |
| `stream`                          | booléen                                | `false` par défaut ; `true` renvoie des événements SSE.                                                                                                                                                                                                                                                                              |
| `stop_sequences`                  | tableau de chaînes                     | Arrête officiellement la génération à une chaîne correspondante. Le contrôle de compatibilité en amont n’a pas fait respecter ce comportement.                                                                                                                                                                                       |
| `temperature`                     | nombre ou null                         | Seul 1 est accepté pour compatibilité ; omettez ce champ. Les autres valeurs non null sont refusées.                                                                                                                                                                                                                                 |
| `top_p`                           | nombre ou null                         | Seules les valeurs de 0.99 à 1 sont acceptées pour compatibilité ; omettez ce champ.                                                                                                                                                                                                                                                 |
| `top_k`                           | aucune valeur non null                 | L’échantillonnage n’est pas pris en charge ; omettez cette propriété.                                                                                                                                                                                                                                                                |
| `tools`                           | tableau d’objets                       | Les outils client ont `name`, `input_schema` et des paramètres facultatifs de description ou de validation stricte. Les outils serveur utilisent leurs définitions officielles versionnées.                                                                                                                                          |
| `tool_choice`                     | objet                                  | `auto` (par défaut) ou `none`. `any` et `tool` nommé forcé sont refusés. `auto` peut inclure `disable_parallel_tool_use`.                                                                                                                                                                                                            |
| `metadata.user_id`                | chaîne ou null                         | 512 caractères au maximum ; utilisez un identifiant opaque.                                                                                                                                                                                                                                                                          |
| `cache_control`                   | objet ou null                          | `type: "ephemeral"` ; `ttl: "5m"` (par défaut) ou `"1h"`. Sonnet 5.5 nécessite au moins 512 tokens pouvant être mis en cache. Les points de mise en cache au niveau des blocs sont aussi pris en charge par l’API officielle.                                                                                                        |
| `diagnostics`                     | objet ou null                          | `previous_message_id` : chaîne de 256 caractères au maximum ou null. Demande un diagnostic de divergence du cache.                                                                                                                                                                                                                   |
| `service_tier`                    | énumération                            | `auto` (par défaut) ou `standard_only`.                                                                                                                                                                                                                                                                                              |
| `speed`                           | énumération ou null                    | Omettez le champ ou utilisez `standard` / null. Sonnet 5.5 ne prend pas en charge `fast`.                                                                                                                                                                                                                                            |
| `inference_geo`                   | chaîne ou null                         | La valeur officielle par défaut provient des paramètres du compte. L’acceptation d’une requête ne prouve pas à elle seule la zone de traitement.                                                                                                                                                                                     |
| `fallbacks`                       | chaîne, tableau d’objets ou null, bêta | `"default"` ou jusqu’à trois entrées de repli. Chacune nécessite `model` ; les substitutions facultatives sont `max_tokens`, `thinking`, `output_config` et `speed`. Voir les règles de repli ci-dessous.                                                                                                                            |
| `fallback_credit_token`           | chaîne, objet ou null                  | Un jeton issu d’un refus précédent, ou `{"token":"...","mode":"strict"}`. La forme objet nécessite `fallback-credit-2026-07-01` ; le mode est `strict` (par défaut) ou `best_effort`. Ne peut pas accompagner une valeur `fallbacks` non null.                                                                                       |
| `container`                       | chaîne, objet ou null                  | Identifiant de conteneur, ou configuration avec `id` et `skills` facultatifs (20 au maximum). Les skills utilisent les champs officiels de type, d’identifiant et de version.                                                                                                                                                        |
| `context_management`              | objet ou null                          | Configuration officielle de modification du contexte, dont `edits` ; null omet le paramètre. La compatibilité des modifications propre au modèle reste applicable.                                                                                                                                                                   |
| `mcp_servers`                     | tableau d’objets                       | Définitions officielles de serveurs MCP, sous réserve de la version bêta requise et de l’authentification des serveurs. Un test avec un tableau vide ne vérifie pas l’exécution MCP distante.                                                                                                                                        |
| `compaction`                      | objet ou null, bêta                    | `{"type":"summarize"}`, avec `compact-2026-09-04` ; null omet la compaction. La compaction activée ne peut pas être combinée avec `context_management` non null, des séquences d’arrêt ou un format de sortie structuré. Le comportement de compaction signée n’a pas réussi le test actuel.                                         |
| `messages[].output_config.effort` | énumération, bêta                      | Effort par message sur un message système ; nécessite `mid-conversation-output-config-2026-07-01`. Les messages système contenant uniquement l’effort peuvent apparaître partout ; les groupes système avec contenu suivent les règles officielles de placement. Ce paramètre ne doit pas modifier l’effort en mode `between_tools`. |

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

`between_tools` accepte uniquement sa propriété `type` et un effort `low`, `medium` ou `high`. N’envoyez ni `display`, ni `budget_tokens`, ni `block_binding` avec ce mode. Exemple :

```json
{
  "model": "claude-sonnet-5-5",
  "max_tokens": 1024,
  "thinking": {"type": "between_tools"},
  "output_config": {"effort": "medium"},
  "messages": [{"role": "user", "content": "Explain this concept briefly."}]
}
```

Le préremplissage de la réponse de l’assistant n’est pas pris en charge. Pour poursuivre un `pause_turn`, renvoyez sans modification le contenu assistant retourné par l’outil serveur. La compaction résume l’historique existant et n’est pas un préremplissage de l’assistant. Conservez exactement les blocs de réflexion et leurs signatures ; ne les déplacez pas entre modèles et ne modifiez pas l’historique antérieur sans respecter les règles officielles de liaison.

Sur l’API Claude native, l’utilisation d’un ordinateur nécessite `computer_toolset_20260801` ; `computer_20251124` est refusé. Les configurations Advisor utilisant `claude-opus-4-8`, `claude-opus-4-7` ou `claude-sonnet-5` sont également refusées pour cet exécuteur.

## 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 Sonnet 5.5

`claude-sonnet-5-5`

| Tokens facturables | claude · Par défaut · Toutes les longueurs d’entrée |
| --- | ---: |
| Entrée (hors cache) | 1 $US |
| Sortie | 5 $US |
| Lecture du cache | 0,05 $US |
| Écriture du cache · 5 minutes | 1,25 $US |
| Écriture du cache · 1 heure | 2 $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-sonnet-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-sonnet-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-sonnet-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.

## Références du modèle [#références-du-modèle]

* [Présentation officielle de Sonnet 5.5](https://platform.claude.com/docs/en/models/sonnet-5-5/overview)
* [Changements et restrictions de Sonnet 5.5](https://platform.claude.com/docs/en/models/sonnet-5-5/whats-new-sonnet-5-5)
* [Référence des paramètres Messages](https://platform.claude.com/docs/en/api/messages/create)
* [Effort par message](https://platform.claude.com/docs/en/build-with-claude/effort)
* [Compaction à la demande](https://platform.claude.com/docs/en/build-with-claude/compaction-on-demand)
* [Refus et repli](https://platform.claude.com/docs/en/build-with-claude/refusals-and-fallback)
* [Crédit de repli](https://platform.claude.com/docs/en/build-with-claude/fallback-credit)
