AiHubMix Documentation Hub

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:

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)³	200K tokens / 1M tokens (beta)³	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:

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:

{
  "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:

extra_headers={
    "anthropic-beta": "interleaved-thinking-2025-05-14"
}

Endpoint: POST /v1/messages

Invocação

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"}
    ]
}'

Estrutura do Corpo da Requisição

{
  "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

200 Response

{
  "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

# 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:

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:

# 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
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)\

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:

pip install anthropic

Exemplos de Invocação:

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)

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

python

# 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:

{
  "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

Documentation Index

​Descrição

​Informações dos Modelos

​Novidades no Claude 4.6

​Thinking Adaptativo

​Compactação Automática de Contexto (Beta)

​Descontinuações e Mudanças

​Novidades no Claude 4

​Nova Razão de Parada Refusal

​Extended Thinking

​Interleaved Thinking

​Invocação

​Estrutura do Corpo da Requisição

​Parâmetros da Requisição

​Exemplo de Resposta

​Resultados da Resposta

​Migrando para Claude 4

​Atualizar Nome do Modelo

​Tratar Novas Razões de Parada

​Remover Recursos Não Suportados

​Usando em Aplicações (Exemplo com Lobe-Chat)

​Ferramentas de Edição de Texto do Claude

​Preparação Antes de Usar as Ferramentas de Edição de Texto

​Configuração da Ferramenta por Modelo

​Avaliação dos Casos de Uso

​Usando as Ferramentas de Edição de Texto

​Migrando para Claude 4 (Ferramentas de Edição de Texto)

​Atualizar Configuração da Ferramenta

​Remover Recursos Não Suportados

Descrição

Informações dos Modelos

Novidades no Claude 4.6

Thinking Adaptativo

Compactação Automática de Contexto (Beta)

Descontinuações e Mudanças

Novidades no Claude 4

Nova Razão de Parada Refusal

Extended Thinking

Interleaved Thinking

Invocação

Estrutura do Corpo da Requisição

Parâmetros da Requisição

Exemplo de Resposta

Resultados da Resposta

Migrando para Claude 4

Atualizar Nome do Modelo

Tratar Novas Razões de Parada

Remover Recursos Não Suportados

Usando em Aplicações (Exemplo com Lobe-Chat)

Ferramentas de Edição de Texto do Claude

Preparação Antes de Usar as Ferramentas de Edição de Texto

Configuração da Ferramenta por Modelo

Avaliação dos Casos de Uso

Usando as Ferramentas de Edição de Texto

Migrando para Claude 4 (Ferramentas de Edição de Texto)

Atualizar Configuração da Ferramenta

Remover Recursos Não Suportados