เรียกใช้ Claude API ด้วย Python อย่างไร? พร้อมตัวอย่างโค้ดเริ่มต้น

เรียกใช้ Claude API ด้วย Python ได้ผ่าน SDK ทางการของ Anthropic โดยติดตั้งแพ็กเกจ กำหนด API Key เป็นตัวแปรสภาพแวดล้อม แล้วส่งข้อความผ่าน Messages API ผู้ใช้ ComSiam สามารถเริ่มจากตัวอย่างสั้น ๆ นี้ก่อนนำไปต่อยอดในแอป

เตรียม Python และติดตั้ง SDK

① ตรวจเวอร์ชัน Python
SDK ทางการรุ่นปัจจุบันต้องใช้ Python 3.10 ขึ้นไป ตรวจเวอร์ชันด้วยคำสั่ง:

python --version

② ติดตั้งแพ็กเกจ Anthropic
ติดตั้ง SDK ด้วย pip:

pip install anthropic

หากใช้ Virtual Environment ให้เปิดใช้งานสภาพแวดล้อมของโปรเจกต์ก่อนติดตั้ง เพื่อแยกแพ็กเกจออกจาก Python ส่วนกลางของเครื่อง

③ กำหนด API Key เป็นตัวแปรสภาพแวดล้อม
บน macOS หรือ Linux ตั้งค่าใน Terminal ด้วยคำสั่ง:

export ANTHROPIC_API_KEY="ใส่คีย์ของคุณ"

บน Windows PowerShell ใช้:

$env:ANTHROPIC_API_KEY="ใส่คีย์ของคุณ"

ให้ใส่คีย์จริงในเครื่องของคุณเท่านั้น อย่านำคีย์ไปใส่ในไฟล์ Python ที่แชร์หรือ Commit ขึ้น Repository

ตัวอย่าง Python เรียก Claude API

สร้างไฟล์ เช่น ask_claude.py แล้วใส่โค้ดนี้:

from anthropic import Anthropic

client = Anthropic()

message = client.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=512,
    messages=[
        {
            "role": "user",
            "content": "ช่วยอธิบายความหมายของ API แบบเข้าใจง่าย"
        }
    ],
)

for block in message.content:
    if block.type == "text":
        print(block.text)

จากนั้นรันไฟล์:

python ask_claude.py

SDK อ่านค่า ANTHROPIC_API_KEY จากตัวแปรสภาพแวดล้อมโดยอัตโนมัติ ส่วน model ระบุโมเดลที่ต้องการใช้ และ max_tokens กำหนดจำนวนโทเคนสูงสุดของคำตอบ

ชื่อโมเดลในตัวอย่างเป็นเพียงตัวอย่างหนึ่ง ควรตรวจชื่อโมเดลที่บัญชีและ API รองรับในปัจจุบันก่อนนำไปใช้ เพราะรายการโมเดลอาจเปลี่ยนได้

ถ้าเรียก API แล้วเกิดข้อผิดพลาด

• แจ้งว่าไม่มี API Key: ตรวจว่าตั้งค่า ANTHROPIC_API_KEY ใน Terminal หรือสภาพแวดล้อมที่รัน Python แล้ว
• แจ้งว่าโมเดลไม่ถูกต้อง: ตรวจชื่อโมเดลและสิทธิ์ใช้งานของบัญชี
• แจ้งว่าเครดิตหรือสิทธิ์ไม่พอ: ตรวจการตั้งค่าการใช้งาน API ใน Claude Console
• เชื่อมต่อไม่ได้หรือคำขอถูกจำกัด: ตรวจการเชื่อมต่อและรายละเอียด Error ก่อนลองใหม่ อย่าส่งคำขอซ้ำถี่ ๆ โดยไม่จัดการสาเหตุ

ผู้ใช้ ComSiam ควรหลีกเลี่ยงการพิมพ์ API Key ลงในไฟล์โค้ดหรือส่งในแชตและบันทึกหน้าจอ หากคีย์ถูกเปิดเผย ให้เพิกถอนและสร้างคีย์ใหม่ใน Console

สรุป

เริ่มเรียก Claude API ด้วย Python โดยติดตั้งแพ็กเกจ anthropic ตั้ง API Key เป็นตัวแปรสภาพแวดล้อม แล้วใช้ client.messages.create() ส่งข้อความและอ่านคำตอบจาก message.content ตรวจเวอร์ชัน Python ชื่อโมเดล และสิทธิ์การใช้งานก่อนนำโค้ดไปต่อยอดจริง