Claude API: Cách lấy key và sử dụng API

Ảo giác khi đọc tài liệu dài. Lối viết rập khuôn. Code không chạy. Nếu ứng dụng AI của bạn gặp phải bất kỳ vấn đề nào trong số này, bạn không cần tạo prompt tốt hơn, mà cần Claude. Với cửa sổ ngữ cảnh mở rộng, lối viết tinh tế dễ hướng dẫn và khả năng suy luận mạnh mẽ cho các thách thức kỹ thuật, nó giống như một trợ lý thân thiện được đào tạo để cộng tác.

Claude API là gì?

Claude API cho phép bạn tích hợp khả năng trí tuệ nhân tạo (AI) của Claude vào các ứng dụng và công cụ nội bộ của mình. Gửi cho Claude một yêu cầu thông qua lệnh gọi API, và nó sẽ trả về phản hồi mà bạn có thể sử dụng theo bất kỳ cách nào bạn cần - cho dù đó là trả lời câu hỏi của khách hàng, phân tích tài liệu, tạo nội dung hoặc hỗ trợ logic ra quyết định phức tạp - tất cả mà người dùng không cần phải truy cập Claude.ai.

Hướng dẫn thiết lập kết nối Claude API

Hãy pha một tách cà phê, tắt hết những thứ gây xao nhãng và cùng nhau tạo nên điều kỳ diệu. Bạn có thể hoàn thành hướng dẫn này trong khoảng 30 phút. Đừng lo lắng nếu bạn không thể làm xong trong một lần: Mỗi bước đều được đánh số để bạn có thể dễ dàng quay lại và hoàn thành.

Bước 1: Trước khi bắt đầu

Trước khi bắt đầu, đây là những gì bạn cần có và biết để hoàn thành nhanh chóng:

• Hiểu biết cơ bản về API là gì
• Hiểu biết cơ bản về JSON. JSON được sử dụng để định dạng nội dung cuộc gọi API. Nếu bạn gặp khó khăn, ChatGPT có thể giúp bạn phát hiện lỗi hoặc sửa lỗi định dạng.
• 15 đến 30 phút tập trung.
• Thẻ tín dụng để mua credit Claude API (tối thiểu 5 USD).
• Tùy chọn: Tài khoản Postman (miễn phí) để làm theo hướng dẫn và thực hiện các cuộc gọi đầu tiên.

Bước 2: Tạo tài khoản Anthropic

(2.1) Trước tiên, hãy vào bảng điều khiển Anthropic và tạo tài khoản nhà phát triển.

Bước 3: Thêm credit vào tài khoản của bạn

(3.1) Nhấp vào nút Buy credits ở đầu màn hình. Nếu không thấy, hãy mở rộng menu bên trái và vào Settings > Billing.

(3.2) Thêm địa chỉ và thông tin thẻ tín dụng của bạn để mua credit trị giá 5 USD.

(3.3) Sau khi giao dịch hoàn tất, bạn sẽ thấy số dư tín dụng của mình trên trang Billing.

Bước 4: Cách lấy Claude API key

(4.1) Trong cài đặt tài khoản, nhấp vào API keys.

(4.2) Nhấp vào Create Key.

(4.3) Đặt tên cho API key của bạn. Hướng dẫn này sẽ đặt tên là "Claude API Postman". Nhấp vào Add khi hoàn tất. Tùy chọn: Bạn có thể gán key này cho một không gian làm việc, hữu ích để sắp xếp các key của bạn trên những dự án hoặc trường hợp sử dụng.

(4.4) Sao chép toàn bộ key vào một nơi an toàn - bạn sẽ không thể nhìn thấy nó nữa sau khi đóng cửa sổ pop-up.

(4.5) Sau khi đóng cửa sổ pop-up, bạn sẽ thấy danh sách tất cả các API key đã tạo cho đến nay. Nếu cần, bạn có thể vô hiệu hóa hoặc xóa chúng bằng cách nhấp vào biểu tượng ba chấm ở bên phải.

Bước 5: Mở tài liệu và tài liệu tham khảo API

(5.1) Anthropic có các quy tắc về cách bạn nên thực hiện các cuộc gọi API: Bạn cần tuân theo cấu trúc và hướng dẫn để nhận được kết quả mà không gây ra bất kỳ lỗi nào. Có hai nguồn tài liệu quan trọng mà bạn cần làm quen:

• Tài liệu API, được gọi là User Guides, cung cấp thông tin chung về API, những gì nó có thể làm và cách bạn có thể triển khai nó trong các dự án của mình.
• API Reference là tài liệu tham khảo kỹ thuật giúp bạn thiết lập cuộc gọi, cấu trúc các yêu cầu và xem những phản hồi dự kiến.

(5.2) Hướng dẫn này sẽ yêu cầu một công việc tạo văn bản.

Bước 6: Dán endpoint

(6.1) Để gọi API của Anthropic, chúng ta cần trỏ Postman đến URL của nó: Tài liệu hướng dẫn hiển thị điều này trong phần ví dụ cơ bản.

Sao chép URL endpoint (https://api.anthropic.com/v1/messages).

(6.2) Tùy chọn: Nếu bạn đang làm theo, hãy mở màn hình chính của Postman và viết vào cuộc trò chuyện với trợ lý AI rằng bạn muốn tạo một API mới từ đầu. Tuy nhiên, nếu đang bắt đầu với công cụ của riêng mình, bạn có thể sử dụng ChatGPT để hỗ trợ lập trình hoặc tham khảo tài liệu hướng dẫn về kết nối API của công cụ xây dựng nội bộ hoặc công cụ xây dựng ứng dụng không cần code.

(6.3) Trong màn hình không gian làm việc của Postman, nhấp vào New ở phía trên bên trái.

(6.4) Vẫn trong Postman, chọn HTTP.

(6.5) Cuối cùng, dán URL vào trường nhập của yêu cầu. Nền tảng có thể đề xuất thiết lập nhanh cho API Anthropic, nhưng bạn nên bỏ qua bước này: Làm theo cách chậm rãi ngay bây giờ sẽ giúp bạn hiểu cách hoạt động của nó nhanh hơn.

Bước 7: Xử lý xác thực

API sẽ không chấp nhận các yêu cầu nếu không biết ai đang thực hiện chúng. Đó là lý do tại sao chúng ta đã tạo API key được liên kết với tài khoản Claude trước đó: Nó sẽ được sử dụng để xác thực các yêu cầu và lập hóa đơn công việc một cách chính xác. Tài liệu cho biết rằng nó yêu cầu key trong tiêu đề với tham số x-api-key, cùng với anthropic-version và content-type.

(7.1) Trong Postman, nhấp vào tab Headers.

(7.2) Ở cuối danh sách, hãy thêm các tham số sau vào tiêu đề của yêu cầu: x-api-key, anthropic-version và content-type.

(7.3) Điền giá trị của x-api-key bằng API key bạn đã tạo trước đó, anthropic-version bằng 2023-06-01 (hoặc bất kỳ ngày mới nào bạn thấy trong tài liệu Claude API), và content-type bằng application/json.

Bước 8: Thiết lập phương thức HTTP

(8.1) Mở bài viết tham khảo nếu bạn chưa làm. Ở đầu bài viết, hãy chú ý:

• Phương thức HTTP: Trong trường hợp này là POST.
• Và hậu tố URL sau phương thức POST. Các tính năng API khác nhau có thể được cung cấp trong những URL hoặc hậu tố URL khác nhau, vì vậy hãy luôn đảm bảo bạn đang kết nối với endpoint chính xác.

(8.2) Trong Postman, nhấp vào phương thức GET và thay đổi nó thành POST.

Bước 9: Khắc phục sự cố và học hỏi từ những sai lầm

Việc cấu hình một API mới đòi hỏi sự kiên nhẫn và kỹ năng khắc phục sự cố. Gặp khó khăn là điều bình thường: Đừng nản lòng nếu bạn thấy lỗi hoặc nếu hệ thống không hoạt động như mong đợi. Hãy cùng nhau tạo ra một vài lỗi có chủ ý để hiểu cần tìm kiếm điều gì khi mọi thứ không ổn - và làm thế nào để quay lại đúng hướng.

(9.1) Trong Postman, nhấp vào nút Send.

(9.2) Phản hồi xuất hiện ở cuối giao diện yêu cầu. API Anthropic trả về lỗi HTTP 400 Bad Request, cùng với thông báo rằng nó không chấp nhận phần thân yêu cầu trống. API nói đúng: Chúng ta chỉ mới thiết lập endpoint và tiêu đề ủy quyền, nhưng chưa thiết lập phần thân.

Việc đọc và hiểu các lỗi là rất quan trọng để xây dựng các cuộc gọi API thành công. Nếu có bất kỳ điều gì bị lỗi:

• Kiểm tra tất cả cú pháp. Một lỗi nhỏ, chẳng hạn như dấu phẩy hoặc dấu ngoặc thừa/thiếu, có thể dễ dàng làm hỏng yêu cầu.
• Hãy quay lại tài liệu API để tìm hiểu các yêu cầu cho lệnh gọi mà bạn đang cấu hình.
• Hãy chắc chắn kiểm tra từng lệnh gọi khi bạn thực hiện dù chỉ là thay đổi nhỏ, để bạn có thể dễ dàng phát hiện ra nguyên nhân gây ra sự cố khi tiếp tục.

Bước 10: Thiết lập phần thân yêu cầu

(10.1) Hãy quay lại tài liệu tham khảo API để tạo tin nhắn. Hãy xem hộp bên phải phần giới thiệu.

Yêu cầu này bao gồm lệnh cURL dành cho những người sử dụng dòng lệnh để tương tác với API. Chúng ta sẽ không cần đến nó vì chúng ta đang sử dụng Postman. Tuy nhiên, đây là ý nghĩa của từng phần:

curl <https://api.anthropic.com/v1/messages> \\

Lệnh cURL cho hệ thống biết cần liên hệ với URL endpoint. Dấu gạch chéo ngược ở cuối là dấu xuống dòng cho cURL, được sử dụng để cải thiện khả năng đọc - chúng không có tác dụng gì khác.

-header "x-api-key: $ANTHROPIC_API_KEY" \\

-header "anthropic-version: 2023-06-01" \\

-header "content-type: application/json" \\

Yêu cầu truyền 3 tiêu đề:

• "x-api-key": Theo sau là API key của bạn để xác thực. Chúng ta đã cấu hình điều này trong Postman.
• "anthropic-version: 2023-06-01" cho biết phiên bản hệ thống phù hợp.
• "content-type: application/json" thiết lập kiểu nội dung của phần thân yêu cầu để hệ thống biết cách xử lý.

Mọi thứ sau flag -d là dữ liệu của yêu cầu, còn được gọi là phần thân hoặc payload.

-d '{

"max_tokens": 1024,

"messages": [

{

"content": "Hello, world",

"role": "user"

}

],

"model": "claude-sonnet-4-5-20250929"

}'

• "max_tokens": 1024, thiết lập độ dài đầu ra tối đa cho mỗi phản hồi AI. Trong trường hợp này, nó sẽ không vượt quá khoảng 1024 token (khoảng 768 từ).
• "messages": Chứa loại tin nhắn cùng với nội dung.
• "role": "user" gắn nhãn loại tin nhắn này là prompt người dùng tiêu chuẩn.
• "content": "Hello, world" là nội dung thực tế của tin nhắn người dùng.
• "model": "claude-sonnet-4-5-20250929", trỏ đến mô hình bạn muốn gọi. Trong trường hợp này, nó được đặt thành Claude Sonnet 4.5, phiên bản ngày 29 tháng 9.

(10.2) Sao chép toàn bộ ví dụ JSON trong phần thân yêu cầu mà không có flag -d hoặc dấu ngoặc đơn ở đầu hoặc cuối.

(10.3) Quay lại Postman, nhấp vào Body rồi chọn raw bên dưới trường nhập endpoint. Sau đó, nhấp vào dòng 1 và dán phần thân yêu cầu vào đó.

Bước 11: Gọi mô hình AI

(11.1) Nhấp vào nút Send và xem điều gì xảy ra.

(11.2) Nếu đã làm theo tất cả các hướng dẫn cho đến nay, bạn sẽ nhận được mã trạng thái HTTP 200 OK, cùng với phản hồi từ Claude, cả hai đều được đánh dấu trong hình bên dưới.

Bước 12: Truyền các câu hỏi của bạn

Cuộc gọi API đã sẵn sàng, nhưng sẽ không hữu ích nếu chúng ta chỉ gửi "Hello, world". Hãy cùng tìm hiểu cách thay đổi cả câu hỏi chúng ta gửi đến Claude và các hướng dẫn hệ thống kiểm soát cách nó phản hồi.

(12.1) Trong Postman, hãy thay đổi văn bản của key nội dung thành một nội dung khác, chẳng hạn như "Mô tả món tráng miệng hoàn hảo trong một đoạn văn". Chỉ thay đổi văn bản trong dấu ngoặc kép và giữ nguyên cú pháp còn lại.

(12.2) Claude phản hồi câu hỏi trong phần bên dưới.

(12.3) Hãy mở rộng lệnh gọi API với các chỉ dẫn hệ thống, cho mô hình biết cách nó nên diễn giải những prompt của người dùng. Tiếp tục đọc bài viết tham khảo API, tập trung vào phần tham số thân yêu cầu cho đến khi bạn tìm thấy tham số hệ thống. Nhấp vào hàng để mở rộng.

Snippet này chứa thông tin quan trọng:

• "system" là tên của tham số. Tham số này là tùy chọn: API sẽ không trả về lỗi nếu nó không có, nhưng nếu chúng ta thêm nó vào, chúng ta có thể tùy chỉnh đầu ra với nó.
• Nó chấp nhận một chuỗi, nghĩa là giá trị được chấp nhận có thể là bất kỳ sự kết hợp nào của văn bản, chữ cái hoặc ký tự được đặt trong dấu ngoặc kép.
• Văn bản mô tả cho thấy cách tham số này hoạt động. Trong trường hợp này, có toàn bộ hướng dẫn về prompt hệ thống. (Lưu ý: Các ví dụ trên trang đó được cấu trúc bằng Python, không phải JSON. Nếu bạn không thể đoán được cú pháp chính xác, hãy dán ví dụ vào ChatGPT và yêu cầu tạo lại nó thành nội dung JSON.)

(12.4) Trong Postman, hãy thêm tham số sau vào mục max_tokens:

"system": "Luôn trả lời prompt của người dùng bằng một câu hỏi, không phải một lời giải thích.",

Bạn có thể thay thế văn bản được in đậm ở đây bằng hướng dẫn hệ thống của mình. Hãy chắc chắn kiểm tra cú pháp: Dòng phải kết thúc bằng dấu phẩy sau dấu ngoặc kép đóng.

(12.5) Nhấp vào Send.

(12.6) Nội dung câu trả lời của Claude thay đổi ngay sau khi chúng ta đưa ra các hướng dẫn hệ thống, ngay cả khi sử dụng cùng một prompt người dùng.

Bước 13: Tùy chỉnh phản hồi

Thêm các tham số khác vào lệnh gọi để tùy chỉnh phản hồi tuân theo quy trình tương tự như bước trước.

(13.1) Tìm hiểu thêm về tham số nhiệt độ trong trang tham khảo API tạo tin nhắn.

(13.2) Thêm nhiệt độ vào lệnh gọi API, ngay bên dưới hệ thống. Nhớ đặt tên tham số trong dấu ngoặc kép, nhưng không làm tương tự với số. Kết thúc dòng bằng dấu phẩy.

Ví dụ: "temperature": 1,

(13.3) Nhấp vào nút Send một vài lần để xem phản hồi thay đổi như thế nào với cài đặt nhiệt độ tối đa.

Bước 14: Thiết kế các tính năng mới với Claude API

Sử dụng Postman rất tốt để thử nghiệm những gì API có thể làm và xây dựng các lệnh gọi sẵn sàng để tích hợp vào ứng dụng của bạn. Bạn có thể tiếp tục thử nghiệm bằng cách thêm nhiều tham số thân yêu cầu, điều chỉnh giá trị và khám phá các phản hồi bạn nhận được.

Theo thời gian, bạn sẽ thấy rằng lệnh gọi API mà mình đang làm việc là giải pháp hoàn hảo cho trường hợp sử dụng của bạn - ví dụ, nó viết một phản hồi tốt cho một tin nhắn email mà bạn truyền làm đầu vào. Khi điều đó xảy ra, hãy lưu lệnh gọi trong Postman, tạo một lệnh gọi mới và tiếp tục làm việc với vấn đề tiếp theo.

Trong khi Postman đóng vai trò là nền tảng để thiết kế lệnh gọi trước khi tích hợp, thì Claude Workbench tốt hơn để làm việc trên kỹ thuật nhanh chóng và tối ưu hóa đầu ra. Giao diện người dùng hiển thị trực quan các điều khiển cốt lõi của API, vì vậy bạn có thể tập trung vào cách những phản hồi thay đổi khi bạn điều chỉnh các cài đặt. Nó cũng bao gồm các công cụ đánh giá giúp bạn đánh giá mức độ hiệu quả của kết quả đầu ra trong việc giải quyết một nhiệm vụ, rất hữu ích để bạn có thể tự tin ra mắt một tính năng mới.

Bước 15: Từ thử nghiệm đến sản xuất: Tích hợp Claude vào ứng dụng của bạn

Sau khi bạn đã thiết lập tất cả các lệnh gọi API và prompt theo ý muốn, đã đến lúc tích hợp chúng vào ứng dụng hoặc công cụ nội bộ của bạn. Điều này sẽ cho phép bạn:

• Truyền các giá trị động thông qua các biến. Bạn có thể xây dựng giao diện người dùng để thay thế bất kỳ giá trị nào của lệnh gọi API, chẳng hạn như thay đổi prompt người dùng, hướng dẫn hệ thống hoặc nhiệt độ.
• Liên kết các lệnh gọi API với những nút, thao tác cơ sở dữ liệu, các phần tử trực quan hoặc với những trình kích hoạt như "khi một trang được load". Đây là phần dễ thấy nhất của việc tích hợp Claude API vào ứng dụng của bạn, vì bạn sẽ có thể thấy thông tin do Claude tạo ra bên trong giao diện người dùng mà bạn đã xây dựng.

Để hoàn tất quá trình tích hợp này, hãy tham khảo tài liệu của nền tảng không cần code/chỉ phải code ít hoặc công cụ xây dựng nội bộ của bạn. Chúng thường có các trình kết nối API bên ngoài mà bạn có thể sử dụng để thực hiện các lệnh gọi từ bên trong nền tảng.

Tăng cường sức mạnh cho ứng dụng của bạn với Claude API

Việc thiết lập cuộc gọi API đầu tiên đòi hỏi sự kiên nhẫn và kiên trì, nhưng nó sẽ nhanh chóng trở nên quen thuộc khi bạn nắm vững những điều cơ bản. Sau khi vượt qua giai đoạn học hỏi ban đầu, bạn sẽ có cảm nhận trực quan về cách các giá trị tham số thay đổi phản hồi và cách bạn có thể tích hợp chúng vào sản phẩm hoặc công cụ của mình.