API do Claude Sonnet 5: contexto 1M, 3 níveis

anthropic/claude-sonnet-5/chat

Chat com o Claude Sonnet 5 da Anthropic por um endpoint compatível com OpenAI. Aceita até 1.000.000 de tokens de contexto de texto e imagem e devolve até 64.000, com esforço de raciocínio low, medium ou high, até 128 definições de ferramentas e streaming SSE.

Entrada $1.90Saída $9.50por 1 milhão de tokensEntrada em cache $0.19Gravação em cache $2.375Preço oficial · Anthropic$2~~$10~~

Executar modelo Ver API

Enviar uma requisição

Os exemplos usam as definições públicas de parâmetros do endpoint selecionado. Troque a chave de API e as mídias de exemplo e envie a requisição a partir do seu servidor.

SDKs e integrações

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

Autenticação da API

Guarde a chave de API na variável de ambiente do servidor SPICY_API_KEY. Use autenticação Bearer e Content-Type: application/json nas requisições 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/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'

Gerado a partir do schema de entrada deste modelo — o mesmo que a API usa para validar cada requisição.

Use um Idempotency-Key para cada requisição lógica. Depois de uma interrupção de rede, não reenvie automaticamente com uma chave nova; guarde o request_id para investigar a requisição aceita. A idempotência não reproduz um stream de chat anterior.

Parâmetros de entrada

Coloque os parâmetros do modelo direto no corpo JSON da requisição, ao lado de model. Este endpoint não usa um objeto input.

messagesarray<object>Obrigatório

Turnos de conversa ordenados. O conteúdo é uma string ou um array de partes text e image_url. Ponha o elenco e as regras de saída na mensagem de system, e a ação nos turnos de user. A última mensagem não pode ser de assistant.

Valor padrão: Não especificado
Restrições: minItems:1

messages[].rolestringObrigatório no objeto

Role of the message author.

Valor padrão: Não especificado
Valores permitidos: "system""developer""user""assistant""tool"

messages[].namestringOpcional

Optional name identifying the speaker within its role.

Valor padrão: Não especificado

messages[].contentstring | array | nullOpcional

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

Valor padrão: Não especificado

{
  "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 content parts."
}

messages[].tool_callsarray<object>Opcional

Tool calls the assistant requested in this message.

Valor padrão: Não especificado

messages[].tool_call_idstringOpcional

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

Valor padrão: Não especificado

messages[].reasoning_contentstringOpcional

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

Valor padrão: Não especificado

{
  "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": {
      "name": {
        "type": "string",
        "description": "Optional name identifying the speaker within its role."
      },
      "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 content 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_choicestring | objectOpcional

auto, none, required ou um objeto nomeando uma função.

Valor padrão: Não especificado

parallel_tool_callsbooleanOpcional

true ou false, padrão true: o modelo pode pedir várias chamadas de ferramenta no mesmo turno. Com false, você recebe no máximo uma chamada por turno, útil em loops em que cada chamada depende do resultado anterior. Não afeta o preço.

Valor padrão: true

toolsarray<object>Opcional

Até 128 definições de função por requisição.

Valor padrão: Não especificado
Restrições: maxItems:128

stopstring | arrayOpcional

Até 4 sequências, como string ou array. A resposta termina assim que o modelo escreve uma delas, e o texto correspondente não é devolvido. Sem valor padrão. Não muda a tarifa: uma resposta interrompida antes é cobrada só pelos tokens que gerou.

Valor padrão: Não especificado
Restrições: minLength:1
minItems:1
maxItems:4

reasoning_effortstringOpcional

low, medium ou high, padrão medium. Trocas comuns em low, e um degrau acima para a cena que precisa acertar. O padrão da própria Anthropic para este modelo é high; este endpoint fica um degrau abaixo para que turnos comuns continuem rápidos.

Valor padrão: "medium"
Valores permitidos: "low""medium""high"

max_tokensintegerOpcional

Limita a resposta a 64.000 — um dezesseis avos da janela de leitura. Padrão 4.096. O raciocínio sai deste mesmo orçamento, então um limite pequeno pode se esgotar antes de a resposta começar e voltar vazia ou cortada. Deixe folga de verdade quando o reasoning_effort estiver alto.

Valor padrão: 4096
Restrições: minimum:1
maximum:64000

{
  "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": {
          "name": {
            "type": "string",
            "description": "Optional name identifying the speaker within its role."
          },
          "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 content 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": 64000,
      "minimum": 1,
      "description": "Maximum number of tokens to generate in the reply."
    },
    "tool_choice": {
      "type": [
        "string",
        "object"
      ],
      "x-ui": {
        "order": 30,
        "widget": "json"
      },
      "description": "Controls whether and which tool the model may call."
    },
    "reasoning_effort": {
      "enum": [
        "low",
        "medium",
        "high"
      ],
      "type": "string",
      "x-ui": {
        "order": 70,
        "widget": "radio"
      },
      "default": "medium",
      "description": "How much the model works through the task before answering."
    },
    "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,
  "x-max-tokens-includes-reasoning": true
}

Ler resultado

Com stream em false, a requisição já devolve a resposta completa: leia choices[].message, sem consultar tarefa nenhuma. Coloque stream em true se o seu cliente aceita Server-Sent Events.

Exemplo de resposta concluída

{
  "id": "chatcmpl_example",
  "object": "chat.completion",
  "created": 1788652800,
  "model": "anthropic/claude-sonnet-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
  }
}

Esta resposta serve só para mostrar o formato. usage traz a contagem de tokens; o consumo e a cobrança reais dependem da sua requisição.

SDKs e integrações

Use a SpicyAPI no seu app, terminal, assistente de IA ou fluxo visual. Escolha um guia de configuração.

SDKs

TypeScript · Python · Go · PHP · Java

CLI

Comandos de terminal e scripts de automação.

MCP

Claude Code · Cursor · Codex

Agent Skill

Instruções reutilizáveis para seu assistente de IA.

n8n

Nós comunitários para instalações próprias e modelos importáveis com HTTP Request para n8n Cloud.

ComfyUI

Fluxos de imagem, vídeo e áudio em um canvas de nós.

Mais integrações

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

Explorar fluxos prontos para usar

É um modelo de chat, então funciona onde a API de chat da OpenAI funciona: mantenha seu cliente, troque a URL base e escolha este modelo pelo identificador.

Aponte qualquer cliente compatível com OpenAI para cá

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

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

Qualquer ferramenta compatível com a API de chat da OpenAI funciona da mesma forma: SDKs, Vercel AI SDK, LangChain, aider e Cline. O servidor MCP e o CLI spicyapi atendem tarefas de mídia assíncronas. A configuração de cada ferramenta está no hub de desenvolvimento.

Use no SillyTavern e em apps de roleplay

No SillyTavern, RisuAI, Agnai ou qualquer app com configuração compatível com OpenAI, cole a URL base abaixo e sua chave de API e escolha anthropic/claude-sonnet-5/chat como modelo. Chamadas direto do navegador são aceitas, e controles que este modelo não suporta são ignorados em vez de recusados.

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

Guia do SillyTavern RisuAI, Agnai e outros Extensão do SillyTavern

Use no ComfyUI

Instale os nós da SpicyAPI pelo ComfyUI Manager ou com o comando abaixo e escolha anthropic/claude-sonnet-5/chat no nó SpicyAPI Chat para usar este modelo em um grafo do ComfyUI.

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

Exemplos de fluxos de trabalho Guia de configuração Código-fonte no GitHub

O painel incorporado lê o mesmo schema desta página, então não tem como sair de sincronia com a API. Se a sua documentação precisar de conteúdo indexável, pegue o JSON em /api/embed/models/ e renderize por conta própria.

<iframe src="https://spicyapi.ai/embed/pt-BR/models/claude-sonnet-5/api?model=anthropic%2Fclaude-sonnet-5%2Fchat" width="100%" height="560" loading="lazy" title="Exemplo de requisição" style="border:1px solid rgba(0,0,0,.12)"></iframe>

Abrir o painel

Playground

Enviar uma requisição

Autenticação da API

Parâmetros de entrada

Ler resultado

SDKs e integrações

Use no SillyTavern e em apps de roleplay

Use no ComfyUI