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

# Hướng dẫn nhanh Claude API: Gửi yêu cầu Messages với CometAPI

> Gọi các model Claude thông qua Anthropic-compatible Messages API của CometAPI bằng curl, Python và Node.js.

## Những gì bạn sẽ xây dựng

Bạn sẽ gửi một yêu cầu đến `POST /v1/messages`, in ra văn bản phản hồi từ Claude, và giữ cho đoạn mã sẵn sàng để dùng với Anthropic SDK hoặc HTTP trực tiếp.

## Điều kiện tiên quyết

* Một API key CometAPI được lưu trong `COMETAPI_KEY`
* Một model ID Claude từ [trang Models](/vi/overview/models)
* `curl`, Python 3.10+, hoặc Node.js 18+

## API key, base URL, xác thực

Sử dụng endpoint Messages tương thích với Anthropic thông qua CometAPI:

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

Xác thực các yêu cầu HTTP trực tiếp bằng `x-api-key` và header phiên bản API của Anthropic:

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

## Ví dụ mã

Sử dụng các tab bên dưới để xem các ví dụ có thể sao chép cho cURL, Python và 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>

## Giải thích luồng

Các yêu cầu Claude Messages mặc định là đồng bộ. API trả về một đối tượng message trong một phản hồi HTTP duy nhất, và ứng dụng của bạn đọc khối nội dung văn bản đầu tiên.

Sử dụng route này khi bạn cần các dạng yêu cầu dành riêng cho Claude như mảng message của Anthropic, extended thinking, prompt caching hoặc tool use. Nếu ứng dụng của bạn đã sử dụng Anthropic SDK chính thức, hãy đặt base URL của SDK thành `https://api.cometapi.com` và giữ nguyên dạng yêu cầu của Messages API.

## Các tham số phổ biến

| Parameter    | Use                                                                      |
| ------------ | ------------------------------------------------------------------------ |
| `model`      | Một model ID Claude khả dụng cho tài khoản của bạn.                      |
| `max_tokens` | Ngân sách token phản hồi tối đa cho phản hồi của Messages API.           |
| `messages`   | Mảng message của Anthropic với các vai trò `user` và `assistant`.        |
| `stream`     | Truyền các sự kiện message tăng dần khi được đặt thành `true`.           |
| `thinking`   | Bật extended thinking của Claude khi model đã chọn hỗ trợ tính năng này. |

## Khắc phục sự cố / FAQ

<AccordionGroup>
  <Accordion title="Yêu cầu trả về 401">
    Xác nhận rằng `COMETAPI_KEY` được đặt trong cùng shell hoặc runtime gửi yêu cầu. Không dán key thật vào các tệp mã nguồn.
  </Accordion>

  <Accordion title="SDK vẫn gọi trực tiếp đến Anthropic">
    Xác nhận rằng SDK client đặt `base_url` trong Python hoặc `baseURL` trong Node.js thành `https://api.cometapi.com`.
  </Accordion>

  <Accordion title="Tôi nên dùng model nào">
    Sử dụng một model ID Claude khả dụng cho tài khoản của bạn. Hướng dẫn nhanh này không hardcode một model Claude vì mức độ khả dụng thay đổi theo tài khoản và họ model.
  </Accordion>
</AccordionGroup>

## Các bước tiếp theo

* Sử dụng [tài liệu tham khảo Anthropic Messages API](/api/text/anthropic-messages) để xem đầy đủ các trường yêu cầu và phản hồi.
* Kiểm tra mức độ khả dụng của model trong [Models](/vi/overview/models).
* Cấu hình các phiên coding cục bộ với [hướng dẫn tích hợp Claude Code](/vi/integrations/claude-code).
* Xem lại hành vi retry trong [Mã lỗi và chiến lược retry](/vi/guides/error-codes-and-retry-strategy).