← Todos os artigos

API Claude: chave, o endpoint /v1/messages e escolha de uma versão do modelo

Uma chave de acesso digital brilhante ao lado de blocos de texto volumétricos flutuantes em um fundo escuro

A API Claude é como você chama modelos Claude a partir de seu próprio código em vez de uma janela de bate-papo: um bot de suporte em seu site, um script que faz a triagem de tickets, conclusão de código em um editor, uma integração de CRM. No NeuralSpace uma chave é criada em seu painel em cerca de um minuto, as solicitações vão para o compatível com Anthropic POST /v1/messages endpoint e você paga com um saldo de token sem assinatura. Abaixo está um guia passo a passo: como obter uma chave, como é sua primeira chamada e como escolher uma versão do modelo – Haiku, Sonnet, Opus ou Fable.

O que é a API Claude e como ela difere do chat

Claude é a família de modelos de linguagem da Antrópica. Em uma janela de chat você conversa com a modelo manualmente; por meio da API, seu código faz a mesma coisa: envia um array de mensagens, obtém uma resposta gerada e a utiliza em seu produto — mostra ao usuário, armazena e processa posteriormente. Casos de uso típicos: suporte a bots, resumo de e-mails e documentos, extração de dados estruturados, elaboração de conteúdo, automatização de trabalho rotineiro em scripts. A principal diferença do chat é a previsibilidade: você mesmo define as instruções do sistema, o limite de resposta e a versão do modelo e vê o gasto em tokens.

Passo 1. Obtenha uma chave

  1. Inscreva-se no NeuralSpace com seu e-mail – leva menos de um minuto. Novos usuários recebem tokens iniciais creditados, o suficiente para as primeiras solicitações sem recarga.
  2. Abra o Página de chaves de API no seu painel, insira um nome de chave (por exemplo, "Meu bot") e clique em Criar.
  3. A chave parece nsk-… e é mostrado apenas uma vez - copie-o diretamente em um gerenciador de senhas ou em uma variável de ambiente, não no código do seu repositório.
  4. Verifique seu saldo: os modelos de texto exigem pelo menos 50 tokens na conta. As recargas acontecem no painel, sem taxa de assinatura.
A página de chaves da API NeuralSpace: criando uma chave e o início rápido do Claude

Etapa 2. Sua primeira chamada para /v1/messages

Os modelos de texto de Claude vivem no compatível com Antrópico POST https://neuralspace.pro/v1/messages ponto final. O corpo carrega o modelo, um messages matriz com user/assistant funções, o limite de resposta max_tokens (1 a 32.000) e um opcional system instrução. Uma solicitação curl mínima:

curl https://neuralspace.pro/v1/messages \
  -H "x-api-key: nsk-your_key" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "max_tokens": 1024,
    "system": "You answer technical questions briefly.",
    "messages": [{"role": "user", "content": "How is streaming different from a regular response?"}]
  }'

A resposta volta em formato antrópico: o texto está em content[0].text e o gasto real está no usage campo. Autenticar com o x-api-key: nsk-… cabeçalho; clientes que só falam Bearer podem usar Authorization: Bearer nsk-… em vez de.

Etapa 3. Conecte o Anthropic SDK

Se você já possui código no Anthropic SDK oficial, você altera exatamente dois valores – base_url e a chave:

from anthropic import Anthropic

client = Anthropic(
    base_url="https://neuralspace.pro",
    api_key="nsk-your_key",
)

resp = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=1024,
    system="You answer technical questions briefly.",
    messages=[{"role": "user", "content": "Suggest three names for a channel about AI"}],
)
print(resp.content[0].text)

Para interfaces de bate-papo, o streaming ajuda: adicione "stream": true e a resposta chega em pedaços por meio de eventos enviados pelo servidor, para que o usuário veja as primeiras palavras antes do término da geração.

Qual versão do modelo escolher

O catálogo público do NeuralSpace tem quatro versões de Claude, e a diferença entre elas é o equilíbrio entre velocidade e preço e profundidade de raciocínio. Os preços abaixo estão em tokens de site por milhão de tokens de API, com entrada e saída cobradas separadamente (no momento da escrita; as taxas são flutuantes):

  • Claude Haiku 4.5 (claude-haiku-4-5) — 41/213. O mais rápido e mais barato: classificação, respostas curtas, processamento de texto em massa, rotulagem aproximada.
  • Claude Soneto 5 (claude-sonnet-5) - 152,5 / 767. O burro de carga: código, instruções longas, diálogo de contexto pesado. Um padrão sensato.
  • Cláudio Opus 5 (claude-opus-5) — 359/1794,5. Para tarefas difíceis: raciocínio em várias etapas, análise de grandes documentos, lógica sutil.
  • Claude Fábula 5 (claude-fable-5) — 718/3589,5. O carro-chefe para os cenários mais exigentes, onde a qualidade é mais importante que o preço.

Uma regra prática: comece com Haiku ou Sonnet e mude para Opus e Fable seletivamente, apenas quando os dois primeiros realmente falham. A versão é definida por um único model campo na solicitação, para que você possa compará-los no mesmo prompt.

Streaming, limites e endpoints de serviço

Dois limites atrapalham as pessoas: 60 solicitações por minuto por chave e um saldo mínimo de 50 tokens para modelos de texto. Seu saldo atual vem de GET /v1/balancee uma lista legível por máquina de modelos com preços em tempo real de GET /v1/models. Ambos requerem uma chave. As taxas atuais são sempre mostradas na tabela do Página de documentação da API.

Claude API e MCP: conectando-o ao Claude Code

A mesma chave conecta o NeuralSpace aos agentes de IA como um servidor MCP: o próprio agente chama a geração de chat, imagem, vídeo e música em nome de sua conta. Para Claude Code é um comando:

claude mcp add --transport http neuralspace https://neuralspace.pro/mcp \
  --header "Authorization: Bearer nsk-your_key"

Caso você ainda não precise da API, os mesmos modelos estão disponíveis na interface — em bater papo você pode escolher Claude e conversar sem código, e o saldo é compartilhado entre chat e API.

Perguntas frequentes

Preciso de uma conta Antrópica ou de um cartão estrangeiro?

A chave é emitida no painel do NeuralSpace e você paga com tokens de conta — sem assinatura e sem configuração de faturamento na nuvem.

Qual a diferença entre /v1/messages e /v1/chat/completions?

São dois formatos da mesma API. /v1/messages espelha a API Anthropic Messages (campos model, messages, system, max_tokens) e atende aos modelos Claude e ao Anthropic SDK. /v1/chat/completions é o formato OpenAI para modelos de chat GPT e Grok. Apenas o endereço e a estrutura do corpo mudam.

Quanto custa uma chamada API Claude?

Apenas para os tokens que você realmente usa: Claude Sonnet 5 no momento em que este artigo foi escrito é de 152,5 tokens por milhão de entrada e 767 por milhão de saída. Uma solicitação de alguns milhares de tokens custa cerca de US$ 0,01. Os preços atuais estão em GET /v1/models e na tabela de documentação.

Existe um nível gratuito?

Não há gerações livres na plataforma. Novos usuários recebem tokens iniciais, suficientes para as primeiras execuções; depois disso, você paga por token sem taxa de assinatura.