> ## Documentation Index > Fetch the complete documentation index at: https://docs.aihubmix.com/llms.txt > Use this file to discover all available pages before exploring further. # Chamadas Nativas da API Claude ## Descrição Os modelos da série Claude suportam chamadas oficiais via API nativa. Antes de usar, certifique-se de que a dependência `anthropic` esteja instalada ou atualizada: ```bash theme={null} pip install -U anthropic ``` ## Informações dos Modelos | Nome do Modelo | Claude Opus 4.6 | Claude Sonnet 4.6 | Claude Sonnet 4.5 | Claude Haiku 4.5 | | -------------------------------------- | ----------------------------------------------- | ----------------------------------------------- | ----------------- | ---------------- | | Suporta Extended Thinking | Sim | Sim | Sim | Sim | | Tamanho da Janela de Contexto | 200K tokens /
1M tokens (beta)3 | 200K tokens /
1M tokens (beta)3 | 200K | 200K | | Comprimento Máximo de Saída | 128K tokens | 128K tokens | 64K tokens | 64K tokens | | Data de Corte dos Dados de Treinamento | Agosto de 2025 | Agosto de 2025 | Julho de 2025 | Julho de 2025 | ## Novidades no Claude 4.6 ### Thinking Adaptativo O Claude 4.6 recomenda usar um novo modo de thinking adaptativo, onde o Claude automaticamente determina se deve pensar e a profundidade do pensamento com base na complexidade da pergunta: ```python theme={null} thinking={"type": "adaptive"} ``` `thinking: {type: "enabled", budget_tokens: N}` foi descontinuado no 4.6 e será removido em versões futuras. ### Compactação Automática de Contexto (Beta) Quando as conversas se aproximam do limite da janela de contexto, o Claude 4.6 pode realizar automaticamente compactação por sumarização do conteúdo anterior no lado do servidor. **Vantagens:** * Suporta conversas ultralongas * Não é necessária sumarização no cliente * Aprimora a capacidade do agente para diálogos contínuos **Nota:** * A compactação automática pode perder alguns detalhes * Recomenda-se avaliar testes em cenários que exigem forte consistência ### Descontinuações e Mudanças * **Removido o Header Beta `interleaved-thinking-2025-05-14`:** No 4.6, o thinking adaptativo agora suporta automaticamente interleaved thinking, sem necessidade de adicionar `extra_headers`. Se ainda adicionado, este header será ignorado com segurança. ## Novidades no Claude 4 ### Nova Razão de Parada Refusal O modelo Claude 4 introduz uma nova razão de parada `refusal` para tratar casos onde o modelo se recusa a gerar conteúdo por razões de segurança: ```json theme={null} { "id": "msg_014XEDjypDjFzgKVWdFUXxZP", "type": "message", "role": "assistant", "model": "claude-sonnet-4-20250514", "content": [{"type": "text", "text": "I would be happy to assist you. You can "}], "stop_reason": "refusal", "stop_sequence": null, "usage": { "input_tokens": 564, "cache_creation_input_tokens": 0, "cache_read_input_tokens": 0, "output_tokens": 22 } } ``` Ao migrar para o Claude 4, você deve atualizar sua aplicação para lidar com a razão de parada `refusal`. ### Extended Thinking Uma vez habilitado o extended thinking, a Messages API do modelo Claude 4 retornará um resumo do processo completo de pensamento do Claude. O resumo fornece todas as vantagens inteligentes do extended thinking enquanto previne abusos. Embora a API permaneça consistente entre os modelos Claude 3.7 e 4, a resposta em streaming para extended thinking pode retornar em modo "chunked", com possíveis atrasos entre eventos de streaming. O resumo é processado por um modelo diferente do especificado em sua requisição. O modelo de thinking não verá a saída do resumo. ### Interleaved Thinking O modelo Claude 4 suporta intercalar uso de ferramentas com extended thinking, permitindo conversas mais naturais onde o uso de ferramentas e respostas podem ser misturados com mensagens regulares. O interleaved thinking está atualmente em teste. Para habilitar interleaved thinking, adicione o header de teste `interleaved-thinking-2025-05-14` em sua requisição de API: ```python theme={null} extra_headers={ "anthropic-beta": "interleaved-thinking-2025-05-14" } ``` **Endpoint:** `POST` /v1/messages ## Invocação ```shell Curl theme={null} curl https://aihubmix.com/v1/messages \ --header "x-api-key: $ANTHROPIC_API_KEY" \ # Replace with the key generated on AiHubMix --header "anthropic-version: 2023-06-01" \ --header "content-type: application/json" \ --data \ '{ "model": "claude-3-5-sonnet-20241022", "max_tokens": 1024, "messages": [ {"role": "user", "content": "Hello, world"} ] }' ``` ```py Python Non-streaming theme={null} import anthropic client = anthropic.Anthropic( api_key="sk-***", # Replace with the key generated on AiHubMix base_url="https://aihubmix.com" ) message = client.messages.create( model="claude-3-5-sonnet-20241022", max_tokens=1024, messages=[ {"role": "user", "content": "Hello, Claude"} ] ) print(message.content) ``` ```py Python Streaming 128K theme={null} import anthropic client = anthropic.Anthropic( api_key="sk-***", # Replace with the key generated on AiHubMix base_url="https://aihubmix.com" ) with client.messages.stream( model="claude-3-7-sonnet-20250219", # claude-opus-4-20250514, claude-sonnet-4-20250514 max_tokens=128000, messages=[ {"role": "user", "content": "Please generate a 100,000 token article that elaborates on Charlie Munger's 100 mental models (approximately 1,000 tokens for each model), with each section including an introduction to the model, multidimensional thinking, application methods, practical blind spots, and specific examples. Clarity and engagement are key. Use bullet points only when necessary."} ], extra_headers={ "anthropic-beta": "output-128k-2025-02-19" } ) as stream: for text in stream.text_stream: print(text, end="", flush=True) ``` ```py Python Interleaved Thinking theme={null} import anthropic client = anthropic.Anthropic( api_key="sk-***", # Replace with the key generated on AiHubMix base_url="https://aihubmix.com" ) response = client.messages.create( model="claude-sonnet-4-20250514", # or claude-opus-4-20250514 max_tokens=1024, messages=[ {"role": "user", "content": "Help me analyze this data and generate a chart"} ], tools=[ { "type": "computer_20241022", "name": "computer" } ], extra_headers={ "anthropic-beta": "interleaved-thinking-2025-05-14" } ) print(response.content) ``` ### Estrutura do Corpo da Requisição ```json theme={null} { "model": "claude-3-5-sonnet-20241022", "max_tokens": 1024, "messages": [ { "role": "user", "content": "What is the meaning of life?" } ] } ``` ### Parâmetros da Requisição | Nome | Localização | Tipo | Obrigatório | Descrição | | ------------- | ----------- | --------- | ----------- | ------------------ | | x-api-key | header | string | Não | AIHUBMIX\_API\_KEY | | Content-Type | header | string | Não | nenhum | | body | body | object | Não | nenhum | | » model | body | string | Sim | nenhum | | » messages | body | \[object] | Sim | nenhum | | »» role | body | string | Não | nenhum | | »» content | body | string | Sim | nenhum | | » max\_tokens | body | number | Sim | nenhum | ### Exemplo de Resposta ```json theme={null} 200 Response ``` ```json theme={null} { "id": "msg_013Uf6CwwyjSe35n3yVaPbLM", "type": "message", "role": "assistant", "model": "claude-3-5-sonnet-20241022", "content": [ { "type": "text", "text": "That's one of humanity's most enduring and complex philosophical questions! While there's no universal answer, I aim to explore such questions thoughtfully while acknowledging their complexity. I try to focus on having meaningful conversations and helping where I can. What does meaning in life mean to you?" } ], "stop_reason": "end_turn", "stop_sequence": null, "usage": { "input_tokens": 14, "cache_creation_input_tokens": 0, "cache_read_input_tokens": 0, "output_tokens": 61 } } ``` ### Resultados da Resposta | Código de Status | Significado | Descrição | Modelo de Dados | | ---------------- | ----------- | --------- | --------------- | | 200 | OK | nenhum | Inline | ## Migrando para Claude 4 Se você está migrando do Claude 3.7 para os modelos Claude 4, esteja ciente das seguintes mudanças: ### Atualizar Nome do Modelo ```python theme={null} # From Claude 3.7 model="claude-3-7-sonnet-20250219" # Migrate to Claude 4 model="claude-sonnet-4-20250514" # or "claude-opus-4-20250514" ``` ### Tratar Novas Razões de Parada Atualize sua aplicação para tratar a nova razão de parada `refusal`: ```python theme={null} if response.stop_reason == "refusal": print("Claude refuses to generate this content") elif response.stop_reason == "end_turn": print("Completed normally") ``` ### Remover Recursos Não Suportados * **Token Efficient Tool Usage:** Disponível apenas no Claude Sonnet 3.7, não mais suportado no Claude 4 * **Extended Output:** O header de teste `output-128k-2025-02-19` está disponível apenas no Claude Sonnet 3.7 Se você está migrando do Claude Sonnet 3.7, recomenda-se remover esses headers de teste das suas requisições: ```python theme={null} # Remove these headers (if present) # "token-efficient-tools-2025-02-19" # "output-128k-2025-02-19" ``` ## Usando em Aplicações (Exemplo com Lobe-Chat) * Vá para a página de configurações e selecione o provider de modelo Claude * Insira a chave de API do [nosso site](https://aihubmix.com/token) * Digite o endereço do proxy de API diretamente como segue: ``` https://aihubmix.com ``` * Recomenda-se habilitar "Use Client Request Mode" * Por fim, adicione os modelos que deseja usar à lista de modelos (sugere-se copiar e colar o nome do modelo da página de configurações do nosso site)\\ Image Image ## Ferramentas de Edição de Texto do Claude O Claude pode usar ferramentas de edição de texto definidas pela Anthropic para visualizar e modificar arquivos de texto, ajudando você a depurar, corrigir e melhorar código ou outros documentos de texto. Isso permite que o Claude interaja diretamente com seus arquivos, fornecendo assistência operacional prática em vez de apenas sugestões. ### Preparação Antes de Usar as Ferramentas de Edição de Texto Selecione modelos compatíveis. As ferramentas de edição de texto da Anthropic suportam os seguintes modelos Claude: * **Modelos da Série Claude 4** (`claude-opus-4-20250514`, `claude-sonnet-4-20250514`): `text_editor_20250429` * **Claude 3.7 Sonnet** (`claude-3-7-sonnet-20250219`): `text_editor_20250124` * **Claude 3.5 Sonnet** (`claude-3-5-sonnet-20241022`): `text_editor_20241022` Os modelos Claude 4 usam uma ferramenta de edição de texto totalmente nova que não é compatível com versões mais antigas. Certifique-se de usar o tipo e nome corretos da ferramenta. ### Configuração da Ferramenta por Modelo | Versão do Modelo | Tipo da Ferramenta | Nome da Ferramenta | Recursos Suportados | | ---------------------- | ---------------------- | ----------------------------- | -------------------------------------- | | Claude 4 (Opus/Sonnet) | `text_editor_20250429` | `str_replace_based_edit_tool` | view, str\_replace, create | | Claude 3.7 Sonnet | `text_editor_20250124` | `str_replace_editor` | view, str\_replace, create, undo\_edit | | Claude 3.5 Sonnet | `text_editor_20241022` | `str_replace_editor` | view, str\_replace, create, undo\_edit | **Mudança Importante:** O modelo Claude 4 não suporta mais o comando `undo_edit`. Por favor, remova quaisquer dependências dessa funcionalidade do seu código. ### Avaliação dos Casos de Uso Aqui estão alguns cenários típicos para usar as ferramentas de edição de texto: * Depuração de Código: Ajuda a identificar e corrigir problemas no código, desde erros de sintaxe até problemas lógicos. * Refatoração de Código: Melhora a estrutura, legibilidade e desempenho do código através de edições direcionadas. * Geração de Documentação: Adiciona docstrings, comentários ou arquivos README ao seu codebase. * Criação de Testes: Cria testes unitários com base na compreensão da implementação. ### Usando as Ferramentas de Edição de Texto Forneça ao Claude ferramentas de edição de texto (chamadas `str_replace_editor`) através da Messages API: Você precisa instalar o pacote `anthropic`: ```shell theme={null} pip install anthropic ``` **Exemplos de Invocação:** ```python Python-Claude 4 theme={null} import anthropic client = anthropic.Anthropic( api_key="sk-***", # Replace with the key generated on AiHubMix base_url="https://aihubmix.com" ) response = client.messages.create( model="claude-sonnet-4-20250514", # or claude-opus-4-20250514 max_tokens=1024, tools=[ { "type": "text_editor_20250429", "name": "str_replace_based_edit_tool" } ], messages=[ { "role": "user", "content": "There's a syntax error in my primes.py file. Can you help me fix it?" } ] ) print("Response content:") for message in response.content: print(message.text) ``` ```py Python-Claude 3.7 theme={null} import anthropic client = anthropic.Anthropic( api_key="sk-***", # Replace with the key generated on AiHubMix base_url="https://aihubmix.com" ) response = client.messages.create( model="claude-3-7-sonnet-20250219", max_tokens=1024, tools=[ { "type": "text_editor_20250124", "name": "str_replace_editor" } ], messages=[ { "role": "user", "content": "There's a syntax error in my primes.py file. Can you help me fix it?" } ] ) print("Response content:") for message in response.content: print(message.text) ``` ```shell Curl-Claude 4 theme={null} curl -X POST https://aihubmix.com/v1/messages \ -H "Content-Type: application/json" \ -H "x-api-key: xxx" \ -H "anthropic-version: 2023-06-01" \ -d '{ "model": "claude-sonnet-4-20250514", "max_tokens": 1024, "tools": [ { "type": "text_editor_20250429", "name": "str_replace_based_edit_tool" } ], "messages": [ { "role": "user", "content": "There'\''s a syntax error in my primes.py file. Can you help me fix it?" } ] }' ``` ```shell Curl-Claude 3.7 theme={null} curl -X POST https://aihubmix.com/v1/messages \ -H "Content-Type: application/json" \ -H "x-api-key: xxx" \ -H "anthropic-version: 2023-06-01" \ -d '{ "model": "claude-3-7-sonnet-20250219", "max_tokens": 1024, "tools": [ { "type": "text_editor_20250124", "name": "str_replace_editor" } ], "messages": [ { "role": "user", "content": "There'\''s a syntax error in my primes.py file. Can you help me fix it?" } ] }' ``` ### Migrando para Claude 4 (Ferramentas de Edição de Texto) Se você está migrando do Claude 3.7 Sonnet para os modelos Claude 4, esteja ciente das seguintes mudanças: #### Atualizar Configuração da Ferramenta ```py python theme={null} # Claude 3.7 Sonnet tools=[ { "type": "text_editor_20250124", "name": "str_replace_editor" } ] # Claude 4 (Opus/Sonnet) tools=[ { "type": "text_editor_20250429", "name": "str_replace_based_edit_tool" } ] ``` #### Remover Recursos Não Suportados * **Comando `undo_edit`**: O modelo Claude 4 não suporta mais a funcionalidade undo edit. * Por favor, remova qualquer lógica que dependa de `undo_edit` do seu código. Exemplo de Resposta: ```json theme={null} { "id": "msg_bdrk_012xyNaFCQg4zsVcTk5VkDAe", "type": "message", "role": "assistant", "content": [ { "type": "text", "text": "I'd be happy to help you fix the syntax error in your `primes.py` file. First, let me take a look at the file to identify the issue." }, { "type": "tool_use", "text": "", "id": "toolu_bdrk_01P6jQG6suDSsDjzugqGVHWC", "name": "str_replace_based_edit_tool", "input": { "command": "view", "path": "/repo/primes.py" } } ], "model": "claude-sonnet-4-20250514", "stop_reason": "tool_use", "usage": { "input_tokens": 1042, "output_tokens": 115 } } ``` *** Última atualização: 2026-06-01