Tutoriel

API Claude Opus 5.5 : guide de démarrage rapide avec curl et Python prêts à l'emploi

Sep 29, 2026

Claude Opus 5.5 est le tout dernier modèle d'Anthropic pour le codage agentique et le raisonnement à contexte long ; hiapi l'a intégré le jour même de sa mise en ligne sur la plateforme. Contrairement aux modèles d'image, de vidéo et d'audio de hiapi — qui passent tous par le mode asynchrone POST /v1/tasks → interrogation périodique — Claude Opus 5.5 est un modèle de conversation purement textuel : il suffit donc d'envoyer une requête synchrone à /v1/chat/completions pour l'appeler. Ce guide propose un appel curl directement exécutable, la version Python du même appel, ainsi que les détails de production à connaître avant la mise en ligne (intensité de raisonnement, sortie en streaming, gestion des erreurs).

Préparation

Un compte hiapi et une clé API. Vous pouvez la créer sur la page API Keys — tous les modèles hiapi, y compris Claude Opus 5.5, partagent la même clé.
Aucun SDK à installer. Claude Opus 5.5 utilise le format Chat Completions compatible OpenAI de hiapi, donc n'importe quel client HTTP (curl, requests, fetch) fonctionne immédiatement.

Requête minimale fonctionnelle (curl)

curl -X POST "https://api.hiapi.ai/v1/chat/completions" \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-5-5",
    "messages": [
      { "role": "user", "content": "Give me three tips for reviewing a Python pull request." }
    ],
    "stream": false
  }'

L'identifiant du modèle se transmet directement — aucun suffixe de routage ni préfixe d'identification de fournisseur n'est nécessaire. Un appel réussi renvoie l'objet standard de complétion de conversation :

{
  "id": "msg_...",
  "object": "chat.completion",
  "model": "claude-opus-5-5",
  "choices": [
    {
      "index": 0,
      "message": { "role": "assistant", "content": "1. ..." },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 13,
    "completion_tokens": 42,
    "total_tokens": 55,
    "usage_semantic": "openai",
    "usage_source": "anthropic"
  }
}

Lisez la réponse dans choices[0].message.content — ici, aucun output[0].url à interroger, aucun identifiant de tâche à suivre.

Le même flux en Python

import requests

response = requests.post(
    "https://api.hiapi.ai/v1/chat/completions",
    headers={
        "Authorization": "Bearer sk-YOUR_API_KEY",
        "Content-Type": "application/json",
    },
    json={
        "model": "claude-opus-5-5",
        "messages": [
            {"role": "user", "content": "Give me three tips for reviewing a Python pull request."}
        ],
        "stream": False,
    },
)
response.raise_for_status()
data = response.json()
print(data["choices"][0]["message"]["content"])

Comme ce point de terminaison utilise le format de transport des OpenAI Chat Completions, la même structure de corps de requête peut être réutilisée telle quelle avec n'importe quel client HTTP, dans n'importe quel langage — hormis l'URL de base et la clé Bearer, rien de spécifique à hiapi n'est à apprendre.

Intensité de raisonnement, réflexion et sortie en streaming

La réflexion étendue de Claude Opus 5.5 est toujours activée — vous ne pouvez ni la désactiver, ni spécifier manuellement un budget de tokens. Ce que vous pouvez contrôler, c'est la quantité de raisonnement effectuée par le modèle, via output_config.effort :

{
  "model": "claude-opus-5-5",
  "messages": [{ "role": "user", "content": "..." }],
  "output_config": { "effort": "medium" }
}

effort accepte low, medium (valeur par défaut lorsque le champ est omis), high, xhigh ou max — d'une réponse rapide et peu coûteuse à une réponse approfondie et réfléchie. Le message de la réponse contient un tableau reasoning_details qui conserve la trace de la réflexion interne du modèle ; pour un appel simple et unique, vous pouvez l'ignorer sans risque et lire uniquement message.content.

Pour les réponses longues, définissez "stream": true afin d'obtenir une sortie incrémentale plutôt que d'attendre la réponse complète :

curl -N https://api.hiapi.ai/v1/chat/completions \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-opus-5-5","messages":[{"role":"user","content":"..."}],"stream":true}'

Chaque bloc de données est une ligne data: {...}, au format chat.completion.chunk, et le texte incrémental se trouve dans choices[0].delta.content. Continuez à lire les blocs jusqu'à en recevoir un dont le finish_reason est non vide (généralement "stop") — c'est la fin de la réponse.

Claude Opus 5.5 prend également en charge l'appel d'outils/fonctions, dispose d'une fenêtre de contexte d'un million de tokens et d'une sortie pouvant atteindre 128 000 tokens ; il convient donc aux tâches sur de grandes bases de code ou de longs documents, et pas seulement aux questions-réponses courtes.

Points d'attention en production

Les erreurs d'authentification renvoient 401, et non 400. En cas de clé absente ou invalide, la réponse est :
```
{ "error": { "code": "permission_denied", "message": "This API key is invalid...", "type": "hiapi_error", "request_id": "..." } }
```
Vérifiez spécifiquement le HTTP 401 et fournissez le request_id si vous devez contacter le support — pour les autres causes de cette erreur, consultez le guide complet de dépannage des clés API invalides.
Aucune option de rappel/Webhook ici. Ce mode concerne les modèles hiapi basés sur des tâches asynchrones (image, vidéo, audio) ; Chat Completions ne prend en charge que le modèle requête/réponse, donc stream: true est votre seule alternative à un appel bloquant unique.
Cet appel est naturellement idempotent — aucun identifiant de tâche ne risque d'être recréé accidentellement, donc réessayer après un délai d'expiration est sûr, tant que vous acceptez de relancer le même prompt.
Attention aux limites de débit, en particulier sous des charges de travail à forte concurrence ; pour les stratégies de backoff, consultez comment gérer les erreurs de limite de débit 429.
La tarification des tokens (les tokens d'entrée, de sortie et de cache sont facturés séparément) est mise à jour en continu sur la page du modèle Claude Opus 5.5 et sur la page de tarification — ne codez pas en dur les chiffres dans votre logique de facturation, lisez-les depuis ces pages.

Pour aller plus loin

Page du modèle Claude Opus 5.5 — tableau complet des spécifications et tarification en temps réel
Guide de l'API Claude Sonnet 4.6 — une option Claude plus légère et plus rapide avec le même format Chat Completions
Construire un proxy compatible OpenAI en Python — utile si vous souhaitez proxifier plusieurs modèles de conversation derrière une API interne unique
Gérer vos clés API

Questions fréquentes

L'API Claude Opus 5.5 prend-elle en charge la sortie en streaming ? Oui — définissez "stream": true et lisez les blocs data: {...} comme décrit ci-dessus.

Faut-il une clé API pour appeler Claude Opus 5.5 en production ? Oui. Chaque requête doit porter Authorization: Bearer sk-<your key> ; l'API de production ne propose aucun accès sans clé ni anonyme.

Puis-je désactiver la réflexion de Claude Opus 5.5 pour économiser des tokens ? Non. La réflexion de ce modèle est toujours activée ; le seul paramètre que vous pouvez contrôler est le niveau output_config.effort (de low à max), qui arbitre entre vitesse/coût et profondeur.

Claude Opus 5.5 est-il appelé via /v1/tasks comme les modèles d'image de hiapi ? Non. Seuls les modèles d'image, de vidéo et d'audio de hiapi utilisent le mode tâche asynchrone avec interrogation périodique. Claude Opus 5.5 est un modèle textuel, il utilise /v1/chat/completions et renvoie la réponse dans la même réponse HTTP.

Quelle est la taille de la fenêtre de contexte et de la sortie maximale ? Contexte d'un million de tokens, sortie jusqu'à 128 000 tokens — de quoi traiter des prompts portant sur un dépôt entier ou de longs documents.

Claude Opus 5.5 prend-il en charge l'appel d'outils/fonctions ? Oui, avec également la sortie en streaming et le format de message compatible OpenAI.