วิธีรับ Anthropic API Key และสร้างคำขอแรกกับ Claude

คีย์ API ของ Anthropic คือข้อมูลรับรองที่คุณส่งไปพร้อมกับทุกคำขอไปยัง Claude API โดยขึ้นต้นด้วย sk-ant- คุณสร้างมันใน Claude Console และจะเรียกเก็บค่าการใช้งานจากเครดิตแบบเติมเงินขององค์กรคุณ หากคุณไม่เคยใช้งานมาก่อน บทนำของเราเกี่ยวกับ คีย์ API คืออะไร จะอธิบายแนวคิดทั่วไป คู่มือนี้ครอบคลุมประเด็นเฉพาะ: การสร้างบัญชี Console, การเติมเครดิต, การสร้างคีย์ด้วยขอบเขตที่ถูกต้อง, การส่งคำขอ Messages ครั้งแรกด้วย curl และ Python SDK และการดูแลรักษาคีย์ไม่ให้เกิดปัญหาในภายหลัง

หน้า รับคีย์ API ของคุณ อย่างเป็นทางการของ Anthropic จะบอกคุณว่าปุ่มอยู่ที่ไหน แต่ไม่ได้บอกว่าทำไมคำขอแรกจึงคืนค่า 401, รหัสโมเดลใดที่เป็นปัจจุบัน หรือวิธีทดสอบคีย์โดยไม่ต้องวางลงในประวัติเชลล์ของคุณ นั่นคือสิ่งที่เหลือของคู่มือนี้จะกล่าวถึง

สิ่งที่คุณต้องมีก่อนเริ่มต้น

• อีเมลสำหรับ Claude Console ที่ platform.claude.com (ตอนนี้ console.anthropic.com จะเปลี่ยนเส้นทางไปที่นั่น)

• บัตรชำระเงิน API เป็นแบบเติมเงิน และเฉพาะผู้ดูแลระบบ (Admin) หรือบทบาทการเรียกเก็บเงิน (Billing) เท่านั้นที่สามารถซื้อเครดิตได้
• curl หรือ Python 3.10+ สำหรับตัวอย่าง SDK
• Apidog สำหรับจัดเก็บคีย์เป็นตัวแปรโลคอลและบันทึกคำขอเพื่อการทดสอบซ้ำ แผนฟรีรองรับทีมได้สูงสุดสี่คน

ขั้นตอนที่ 1: สร้างบัญชี Claude Console

ลงทะเบียนที่ platform.claude.com การดำเนินการนี้จะสร้างองค์กรพร้อม Default Workspace และคีย์ เครดิต และขีดจำกัดอัตราของคุณจะผูกอยู่กับองค์กรนั้น หากเพื่อนร่วมทีมสร้างไปแล้ว ให้ขอคำเชิญแทนที่จะสร้างองค์กรที่สอง: เครดิตและระดับการใช้งานจะไม่สามารถโอนย้ายได้

ขั้นตอนที่ 2: เพิ่มเครดิตก่อนการเรียกใช้ครั้งแรกของคุณ

ใช่ เครดิตต้องมาก่อน เอกสารการเรียกเก็บเงินของ Anthropic ชัดเจน: ซื้อเครดิตก่อนใช้งาน API และเมื่อยอดเงินเป็นศูนย์ ทั้ง API และ playground จะใช้งานไม่ได้ ผู้ใช้ใหม่จะได้รับเครดิตฟรีจำนวนเล็กน้อยเพื่อทดลองใช้ ดังนั้นให้ตรวจสอบยอดเงินของคุณก่อนซื้อ แต่ให้ถือว่านี่เป็นโบนัสมากกว่าแผนการ

เปิด Settings > Billing และคลิก Buy credits เปิดใช้งานการโหลดอัตโนมัติ (auto-reload) หากคุณรันสิ่งใดโดยไม่มีคนดูแล ดู วิธีซื้อเครดิต สำหรับขั้นตอนปัจจุบัน องค์กรของคุณยังจะอยู่ในระดับการใช้งานที่มีวงเงินค่าใช้จ่ายรายเดือน ซึ่งครอบคลุมอยู่ในส่วนขีดจำกัดอัตรา

ขั้นตอนที่ 3: สร้างคีย์ API

ไปที่ Settings > API keys และคลิก Create key มีตัวเลือกสี่ข้อที่สำคัญ:

• Name: ตั้งชื่อตามแอปพลิเคชัน ไม่ใช่บุคคล เช่น orders-service-staging ดีกว่า my key
• Expiration: 3 ชั่วโมงถึง 30 วัน, กำหนดเอง, หรือไม่หมดอายุ เลือกอายุสั้นๆ สำหรับการทดสอบ; ไม่สามารถเปลี่ยนแปลงได้ในภายหลัง
• Linked account: ตัวคุณเองสำหรับคีย์ส่วนบุคคล, บัญชีบริการสำหรับสิ่งที่ใช้ร่วมกัน คีย์ส่วนบุคคลจะหมดอายุเมื่อคุณออกจากองค์กร
• Workspace: กำหนดขอบเขตไปยังพื้นที่ทำงานเดียว คุณสามารถข้ามเฮดเดอร์ anthropic-workspace-id ได้ คีย์หลายพื้นที่ทำงานต้องส่งเฮดเดอร์นี้ในทุกคำขอ มิฉะนั้นคุณจะได้รับ 400

Console จะแสดงคีย์เต็มเพียงครั้งเดียว ดังนั้นให้คัดลอกไปยังตัวจัดการความลับของคุณโดยตรง ไม่มีปุ่มเปิดเผย หาก Create key เป็นสีเทา บทบาทของคุณไม่สามารถสร้างคีย์ได้ โปรดติดต่อผู้ดูแลระบบ

ขั้นตอนที่ 4: เฮดเดอร์สามตัวที่ทุกคำขอต้องมี

ทุกการเรียกไปยัง POST https://api.anthropic.com/v1/messages จะต้องมีเฮดเดอร์สามตัว

SDK อย่างเป็นทางการจะส่งเฮดเดอร์ทั้งสามตัวนี้ให้คุณเอง ส่วน HTTP ดิบและไคลเอ็นต์ API ต้องระบุให้ครบถ้วน ซึ่งเป็นที่มาของความล้มเหลวในการร้องขอครั้งแรกส่วนใหญ่ การอ้างอิงฉบับเต็ม: ภาพรวม Claude API

ขั้นตอนที่ 5: ส่งคำขอ Messages ครั้งแรกของคุณ

ส่วนเนื้อหาจำเป็นต้องมี model, max_tokens และ messages ใช้รหัสโมเดลปัจจุบัน: ณ เดือนกันยายน 2026 คือ claude-opus-5 (ที่แนะนำเป็นค่าเริ่มต้น), claude-fable-5-1 (มีความสามารถสูงสุด), claude-sonnet-5 และ claude-haiku-4-5 รหัส 3.x และ 4.x ที่เก่ากว่าจะคืนค่า 404 หรือชี้ไปยังโมเดลที่เลิกใช้งานแล้ว และรหัสปัจจุบันไม่มีคำต่อท้ายวันที่ บทแนะนำ Claude Opus 5 API จะเจาะลึกเพิ่มเติมเกี่ยวกับการคิด, ความพยายาม, และการสตรีม

curl

export ANTHROPIC_API_KEY="sk-ant-api03-..."

curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-opus-5",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "Write a one-sentence OpenAPI description for POST /orders, which creates an order and returns 201."}
    ]
  }'

การตอบสนองที่สำเร็จ (ตัดทอน):

{
  "id": "msg_01...",
  "role": "assistant",
  "model": "claude-opus-5",
  "content": [{"type": "text", "text": "Creates a new order and returns it with a 201 status."}],
  "stop_reason": "end_turn",
  "usage": {"input_tokens": 31, "output_tokens": 24}
}

อ่านข้อความจาก content[].text, ตรวจสอบว่า stop_reason เป็น end_turn และเก็บ usage ไว้สำหรับการติดตามค่าใช้จ่าย เฮดเดอร์การตอบกลับ request-id คือสิ่งที่ฝ่ายสนับสนุนจะขอเมื่อมีสิ่งผิดพลาดเกิดขึ้น

Python SDK

pip install anthropic

import anthropic

client = anthropic.Anthropic()  # reads ANTHROPIC_API_KEY from the environment

message = client.messages.create(
    model="claude-opus-5",
    max_tokens=1024,
    messages=[{
        "role": "user",
        "content": "Write a one-sentence OpenAPI description for POST /orders, which creates an order and returns 201.",
    }],
)

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

SDK จะอ่าน ANTHROPIC_API_KEY, เพิ่มเฮดเดอร์เวอร์ชันและ content-type และลองใหม่สำหรับ 429 และ 5xx สองครั้งพร้อม backoff อย่าส่งคีย์เป็นสตริงตัวอักษรโดยตรง (string literal); การใช้ตัวแปรสภาพแวดล้อมคือจุดประสงค์หลัก

ขั้นตอนที่ 6: จัดเก็บและทดสอบคีย์ใน Apidog

คีย์ที่วางลงในเชลล์จะอยู่ในไฟล์ประวัติของคุณ คีย์ที่จัดเก็บในคำขอที่แชร์จะซิงค์กับเพื่อนร่วมทีม Apidog แยกสองสิ่งนี้ออกจากกัน: โครงสร้างคำขอถูกแชร์ แต่ความลับยังคงอยู่ในเครื่องของคุณ

จัดเก็บคีย์เป็นตัวแปรโลคอล เปิด Environment Management สร้างสภาพแวดล้อมชื่อ Anthropic และเพิ่มตัวแปร ANTHROPIC_API_KEY ปล่อยให้ค่าที่แชร์เป็น SET_LOCALLY และวางคีย์จริงลงในค่าโลคอล ซึ่งจะอยู่ในแคชของไคลเอ็นต์ของคุณและไม่ซิงค์ คู่มือของเราเกี่ยวกับ Apidog environments and secret variables ครอบคลุมกฎขอบเขต

ตั้งค่าเฮดเดอร์เพียงครั้งเดียว ในแผงเดียวกัน เพิ่มพารามิเตอร์ส่วนกลางสองตัวภายใต้ Headers: x-api-key ตั้งค่าเป็น {{ANTHROPIC_API_KEY}} และ anthropic-version ตั้งค่าเป็น 2023-06-01 สิ่งเหล่านี้จะถูกนำไปใช้กับทุกคำขอในโปรเจกต์ และ Apidog จะเพิ่ม content-type โดยอัตโนมัติสำหรับส่วนเนื้อหา JSON

ส่งคำขอแรก คำขอใหม่ POST ไปยัง https://api.anthropic.com/v1/messages วางส่วนเนื้อหา JSON จากตัวอย่าง curl แล้วส่ง เปิดแท็บ Actual Request เพื่อยืนยันว่าเฮดเดอร์ทั้งสองถูกส่งออกไปพร้อมกับการแก้ตัวแปร แท็บนั้นเป็นวิธีที่เร็วที่สุดในการพิสูจน์ว่า 401 เป็นปัญหาเฮดเดอร์ ไม่ใช่ปัญหาคีย์

บันทึกเป็นชุดทดสอบ บันทึกคำขอเป็นกรณีของ endpoint จากนั้นเพิ่มการยืนยันสามอย่าง: สถานะเท่ากับ 200, stop_reason เท่ากับ end_turn และ usage.output_tokens มากกว่า 0 เรียกใช้จาก Apidog CLI และแทรกคีย์จากที่เก็บความลับ CI ของคุณในขณะรันไทม์ นั่นคือการทดสอบแบบ smoke test เพียงคลิกเดียวสำหรับคีย์ เฮดเดอร์ และรหัสโมเดล ดาวน์โหลด Apidog เพื่อทำตาม; แผนฟรีรวมสี่ที่นั่ง

ขีดจำกัดอัตราและค่าใช้จ่ายของคำขอ

ขีดจำกัดจะแตกต่างกันไปตามองค์กรและโมเดล: คำขอต่อนาที (RPM), โทเค็นอินพุตต่อนาที (ITPM) และโทเค็นเอาต์พุตต่อนาที (OTPM) เฉพาะอินพุตที่ไม่ได้แคชเท่านั้นที่จะนับรวมใน ITPM ดังนั้นการแคชพรอมต์จึงเพิ่มปริมาณงานโดยไม่ต้องเปลี่ยนระดับ จาก เอกสารขีดจำกัดอัตรา:

Sonnet 5 และ Haiku 4.5 มีตัวเลขเดียวกับ Opus 5 ในแต่ละระดับ ทุกการตอบกลับจะมีเฮดเดอร์ anthropic-ratelimit-*-remaining และ -reset เพื่อให้คุณสามารถตรวจสอบขีดจำกัดได้โดยไม่ต้องสอบถาม Console

ต่อหนึ่งล้านโทเค็น จาก หน้าการกำหนดราคา: Opus 5 อยู่ที่ $5 อินพุต / $25 เอาต์พุต, Sonnet 5 $2 / $10, Fable 5.1 $10 / $50, Haiku 4.5 $1 / $5 การอ่านแคชมีค่าใช้จ่าย 10% ของอินพุต (2.5% สำหรับ Fable 5.1) และ Batch API ลดลงครึ่งหนึ่งทั้งสองฝั่ง คำขอ curl ครั้งแรกมีค่าใช้จ่ายเพียงเสี้ยวหนึ่งของเซ็นต์

ข้อผิดพลาดทั่วไปและวิธีแก้ไข

ข้อผิดพลาดจะถูกส่งกลับมาเป็น JSON พร้อม error.type และ request_id การอ้างอิงข้อผิดพลาด จะแสดงรหัสทั้งหมด; เหล่านี้คือสิ่งที่คุณจะพบเป็นอันดับแรก

การดูแลคีย์: การหมุนเวียน, การกำหนดขอบเขต และไม่เคยอยู่ในโค้ดไคลเอ็นต์

ห้ามส่งคีย์ไปยังเบราว์เซอร์หรือแอปมือถือโดยเด็ดขาด สิ่งใดก็ตามในชุด JavaScript หรือ APK จะเป็นสาธารณะภายในไม่กี่นาที ให้เรียกใช้ผ่านแบ็กเอนด์ของคุณเอง สำหรับแอป Apple ที่ต้องเรียกใช้ Claude โดยตรง App Attest จะออกโทเค็นชั่วคราวให้กับการบิลด์ที่ได้รับการยืนยันแทนที่จะเป็นคีย์แบบคงที่

หนึ่งคีย์ต่อหนึ่งแอปและสภาพแวดล้อม แยกคีย์สำหรับ staging และ production ในพื้นที่ทำงานที่แยกจากกัน เพื่อให้คุณสามารถจำกัดค่าใช้จ่าย staging และเพิกถอนคีย์หนึ่งได้โดยไม่กระทบอีกคีย์หนึ่ง

หมุนเวียนตามกำหนดเวลา สร้างคีย์ใหม่, deploy, ยืนยันว่าใช้งานได้, แล้วจึงลบคีย์เก่า Disable สามารถย้อนกลับได้; Delete เป็นการลบถาวร หากสงสัยว่ามีการรั่วไหล ให้ disable ก่อนแล้วค่อยตรวจสอบ เครื่องสแกนความลับใน repo ของคุณ จะตรวจจับคีย์ที่ commit ไว้ก่อนใครจะสังเกตเห็น

นิยมใช้ข้อมูลรับรองที่มีอายุสั้นใน production Workload Identity Federation จะแลกเปลี่ยนโทเค็นยืนยันตัวตนของผู้ให้บริการคลาวด์ของคุณกับโทเค็น Claude ที่มีอายุสั้น ดังนั้นจึงไม่มีสตริง sk-ant- ที่จะรั่วไหลเลย

คำถามที่พบบ่อย

คีย์ API ของ Anthropic เหมือนกับคีย์ API ของ Claude หรือไม่?

ใช่ Console, SDKs และเอกสารตอนนี้ใช้คำว่า “Claude API” และรูปแบบคีย์กับเฮดเดอร์ก็เหมือนกัน บทช่วยสอนเก่าๆ ที่ใช้คำว่า “Anthropic API key” หมายถึงข้อมูลรับรองเดียวกัน

ฉันสามารถรับคีย์ API ของ Anthropic ได้ฟรีหรือไม่?

การสร้างคีย์นั้นฟรี การใช้งานจะดึงจากเครดิตแบบเติมเงิน และหน้าการกำหนดราคาของ Anthropic ระบุว่าผู้ใช้ใหม่จะได้รับเครดิตฟรีจำนวนเล็กน้อยเพื่อทดลองใช้ หากคุณกำลังพยายามรันงานจริงโดยไม่ต้องจ่ายเงิน โปรดอ่านบทวิเคราะห์ที่ซื่อตรงของเราเกี่ยวกับ การเข้าถึง Claude API ฟรี ก่อนที่คุณจะสร้างอะไรโดยอิงจากมัน

การสมัครสมาชิก Claude Pro หรือ Max รวมถึงการเข้าถึง API หรือไม่?

ไม่ การสมัครสมาชิก Claude.ai และเครดิต API ของ Console จะถูกเรียกเก็บแยกกัน คุณต้องมีองค์กร Console พร้อมเครดิต แม้ว่าคุณจะชำระเงินสำหรับ Claude.ai อยู่แล้วก็ตาม

จะเกิดอะไรขึ้นเมื่อคีย์ของฉันหมดอายุ?

คำขอจะส่งคืน 401 authentication_error คีย์ที่หมดอายุไม่สามารถเปิดใช้งานใหม่ได้ ดังนั้นให้สร้างใหม่และอัปเดตตัวแปรสภาพแวดล้อม Anthropic จะส่งอีเมลถึงผู้สร้างคีย์เจ็ดวันและหนึ่งวันก่อนหมดอายุสำหรับคีย์ที่มีอายุการใช้งานนานพอ

ขั้นตอนต่อไป

สร้างคีย์ที่มีวันหมดอายุ 7 วัน ใส่ไว้ในตัวแปรโลคอลของ Apidog รัน smoke test จากนั้นจึงนำไปใช้ในโค้ด หากผ่าน แสดงว่าข้อมูลรับรอง เฮดเดอร์ และรหัสโมเดลถูกต้องทั้งหมด และ 401 ที่ตามมาหลังจากนั้นจะเป็นปัญหาจริงไม่ใช่แค่การพิมพ์ผิด