> ## Documentation Index
> Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Guia rápido da API Claude: envie requisições Messages com a CometAPI

> Chame modelos Claude pela API Messages compatível com Anthropic da CometAPI usando curl, Python e Node.js.

## O que você vai criar

Você enviará uma requisição para `POST /v1/messages`, imprimirá o texto da resposta do Claude e deixará o código pronto para uso com o SDK da Anthropic ou HTTP direto.

## Pré-requisitos

* Uma chave de API da CometAPI armazenada em `COMETAPI_KEY`
* Um model ID do Claude da [página Models](/pt/overview/models)
* `curl`, Python 3.10+ ou Node.js 18+

## Chave de API, URL base, autenticação

Use o endpoint Messages compatível com Anthropic por meio da CometAPI:

```text theme={null}
https://api.cometapi.com/v1/messages
```

Autentique requisições HTTP diretas com `x-api-key` e o cabeçalho da versão da API da Anthropic:

```text theme={null}
x-api-key: $COMETAPI_KEY
anthropic-version: 2023-06-01
```

## Exemplos de código

Use as abas abaixo para exemplos copiáveis em cURL, Python e Node.js.

<CodeGroup>
  ```bash cURL theme={null}
  curl https://api.cometapi.com/v1/messages \
    -H "Content-Type: application/json" \
    -H "x-api-key: $COMETAPI_KEY" \
    -H "anthropic-version: 2023-06-01" \
    -d '{
      "model": "your-claude-model-id",
      "max_tokens": 256,
      "messages": [
        {
          "role": "user",
          "content": "Reply with one short sentence."
        }
      ]
    }'
  ```

  ```python Python theme={null}
  import os
  import anthropic

  client = anthropic.Anthropic(
      api_key=os.environ["COMETAPI_KEY"],
      base_url="https://api.cometapi.com",
  )

  message = client.messages.create(
      model="your-claude-model-id",
      max_tokens=256,
      messages=[
          {
              "role": "user",
              "content": "Reply with one short sentence.",
          }
      ],
  )

  print(message.content[0].text)
  ```

  ```javascript Node.js theme={null}
  import Anthropic from "@anthropic-ai/sdk";

  const client = new Anthropic({
    apiKey: process.env.COMETAPI_KEY,
    baseURL: "https://api.cometapi.com",
  });

  const message = await client.messages.create({
    model: "your-claude-model-id",
    max_tokens: 256,
    messages: [
      {
        role: "user",
        content: "Reply with one short sentence.",
      },
    ],
  });

  console.log(message.content[0].text);
  ```
</CodeGroup>

## Explicação do fluxo

As requisições Claude Messages são síncronas por padrão. A API retorna um objeto de mensagem em uma resposta HTTP, e sua aplicação lê o primeiro bloco de conteúdo de texto.

Use esta rota quando precisar de formatos de requisição específicos do Claude, como arrays de mensagens da Anthropic, pensamento estendido, cache de prompt ou uso de ferramentas. Se sua aplicação já usa o SDK oficial da Anthropic, defina a URL base do SDK como `https://api.cometapi.com` e mantenha o formato de requisição da API Messages.

## Parâmetros comuns

| Parameter    | Use                                                                                 |
| ------------ | ----------------------------------------------------------------------------------- |
| `model`      | Um model ID do Claude disponível para sua conta.                                    |
| `max_tokens` | Orçamento máximo de token de resposta para a resposta da API Messages.              |
| `messages`   | Array de mensagens da Anthropic com os papéis `user` e `assistant`.                 |
| `stream`     | Faz Streaming de eventos incrementais de mensagem quando definido como `true`.      |
| `thinking`   | Ativa o pensamento estendido do Claude quando o modelo selecionado oferece suporte. |

## Solução de problemas / FAQ

<AccordionGroup>
  <Accordion title="A requisição retorna 401">
    Confirme que `COMETAPI_KEY` está definido no mesmo shell ou ambiente de execução que envia a requisição. Não cole uma chave real em arquivos-fonte.
  </Accordion>

  <Accordion title="O SDK ainda chama a Anthropic diretamente">
    Confirme que o cliente do SDK define `base_url` no Python ou `baseURL` no Node.js como `https://api.cometapi.com`.
  </Accordion>

  <Accordion title="Qual modelo devo usar">
    Use um model ID do Claude disponível para sua conta. Este guia rápido não fixa um modelo Claude porque a disponibilidade varia por conta e família de modelos.
  </Accordion>
</AccordionGroup>

## Próximos passos

* Use a [referência da Anthropic Messages API](/api/text/anthropic-messages) para ver todos os campos de requisição e resposta.
* Verifique a disponibilidade de modelos em [Models](/pt/overview/models).
* Configure sessões locais de programação com o [guia de integração do Claude Code](/pt/integrations/claude-code).
* Revise o comportamento de retry em [Códigos de erro e estratégia de retry](/pt/guides/error-codes-and-retry-strategy).