API Claude Sonnet 5.5 : contexte 1 M, jeu de rôle, fiction

anthropic/claude-sonnet-5.5/chat

Chat Claude Sonnet 5.5 d’Anthropic, sorti le 28 septembre 2026, via un endpoint compatible OpenAI. Il accepte jusqu’à 1 000 000 de tokens et en renvoie jusqu’à 128 000, avec un effort de raisonnement de none à max et jusqu’à 128 définitions d’outils.

Entrée $2Sortie $10par 1 million de tokensEntrée en cache $0.20Écriture en cache $2.50

Exécuter le modèle Voir l’API

Envoyer une requête

Les exemples suivent les paramètres publics du point de terminaison choisi. Remplacez la clé API et les médias d’exemple, puis envoyez la requête depuis votre serveur.

SDK et intégrations

POSThttps://api.spicyapi.ai/v1/chat/completions

Authentification API

Conservez la clé API dans la variable serveur SPICY_API_KEY. Utilisez l’authentification Bearer et Content-Type: application/json pour les requêtes JSON.

Authorization: Bearer $SPICY_API_KEY

curl --fail-with-body -sN https://api.spicyapi.ai/v1/chat/completions \
  -H "Authorization: Bearer $SPICY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "anthropic/claude-sonnet-5.5/chat",
  "messages": [
    {
      "role": "user",
      "content": "Summarise the following release notes into three bullet points."
    }
  ],
  "stream": true
}' \
  | jq --unbuffered -Rrj 'select(startswith("data: ")) | .[6:] | select(. != "[DONE]") | fromjson | if .error then "\n[error] \(.error.message)\n" else (.choices[0].delta.content? // empty) end'

Généré à partir du schéma d’entrée de ce modèle, le même que l’API utilise pour valider chaque requête.

Conservez le même Idempotency-Key pour chaque requête logique. Après une coupure réseau, ne renvoyez pas automatiquement la requête avec une nouvelle clé. Gardez request_id pour retrouver la requête acceptée. Le flux de chat précédent n’est pas rejoué.

Paramètres d’entrée

Placez les paramètres du modèle au même niveau que model dans le corps JSON. Ce point de terminaison ne les encapsule pas dans un objet input.

messagesarray<object>Obligatoire

Tours de conversation ordonnés, le plus ancien d’abord. Les rôles sont system, developer, user, assistant et tool ; les messages system et developer deviennent les instructions du modèle. Le contenu est une chaîne ou un tableau de parties text et image_url. Un résultat d’outil se place dans un message de rôle tool portant son tool_call_id.

Valeur par défaut: Non définie
Contraintes: minItems:1

messages[].rolestringObligatoire dans l’objet

Role of the message author.

Valeur par défaut: Non définie
Valeurs autorisées: "system""developer""user""assistant""tool"

messages[].contentstring | array | nullFacultatif

Message content, either plain text or a list of text parts.

Valeur par défaut: Non définie

{
  "type": [
    "string",
    "array",
    "null"
  ],
  "items": {
    "oneOf": [
      {
        "type": "object",
        "required": [
          "type",
          "text"
        ],
        "properties": {
          "text": {
            "type": "string"
          },
          "type": {
            "const": "text"
          }
        }
      },
      {
        "type": "object",
        "required": [
          "type",
          "image_url"
        ],
        "properties": {
          "type": {
            "const": "image_url"
          },
          "image_url": {
            "type": "object",
            "required": [
              "url"
            ],
            "properties": {
              "url": {
                "type": "string"
              }
            }
          }
        }
      }
    ]
  },
  "description": "Message content, either plain text or a list of text parts."
}

messages[].tool_callsarray<object>Facultatif

Tool calls the assistant requested in this message.

Valeur par défaut: Non définie

messages[].tool_call_idstringFacultatif

Identifier of the tool call this message answers. Required on tool messages.

Valeur par défaut: Non définie

messages[].reasoning_contentstringFacultatif

Reasoning text from a previous assistant reply, preserved when continuing a tool conversation.

Valeur par défaut: Non définie

{
  "type": "array",
  "x-ui": {
    "order": 100,
    "widget": "chat-messages",
    "primary": true
  },
  "items": {
    "type": "object",
    "allOf": [
      {
        "if": {
          "required": [
            "reasoning_content"
          ]
        },
        "then": {
          "properties": {
            "role": {
              "const": "assistant"
            }
          }
        }
      }
    ],
    "required": [
      "role"
    ],
    "properties": {
      "role": {
        "enum": [
          "system",
          "developer",
          "user",
          "assistant",
          "tool"
        ],
        "type": "string",
        "description": "Role of the message author."
      },
      "content": {
        "type": [
          "string",
          "array",
          "null"
        ],
        "items": {
          "oneOf": [
            {
              "type": "object",
              "required": [
                "type",
                "text"
              ],
              "properties": {
                "text": {
                  "type": "string"
                },
                "type": {
                  "const": "text"
                }
              }
            },
            {
              "type": "object",
              "required": [
                "type",
                "image_url"
              ],
              "properties": {
                "type": {
                  "const": "image_url"
                },
                "image_url": {
                  "type": "object",
                  "required": [
                    "url"
                  ],
                  "properties": {
                    "url": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          ]
        },
        "description": "Message content, either plain text or a list of text parts."
      },
      "tool_calls": {
        "type": "array",
        "items": {
          "type": "object"
        },
        "description": "Tool calls the assistant requested in this message."
      },
      "tool_call_id": {
        "type": "string",
        "description": "Identifier of the tool call this message answers. Required on tool messages."
      },
      "reasoning_content": {
        "type": "string",
        "description": "Reasoning text from a previous assistant reply, preserved when continuing a tool conversation."
      }
    },
    "additionalProperties": false
  },
  "minItems": 1,
  "description": "Ordered conversation turns. Text content only on this endpoint."
}

tool_choicestringFacultatif

auto ou none. Sonnet 5.5 n’accepte pas d’outil imposé : pour obtenir un appel précis, nommez l’outil dans le prompt et laissez ce champ sur auto.

Valeur par défaut: Non définie
Valeurs autorisées: "auto""none"

parallel_tool_callsbooleanFacultatif

true par défaut. Avec false, le modèle appelle au plus un outil par tour, ce qui convient aux enchaînements où chaque appel dépend du résultat du précédent. N’a d’effet que si des outils (tools) sont fournis ; avec tool_choice none, aucun outil n’est appelé dans les deux cas.

Valeur par défaut: true

toolsarray<object>Facultatif

Jusqu’à 128 définitions de fonctions par requête, au format de fonction OpenAI : un nom, une description et des paramètres au format JSON Schema pour chacune.

Valeur par défaut: Non définie
Contraintes: maxItems:128

stopstring | arrayFacultatif

Jusqu’à 4 séquences, sous forme de chaîne ou de tableau. La réponse s’arrête dès que le modèle en écrit une, et le texte correspondant lui-même est omis. Pas de valeur par défaut. Le tarif ne change pas ; une réponse écourtée n’est facturée que pour les tokens produits.

Valeur par défaut: Non définie
Contraintes: minLength:1
minItems:1
maxItems:4

reasoning_effortstringFacultatif

none, low, medium, high, xhigh ou max ; medium par défaut. none demande au modèle de ne pas réfléchir avant la réponse (le mode between_tools d’Anthropic), même s’il peut encore réfléchir brièvement dans les longues conversations ; chaque cran au-dessus autorise plus de réflexion. La valeur par défaut d’Anthropic pour ce modèle est high ; medium suit sa recommandation de commencer à medium ou low pour le chat et les usages sensibles à la latence. Sans effet sur le tarif par token.

Valeur par défaut: "medium"
Valeurs autorisées: "none""low""medium""high""xhigh""max"

max_tokensintegerFacultatif

Plafonne la réponse à 128 000 ; 4 096 par défaut. La réflexion compte dans ce même budget : un plafond bas peut être consommé par le raisonnement avant que la réponse visible soit terminée, laissez donc une vraie marge, davantage encore à high, xhigh et max. Même avec reasoning_effort none, il peut encore réfléchir brièvement dans les longues conversations : prévoyez là aussi au moins 4 000 tokens.

Valeur par défaut: 4096
Contraintes: minimum:1
maximum:128000

{
  "type": "object",
  "required": [
    "messages"
  ],
  "x-pricing": {
    "billingMode": "formula",
    "variantFields": []
  },
  "properties": {
    "stop": {
      "type": [
        "string",
        "array"
      ],
      "x-ui": {
        "order": 65,
        "widget": "text",
        "affects_price": false
      },
      "items": {
        "type": "string",
        "minLength": 1
      },
      "maxItems": 4,
      "minItems": 1,
      "minLength": 1,
      "description": "Sequences that end the reply as soon as the model writes one; the matched text is not returned."
    },
    "tools": {
      "type": "array",
      "x-ui": {
        "order": 35,
        "widget": "json"
      },
      "items": {
        "type": "object"
      },
      "maxItems": 128,
      "description": "Tool definitions the model may call."
    },
    "messages": {
      "type": "array",
      "x-ui": {
        "order": 100,
        "widget": "chat-messages",
        "primary": true
      },
      "items": {
        "type": "object",
        "allOf": [
          {
            "if": {
              "required": [
                "reasoning_content"
              ]
            },
            "then": {
              "properties": {
                "role": {
                  "const": "assistant"
                }
              }
            }
          }
        ],
        "required": [
          "role"
        ],
        "properties": {
          "role": {
            "enum": [
              "system",
              "developer",
              "user",
              "assistant",
              "tool"
            ],
            "type": "string",
            "description": "Role of the message author."
          },
          "content": {
            "type": [
              "string",
              "array",
              "null"
            ],
            "items": {
              "oneOf": [
                {
                  "type": "object",
                  "required": [
                    "type",
                    "text"
                  ],
                  "properties": {
                    "text": {
                      "type": "string"
                    },
                    "type": {
                      "const": "text"
                    }
                  }
                },
                {
                  "type": "object",
                  "required": [
                    "type",
                    "image_url"
                  ],
                  "properties": {
                    "type": {
                      "const": "image_url"
                    },
                    "image_url": {
                      "type": "object",
                      "required": [
                        "url"
                      ],
                      "properties": {
                        "url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                }
              ]
            },
            "description": "Message content, either plain text or a list of text parts."
          },
          "tool_calls": {
            "type": "array",
            "items": {
              "type": "object"
            },
            "description": "Tool calls the assistant requested in this message."
          },
          "tool_call_id": {
            "type": "string",
            "description": "Identifier of the tool call this message answers. Required on tool messages."
          },
          "reasoning_content": {
            "type": "string",
            "description": "Reasoning text from a previous assistant reply, preserved when continuing a tool conversation."
          }
        },
        "additionalProperties": false
      },
      "minItems": 1,
      "description": "Ordered conversation turns. Text content only on this endpoint."
    },
    "max_tokens": {
      "type": "integer",
      "x-ui": {
        "unit": "tokens",
        "order": 80,
        "widget": "number",
        "advanced": false,
        "affects_price": false
      },
      "default": 4096,
      "maximum": 128000,
      "minimum": 1,
      "description": "Maximum number of tokens to generate in the reply. Thinking counts toward this limit."
    },
    "tool_choice": {
      "enum": [
        "auto",
        "none"
      ],
      "type": "string",
      "x-ui": {
        "order": 30,
        "widget": "text"
      },
      "description": "Whether the model may call a tool: auto or none. A forced tool call is not accepted on this model."
    },
    "reasoning_effort": {
      "enum": [
        "none",
        "low",
        "medium",
        "high",
        "xhigh",
        "max"
      ],
      "type": "string",
      "x-ui": {
        "order": 70,
        "widget": "radio"
      },
      "default": "medium",
      "description": "How much the model thinks before answering; none asks it to skip thinking, though it can still think briefly in long conversations."
    },
    "parallel_tool_calls": {
      "type": "boolean",
      "x-ui": {
        "order": 33,
        "widget": "switch",
        "affects_price": false
      },
      "default": true,
      "description": "Whether the model may request more than one tool call in a single turn."
    }
  },
  "x-image-token-limit": 6000,
  "x-input-token-limit": 1000000,
  "additionalProperties": false
}

Lire le résultat

Avec stream à false, la requête renvoie directement la réponse complète : lisez choices[].message, sans interroger de tâche. Passez stream à true si votre client gère les Server-Sent Events.

Exemple de réponse terminée

{
  "id": "chatcmpl_example",
  "object": "chat.completion",
  "created": 1788652800,
  "model": "anthropic/claude-sonnet-5.5/chat",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Here is a concise summary of the release notes."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 32,
    "completion_tokens": 14,
    "total_tokens": 46
  }
}

Cette réponse n’illustre que la structure. usage donne le nombre de tokens ; la consommation et le coût réels dépendent de votre requête.

SDK et intégrations

Utilisez SpicyAPI dans votre application, terminal, assistant IA ou workflow visuel. Choisissez un guide de configuration.

SDKs

TypeScript · Python · Go · PHP · Java

CLI

Commandes de terminal et scripts d’automatisation.

MCP

Claude Code · Cursor · Codex

Agent Skill

Instructions réutilisables pour votre assistant IA.

n8n

Nœuds communautaires pour n8n auto-hébergé et workflows HTTP Request à importer dans n8n Cloud.

ComfyUI

Workflows image, vidéo et audio sur un canevas de nœuds.

Autres intégrations

SillyTavern Telegram / Discord App proxy OpenAI SDK LangChain Vercel AI SDK

Parcourir les workflows prêts à utiliser

C’est un modèle de conversation : il fonctionne partout où fonctionne l’API chat d’OpenAI. Gardez votre client, changez l’URL de base, désignez ce modèle par son identifiant.

Pointez ici n’importe quel client compatible OpenAI

export OPENAI_BASE_URL="https://api.spicyapi.ai/v1"
export OPENAI_API_KEY="$SPICY_API_KEY"

aider --model openai/anthropic/claude-sonnet-5.5/chat

Tout outil compatible avec l’API chat d’OpenAI s’utilise de la même façon — les SDK, le Vercel AI SDK, LangChain, aider, Cline. Le serveur MCP et la CLI spicyapi prennent en charge les tâches média asynchrones. Retrouvez la configuration de chaque outil dans l’espace développeurs.

L’utiliser dans SillyTavern et les applis de jeu de rôle

Dans SillyTavern, RisuAI, Agnai ou toute appli dotée d’un réglage compatible OpenAI, collez l’URL de base ci-dessous et votre clé d’API, puis choisissez anthropic/claude-sonnet-5.5/chat comme modèle. Les appels depuis le navigateur sont acceptés, et les curseurs que ce modèle ne prend pas en charge sont ignorés au lieu d’être refusés.

Base URL: https://api.spicyapi.ai/v1
Model: anthropic/claude-sonnet-5.5/chat

Guide SillyTavern RisuAI, Agnai et d’autres Extension SillyTavern

À utiliser dans ComfyUI

Installez les nœuds SpicyAPI depuis ComfyUI Manager ou avec la commande ci-dessous, puis choisissez anthropic/claude-sonnet-5.5/chat dans le nœud SpicyAPI Chat pour utiliser ce modèle dans un graphe ComfyUI.

cd ComfyUI/custom_nodes
git clone https://github.com/spicyapi-ai/comfyui-spicyapi

Exemples de workflows Guide d’installation Code source sur GitHub

Le panneau intégré lit le même schéma que cette page : il ne peut donc pas diverger de l’API. Si votre documentation a besoin d’un contenu indexable, récupérez plutôt le JSON sous /api/embed/models/ et affichez-le vous-même.

<iframe src="https://spicyapi.ai/embed/fr/models/claude-sonnet-5-5/api?model=anthropic%2Fclaude-sonnet-5.5%2Fchat" width="100%" height="560" loading="lazy" title="Exemple de requête" style="border:1px solid rgba(0,0,0,.12)"></iframe>

Ouvrir le panneau

Atelier

Envoyer une requête

Authentification API

Paramètres d’entrée

Lire le résultat

SDK et intégrations

L’utiliser dans SillyTavern et les applis de jeu de rôle

À utiliser dans ComfyUI