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





Cette référence présente **Claude Haiku 5.5** et ses paramètres Messages spécifiques. Utilisez `claude-haiku-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 Haiku 5.5                  |
| --------------------------------------- | --------------------------------- |
| Identifiant du modèle                   | `claude-haiku-5-5`                |
| Sortie synchrone maximale               | 128000 tokens, réflexion comprise |
| Modes de réflexion                      | Adaptative ou désactivée          |
| Effort par défaut                       | `medium`                          |
| Appels d’outils forcés (`any` / `tool`) | 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-haiku-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-haiku-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]

| Champ                   | Obligatoire | Contrat                                                                                                                                           |
| ----------------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| `model`                 | Oui         | `claude-haiku-5-5`.                                                                                                                               |
| `max_tokens`            | Oui         | Entier de 0 à 128000, réflexion comprise. Aucune valeur par défaut dans l’API.                                                                    |
| `messages`              | Oui         | De 1 à 100000 messages avec un rôle et une chaîne ou un tableau de blocs de contenu. Voir les règles de conversation ci-dessous.                  |
| `system`                | Non         | Chaîne ou tableau de blocs de texte. Ne peut pas être null.                                                                                       |
| `thinking`              | Non         | Adaptative par défaut, ou désactivée. Aucun budget manuel ni mode entre outils.                                                                   |
| `output_config`         | Non         | Objet avec `effort`, `format` et, en option, `task_budget` en bêta.                                                                               |
| `stop_sequences`        | Non         | Tableau de chaînes d’arrêt.                                                                                                                       |
| `stream`                | Non         | Booléen ; false par défaut.                                                                                                                       |
| `temperature`           | Non         | À omettre. Ignoré ici ; la valeur officielle de compatibilité est 1.                                                                              |
| `top_p`                 | Non         | À omettre. Ignoré ici ; la valeur officielle de compatibilité est 0.99.                                                                           |
| `top_k`                 | Non         | Non pris en charge et ignoré.                                                                                                                     |
| `tools`                 | Non         | Tableau d’outils client ou de déclarations officielles d’outils serveur.                                                                          |
| `tool_choice`           | Non         | `auto`, `none`, `any` ou `tool` nommé. Les appels forcés sont pris en charge.                                                                     |
| `metadata`              | Non         | Objet ; `user_id` facultatif est une chaîne de 512 caractères au maximum ou null.                                                                 |
| `cache_control`         | Non         | Null ou `{"type":"ephemeral","ttl":"5m"}` ; TTL accepte aussi `1h`. Le TTL par défaut est 5m.                                                     |
| `container`             | Non         | Null, chaîne d’identifiant de conteneur, ou objet avec un identifiant facultatif et jusqu’à 20 skills.                                            |
| `context_management`    | Non         | Null ou objet contenant des modifications officielles du contexte ; les en-têtes bêta s’appliquent.                                               |
| `mcp_servers`           | Non         | Tableau de 20 serveurs URL au maximum ; nécessite l’en-tête bêta MCP correspondant.                                                               |
| `service_tier`          | Non         | `auto` ou `standard_only`. Haiku ne dispose pas de capacité Priority Tier.                                                                        |
| `inference_geo`         | Non         | `global`, `us` ou null. L’omission utilise la valeur du compte ; examinez l’usage renvoyé avant de supposer une région.                           |
| `diagnostics`           | Non         | Null ou objet ; `previous_message_id` est null ou une chaîne de 256 caractères au maximum.                                                        |
| `compaction`            | Non         | Null ou `{"type":"summarize","instructions":"..."}`. Les instructions sont facultatives, peuvent être null et ne dépassent pas 16384 caractères.  |
| `fallbacks`             | Non         | Null ou `default` avec la bêta correspondante. Haiku n’a pas de modèle de repli automatique ; les listes explicites sont invalides.               |
| `fallback_credit_token` | Non         | Null, chaîne de jeton ou `{token,mode}`. L’API doit vérifier l’éligibilité et la validité ; ne supposez pas qu’un modèle soit une cible éligible. |
| `speed`                 | Non         | `standard` ou null. Le mode rapide n’est pas pris en charge.                                                                                      |

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

Le mode par défaut est la réflexion adaptative avec un effort **medium**, sans texte de réflexion. Effort accepte `low`, `medium`, `high`, `xhigh`, `max` ou null pour utiliser la valeur par défaut.

```json
{
  "thinking": {"type": "adaptive", "display": "summarized"},
  "output_config": {"effort": "medium"}
}
```

Pour désactiver la réflexion, utilisez `{"type":"disabled"}` avec un effort low, medium ou high. N’incluez ni `display` ni `block_binding` en mode désactivé. `enabled`, `budget_tokens`, `between_tools`, ainsi que la réflexion désactivée avec xhigh/max sont invalides.

En mode adaptatif, `display` accepte `omitted`, `summarized` ou null. La valeur bêta générique `updates` nécessite `thinking-display-updates-2026-08-18` ; Anthropic ne confirme pas actuellement la disponibilité de mises à jour de progression lisibles pour Haiku. Ne dépendez donc pas de cette sortie.

Le champ facultatif `thinking.block_binding` nécessite `thinking-binding-controls-2026-08-01`. Il vaut null ou contient un objet dont `prefix_mismatch_behavior` est `error`, `drop_block` ou null. Conservez les tours précédents de la conversation et les blocs de réflexion complets à l’identique lorsque vous renvoyez l’historique. Les signatures de réflexion sont liées au compte qui les a produites ou à un compte qui lui est associé.

`output_config.task_budget` vaut null ou `{ "type": "tokens", "total": 20000 }`, avec `remaining` facultatif, entier ou null. Il nécessite `task-budgets-2026-03-13` ; `total` doit être au moins égal à 20000. Aucune plage supplémentaire n’est imposée ici à `remaining`.

### Outils et sorties structurées [#outils-et-sorties-structurées]

Les outils client nécessitent un nom de 1 à 128 lettres, chiffres, traits de soulignement ou traits d’union, ainsi qu’un `input_schema` avec `type: "object"`. Utilisez `tool_choice: {"type":"any"}` ou `{"type":"tool","name":"lookup"}` pour forcer un outil déclaré. Avec la réflexion adaptative, une réponse à appel forcé commence par l’appel d’outil, sans bloc de réflexion.

`disable_parallel_tool_use` est un booléen facultatif pour les choix auto, any et tool ; ce n’est pas un champ de none. Renvoyez le résultat de l’outil avec le `tool_use_id` d’origine. Votre application exécute les outils client.

```json
{
  "tools": [{
    "name": "lookup",
    "description": "Look up a product by SKU.",
    "input_schema": {
      "type": "object",
      "properties": {"sku": {"type": "string"}},
      "required": ["sku"],
      "additionalProperties": false
    }
  }],
  "tool_choice": {"type": "tool", "name": "lookup"}
}
```

Les réponses structurées utilisent `output_config.format: {"type":"json_schema","schema":{...}}`. Respectez le sous-ensemble JSON Schema pris en charge par Anthropic, notamment `additionalProperties: false` sur les objets. Une structure valide ne garantit pas l’exactitude factuelle des valeurs. Les outils stricts et les sorties structurées ont des limites à l’échelle du schéma ; consultez la [référence officielle des sorties structurées](https://platform.claude.com/docs/en/build-with-claude/structured-outputs).

L’utilisation d’un ordinateur nécessite `computer_toolset_20260801` ; les anciennes versions des outils informatiques sont invalides. L’utilisation d’un navigateur possède son propre `browser_toolset_20260801`. Déclarer un outil ne prouve pas qu’une session complète d’outils serveur fonctionne. Consultez le guide officiel de l’outil et les exigences bêta avant de l’utiliser.

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

`claude-haiku-5-5`

| Tokens facturables | claude · Par défaut · ≤ 100 000 tokens d’entrée | claude · Par défaut · > 100 000 tokens d’entrée |
| --- | ---: | ---: |
| Entrée (hors cache) | 0,05 $US | 0,25 $US |
| Sortie | 0,25 $US | 1,25 $US |
| Lecture du cache | 0,005 $US | 0,025 $US |
| Écriture du cache · 5 minutes | 0,0625 $US | 0,3125 $US |
| Écriture du cache · 1 heure | 0,1 $US | 0,5 $US |

Le seuil porte sur : Tokens d’entrée hors cache. Le palier sélectionné s’applique à toute la requête, pas seulement aux tokens au-delà du seuil.

— 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-haiku-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-haiku-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-haiku-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 du modèle Haiku 5.5](https://platform.claude.com/docs/en/models/haiku-5-5/overview)
* [Guide de migration Haiku 5.5](https://platform.claude.com/docs/en/models/haiku-5-5/migration-guide)
* [Référence Messages](https://platform.claude.com/docs/en/api/messages/create)
* [Référence Messages bêta](https://platform.claude.com/docs/en/api/beta/messages/create)
* [Réflexion](https://platform.claude.com/docs/en/build-with-claude/thinking), [effort](https://platform.claude.com/docs/en/build-with-claude/effort), [budgets de tâche](https://platform.claude.com/docs/en/build-with-claude/task-budgets)
* [Compaction à la demande](https://platform.claude.com/docs/en/build-with-claude/compaction-on-demand), [modification du contexte](https://platform.claude.com/docs/en/build-with-claude/context-editing)
* [Mise en cache des prompts](https://platform.claude.com/docs/en/build-with-claude/prompt-caching), [vision](https://platform.claude.com/docs/en/build-with-claude/vision), [prise en charge des PDF](https://platform.claude.com/docs/en/build-with-claude/pdf-support)
