คีย์ Perplexity API คือข้อมูลประจำตัวที่คุณส่งไปพร้อมกับทุกคำขอไปยัง api.perplexity.ai. มันใช้ระบุโปรเจกต์ของคุณ, หักยอดเครดิตที่เติมไว้ล่วงหน้า, และกำหนดระดับการจำกัดอัตรา (rate limit tier) ของคุณ. หากคุณไม่เคยจัดการคีย์ API มาก่อน, บทความเบื้องต้นของเราเกี่ยวกับ API key คืออะไร จะอธิบายพื้นฐานให้ทราบ. คู่มือนี้จะครอบคลุมส่วนที่เฉพาะเจาะจงของ Perplexity: การสร้างบัญชี, การเพิ่มเครดิต, การสร้างคีย์, และการส่งคำขอ Sonar ที่มีข้อมูลอ้างอิงครั้งแรกจาก curl, Python, และ Apidog.
ข้อควรทราบเรื่องกำหนดเวลาก่อนที่คุณจะเริ่ม. Perplexity ได้ย้าย Sonar ไปยัง Agent API และ คู่มือเริ่มต้นใช้งานฉบับทางการ ตอนนี้ชี้ไปที่นั่นแล้ว. Endpoint Sonar chat-completions แบบเก่าจะยังคงใช้งานได้จนถึงวันที่ 27 กันยายน 2026 แล้วจะถูกยกเลิก. ตัวอย่างด้านล่างนี้ทั้งหมดใช้ endpoint ปัจจุบัน พร้อมข้อสังเกตสั้นๆ เกี่ยวกับรูปแบบเดิมในกรณีที่คุณกำลังดูแลโค้ดเก่า.
สิ่งที่คุณต้องมีก่อนเริ่มต้น
- บัญชี Perplexity. สามารถใช้ Google, Apple, SSO หรือการเข้าสู่ระบบด้วยอีเมลแบบไร้รหัสผ่านได้ทั้งหมด และจะเชื่อมโยงไปยังบัญชีเดียวกันด้วยที่อยู่อีเมล.
- บัตรชำระเงิน. API เป็นแบบจ่ายตามการใช้งานจริง (pay-as-you-go) โดยไม่มีค่าสมัครสมาชิก แต่คำขอจะล้มเหลวเมื่อยอดเครดิตของคุณเป็นศูนย์.
- curl หรือ Python 3.9+ สำหรับคำขอแรก.
- Apidog หากคุณต้องการเก็บคีย์เป็นข้อมูลลับภายในเครื่อง และบันทึกคำขอเป็นการทดสอบที่สามารถทำซ้ำได้.
ขั้นตอนที่ 1: ลงชื่อเข้าใช้ API console และสร้างโปรเจกต์
ไปที่ console.perplexity.ai และเลือกวิธีการลงชื่อเข้าใช้. การลงชื่อเข้าใช้จะสร้างบัญชี Perplexity แต่ไม่ใช่โปรเจกต์ API. ในการเข้าชมครั้งแรก วิซาร์ดการตั้งค่าจะแจ้งให้คุณสร้างหรือเข้าร่วมโปรเจกต์ก่อนที่คุณจะสามารถสร้างคีย์ได้ เนื่องจากคีย์จะถูกจำกัดขอบเขตตามโปรเจกต์.
เปิด Settings ในแถบด้านข้างซ้าย และกรอกชื่อองค์กร, ที่อยู่, และรายละเอียดภาษีของคุณ; ข้อมูลเหล่านี้จะปรากฏในใบแจ้งหนี้ของคุณ. หากบริษัทของคุณมีโปรเจกต์อยู่แล้ว, ให้ขอให้ผู้ดูแลระบบเพิ่มคุณเข้าไปแทนที่จะสร้างโปรเจกต์ที่สอง. โปรเจกต์ที่แยกกันจะมียอดเครดิตและคีย์ที่แยกกัน ซึ่งมีประโยชน์สำหรับการแยกแอปพลิเคชันที่ใช้งานจริงออกจากแอปพลิเคชันทดลอง.
ขั้นตอนที่ 2: เพิ่มวิธีการชำระเงินและเครดิต
เปิด หน้าการเรียกเก็บเงิน และเพิ่มบัตร. ตามเอกสารประกอบ, การเพิ่มวิธีการชำระเงินไม่ได้เป็นการเรียกเก็บเงินจากบัตร; แต่จะเก็บรายละเอียดไว้สำหรับการใช้งานในอนาคต. จากนั้นให้ซื้อเครดิต. ยอดคงเหลือ, รายละเอียดการใช้งานต่อโมเดล, และประวัติใบแจ้งหนี้ทั้งหมดจะอยู่ที่หน้านี้.
มีสองรายละเอียดที่สำคัญที่นี่. API จะเรียกเก็บเงินจากเครดิตที่เติมไว้ล่วงหน้า, และหากยอดคงเหลือหมด คีย์ของคุณจะถูกบล็อกจนกว่าคุณจะเติมเงิน. เอกสารอธิบายว่าความล้มเหลวนั้นเป็น 401 ไม่ใช่ 402, ดังนั้นแอปที่เครดิตหมดอาจดูเหมือนข้อผิดพลาดในการตรวจสอบสิทธิ์เมื่อมองแวบแรก. และถัดจาก Auto reload, ให้คลิก Change preferences เพื่อให้คอนโซลเพิ่มเครดิตโดยอัตโนมัติเมื่อยอดคงเหลือลดลงต่ำกว่าเกณฑ์ที่คุณตั้งไว้. เปิดใช้งานสิ่งนี้ก่อนที่จะนำไปใช้งานจริง.
เอกสารประกอบไม่ได้ระบุจำนวนเงินขั้นต่ำในการซื้อ, ดังนั้นให้ยึดตามสิ่งที่หน้าการเรียกเก็บเงินแสดงให้คุณเห็น. ระดับการใช้งานของคุณ, ซึ่งกำหนดอัตราการจำกัด, อิงตามเครดิตสะสมที่ซื้อตลอดอายุการใช้งานของบัญชี, ไม่ใช่ยอดคงเหลือปัจจุบัน.
ขั้นตอนที่ 3: สร้างคีย์ API
เปิด หน้า API Keys ในคอนโซลและสร้างคีย์. ตั้งชื่อที่สื่อความหมาย เช่น dev-laptop หรือ prod-search-worker. หลังจากสร้างแล้ว, ชื่อจะเป็นวิธีเดียวในการแยกแยะคีย์, เนื่องจากค่าเต็มจะแสดงเพียงครั้งเดียวและไม่สามารถเรียกดูได้อีก. คัดลอกทันที.
ใส่คีย์ในตัวแปรสภาพแวดล้อม, อย่าใส่ในโค้ด:
export PERPLEXITY_API_KEY="pplx-your-key-here"
บน Windows, ใช้ setx PERPLEXITY_API_KEY "pplx-your-key-here" และเปิดเทอร์มินัลใหม่.
คุณสามารถสร้างคีย์ได้หลายคีย์ภายในโปรเจกต์เดียว, ดังนั้นให้สร้างหนึ่งคีย์ต่อสภาพแวดล้อมและต่อบริการ. การเพิกถอนคีย์จะเป็นการถาวร, ซึ่งเป็นสิ่งที่คุณต้องการเมื่อคีย์รั่วไหล. หากคุณไม่แน่ใจว่าคีย์รั่วไหลเข้าไปใน repo แล้วหรือไม่, ให้เรียกใช้ เครื่องสแกนความลับ (secret scanner) บนประวัติ git ของคุณ ก่อนที่จะหมุนเวียนคีย์.
ขั้นตอนที่ 4: ส่งคำขอ Sonar ครั้งแรก
endpoint ปัจจุบันคือ POST https://api.perplexity.ai/v1/agent. การยืนยันตัวตนคือส่วนหัว bearer มาตรฐาน, Authorization: Bearer $PERPLEXITY_API_KEY. เนื้อหา (body) จะรับ model และสตริง input. รหัสโมเดล Sonar บน endpoint นี้คือ perplexity/sonar, และการเพิ่มเครื่องมือ web_search จะบอกให้มันค้นหาเว็บแบบเรียลไทม์และแนบแหล่งที่มา.
ลองถามคำถามที่มีคำตอบจริงที่เปลี่ยนแปลงไปตามกาลเวลา:
curl https://api.perplexity.ai/v1/agent \
-H "Authorization: Bearer $PERPLEXITY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "perplexity/sonar",
"input": "Which Node.js release line is currently Active LTS, and when does it reach end of life?",
"tools": [{ "type": "web_search" }]
}' | jq
ผลตอบกลับจะประกอบด้วย output_text, ซึ่งเป็นคำตอบในรูปแบบข้อความธรรมดา, และอาร์เรย์ output ที่มีหนึ่งรายการต่อขั้นตอนที่โมเดลดำเนินการ. รายการ message จะเก็บคำตอบ; รายการ search_results จะแสดงรายการหน้าที่โมเดลอ่าน, โดยแต่ละรายการจะมี url, title, snippet, และ date. ออบเจกต์ usage จะรายงานจำนวนโทเค็นและค่าใช้จ่าย. status ที่เป็น completed หมายความว่าการทำงานเสร็จสมบูรณ์.
คำขอเดียวกันใน Python ด้วย SDK อย่างเป็นทางการ:
pip install perplexityai
from perplexity import Perplexity
client = Perplexity() # reads PERPLEXITY_API_KEY from the environment
response = client.responses.create(
model="perplexity/sonar",
input="Which Node.js release line is currently Active LTS, and when does it reach end of life?",
tools=[{"type": "web_search"}],
)
print(response.output_text)
หากคุณต้องการใช้ OpenAI SDK, ให้ตั้งค่า base_url="https://api.perplexity.ai/v1" และเรียกใช้ client.responses.create() ด้วยอาร์กิวเมนต์เดียวกัน. SDK จะส่งคำขอไปยัง /v1/responses ซึ่ง Perplexity ยอมรับว่าเป็นชื่อแทน (alias). ค่าพรีเซ็ต (fast, low, medium, high, xhigh) จะรวมโมเดล, งบประมาณโทเค็น, และเครื่องมือต่างๆ ไว้ให้คุณ; ใน OpenAI SDK คุณสามารถส่งค่าเหล่านี้ผ่าน extra_body.
หากคุณใช้รูปแบบ chat-completions แบบเก่า
โค้ดเก่าจะส่ง messages ไปยัง https://api.perplexity.ai/v1/sonar ด้วยรหัสโมเดล sonar, sonar-pro, sonar-reasoning-pro, หรือ sonar-deep-research, และอ่าน choices[0].message.content. รูปแบบนั้นจะใช้งานได้จนถึงวันที่ 27 กันยายน 2026. คู่มือการย้ายระบบ จะจับคู่ sonar กับ perplexity/sonar, sonar-pro กับ perplexity/sonar พร้อมพรีเซ็ต low, และ deep research กับพรีเซ็ต high. ตัวเลือก search_domain_filter และ search_recency_filter จะย้ายไปอยู่ภายในเครื่องมือ web_search ในรูปของออบเจกต์ filters.
ขั้นตอนที่ 5: จัดเก็บคีย์และบันทึกคำขอใน Apidog
คำสั่ง curl ที่ทำงานได้เพียงครั้งเดียวไม่ใช่การทดสอบ. นี่คือการตั้งค่าที่เราใช้ใน Apidog เพื่อให้คีย์ไม่ถูกจัดเก็บบนคลาวด์ และคำขอสามารถรันได้ตามต้องการ.
สร้างสภาพแวดล้อม (environment). เพิ่มสภาพแวดล้อมที่ชื่อว่า Perplexity ด้วยสองตัวแปร: base_url ตั้งค่าเป็น https://api.perplexity.ai เป็นค่าที่ใช้ร่วมกัน (shared value), และ PERPLEXITY_API_KEY โดยปล่อยให้ค่าที่ใช้ร่วมกันเป็นตัวยึด (placeholder) และใช้คีย์จริงใน ค่าภายในเครื่อง (local value) เท่านั้น. ค่าภายในเครื่องจะอยู่ในแคชของไคลเอ็นต์ของคุณและไม่เคยซิงค์กับเพื่อนร่วมทีม, ซึ่งเป็นจุดประสงค์หลัก. คู่มือของเราเกี่ยวกับ สภาพแวดล้อมและตัวแปรลับใน Apidog จะอธิบายเจาะลึกเกี่ยวกับความแตกต่างระหว่างค่าที่ใช้ร่วมกันและค่าภายในเครื่อง.
สร้างคำขอ. คำขอใหม่, POST {{base_url}}/v1/agent. เพิ่มส่วนหัว Authorization: Bearer {{PERPLEXITY_API_KEY}}, ตั้งค่าประเภทเนื้อหา (body type) เป็น JSON, และวางเนื้อหาเดียวกับคำสั่ง curl ด้านบน. เลือกสภาพแวดล้อม Perplexity แล้วคลิก Send (ส่ง). คุณควรจะเห็น output_text และบล็อก search_results ในแผงตอบกลับ.
เปลี่ยนให้เป็นการทดสอบ. เพิ่มเงื่อนไขยืนยัน (assertions) สามข้อ: รหัสสถานะ (status code) คือ 200, $.status เท่ากับ completed, และ $.output_text ไม่ว่างเปล่า. บันทึกคำขอเป็นสถานการณ์การทดสอบ. ตอนนี้ทุกคนในทีมสามารถดึงโปรเจกต์, วางคีย์ของตนเองลงในค่าภายในเครื่อง (local value), และยืนยันการตั้งค่าของพวกเขาได้ด้วยการคลิกเพียงครั้งเดียว. การหมุนเวียนคีย์ (rotating the key) หมายถึงการแก้ไขเพียงช่องเดียว, ไม่ใช่การไล่หาในสคริปต์.
หากคุณยังไม่มี, ดาวน์โหลด Apidog ฟรี; แผนฟรีรองรับผู้ใช้สี่คน, เพียงพอสำหรับทีมเล็กๆ ที่จะแชร์โปรเจกต์.
การจำกัดอัตรา (Rate limits) และค่าใช้จ่ายของคำขอ
การจำกัดอัตราบน Agent API จะปรับตามระดับการใช้งานของคุณ, และระดับถูกกำหนดโดยยอดเครดิตที่ซื้อสะสมตลอดอายุการใช้งาน, ตาม หน้าการจำกัดอัตรา:
| ระดับ | เครดิตที่ซื้อ | คำขอต่อวินาที | คำขอต่อนาที |
|---|---|---|---|
| 0 | $0 | 1 | 50 |
| 1 | $50+ | 3 | 150 |
| 2 | $250+ | 8 | 500 |
| 3 | $500+ | 17 | 1,000 |
| 4 | $1,000+ | 33 | 4,000 |
| 5 | $5,000+ | 33 | 8,000 |
ขีดจำกัดใช้อัลกอริทึมแบบถังรั่ว (leaky-bucket algorithm), ดังนั้นการส่งคำขอช่วงสั้นๆ จนถึงขีดจำกัดจะผ่าน. เมื่อคุณเกินขีดจำกัด API จะคืนค่า 429 พร้อมส่วนหัว Retry-After, และคำขอที่ถูกปฏิเสธจะไม่ถูกเรียกเก็บเงิน. ระดับปัจจุบันของคุณจะแสดงอยู่ในหน้า Pricing ของคอนโซล ภายใต้แท็บ usage tiers.
สำหรับเรื่องราคา, หนึ่งย่อหน้าก็เพียงพอแล้วที่นี่. หน้าการกำหนดราคา แสดงรายการ perplexity/sonar บน Agent API ที่ $0.25 ต่อหนึ่งล้าน input tokens และ $2.50 ต่อหนึ่งล้าน output tokens, บวกกับ $0.0025 ต่อการเรียกใช้ web_search. โมเดล Sonar chat-completions แบบเก่าจะถูกเรียกเก็บเงินแตกต่างกัน: sonar ที่ $1 ต่อหนึ่งล้านโทเค็นขาเข้าและขาออก, บวกกับ $5 ถึง $12 ต่อหนึ่งพันคำขอขึ้นอยู่กับขนาดบริบทการค้นหา. สำหรับรายละเอียดทั้งหมดและมุมมองบัญชี Pro, โปรดดู คู่มือ Perplexity API ของเรา.
ข้อผิดพลาดทั่วไปและวิธีแก้ไข
401 Unauthorized. มีสามสาเหตุ, เรียงตามความน่าจะเป็น: ส่วนหัว (header) ไม่ถูกต้อง (ต้องเป็น Authorization: Bearer <key>, และตัวแปร shell ต้องถูก export ในเทอร์มินัลเดียวกัน), คีย์ถูกเพิกถอน, หรือยอดเครดิตเป็นศูนย์. ตรวจสอบหน้าการเรียกเก็บเงินก่อนที่จะสร้างสิ่งใดใหม่. Python SDK จะแจ้ง AuthenticationError สำหรับกรณีนี้.
400 Bad Request. โดยปกติเกิดจากเนื้อหา (body) ในรูปแบบเก่าที่ส่งไปยัง endpoint ใหม่: messages แทนที่จะเป็น input, หรือรหัสโมเดล sonar-pro ที่ใช้โดยตรงบน /v1/agent. SDK จะแจ้งสิ่งนี้เป็น ValidationError.
404 Not Found. เส้นทาง (path) ไม่ถูกต้อง. /v1/agent คือ Agent API และ /v1/sonar คือ endpoint chat-completions แบบเก่า; เอกสารประกอบไม่ได้ระบุอย่างอื่น.
429 Too Many Requests. คุณใช้เกินขีดจำกัดของระดับของคุณ. อ่านค่า Retry-After, รอนานเท่าที่ระบุ, จากนั้นลองใหม่ด้วย exponential backoff และ jitter. การซื้อเครดิตจะยกระดับของคุณหากคุณต้องการปริมาณงานที่ต่อเนื่อง. คู่มือการจัดการข้อผิดพลาด ของ SDK แสดงรูปแบบ RateLimitError.
500 หรือ 503. ฝั่งเซิร์ฟเวอร์. ลองใหม่โดยหน่วงเวลา; การวนลูปการลองใหม่ที่รวดเร็วจะทำให้การจำกัดอัตราแย่ลง.
คำถามที่พบบ่อย
มีคีย์ Perplexity API ฟรีหรือไม่?
ไม่มีการระบุระดับฟรีในเอกสาร. API เป็นแบบจ่ายตามการใช้งานจริง (pay-as-you-go) จากยอดเครดิตที่เติมไว้ล่วงหน้า, และโปรเจกต์ที่ไม่มีเครดิตจะถูกบล็อก. ค่าใช้จ่ายของคำขอแรกด้วย perplexity/sonar และการค้นหาเว็บหนึ่งครั้งมีค่าเพียงเศษเสี้ยวของเซนต์, ดังนั้นการเติมเงินเล็กน้อยก็ครอบคลุมการทดสอบได้มากมาย.
ฉันควรใช้รหัสโมเดลใดสำหรับคำขอแรก?
ใช้ perplexity/sonar บน /v1/agent พร้อมเครื่องมือ web_search. เป็นตัวเลือกที่มีค่าใช้จ่ายต่ำที่สุดและเป็นตัวเลือกที่คู่มือการย้ายระบบจับคู่รหัส sonar และ sonar-pro แบบเก่าไว้. เปลี่ยนไปใช้พรีเซ็ตเช่น low หรือ medium เมื่อคุณต้องการให้ Perplexity เลือกโมเดลและงบประมาณการค้นหาให้คุณ.
ฉันจำเป็นต้องใช้ Agent API หรือไม่หากฉันต้องการแค่ผลการค้นหา?
ไม่จำเป็น. Search API ที่แยกต่างหากจะส่งคืนผลลัพธ์ที่จัดอันดับโดยไม่ต้องเรียกใช้โมเดล, ซึ่งมีราคาถูกกว่าเมื่อคุณป้อนหน้าเว็บเข้าสู่ไปป์ไลน์ของคุณเอง. คู่มือแนะนำ Perplexity Search API ของเราจะแสดงรูปแบบคำขอและตัวกรอง.
ฉันจะหมุนเวียนคีย์ (rotate key) โดยไม่มีการหยุดชะงักได้อย่างไร?
สร้างคีย์ที่สองในโปรเจกต์เดียวกัน, นำไปใช้งานในทุกที่ที่คีย์เก่าเคยถูกใช้, ยืนยันการรับส่งข้อมูลบนคีย์ใหม่, จากนั้นเพิกถอนคีย์เก่า. การเพิกถอนเป็นการถาวร, ดังนั้นให้อัปเดตผู้ใช้งานทั้งหมดก่อน. Perplexity ยังเปิดเผย endpoint /generate_auth_token และ /revoke_auth_token หากคุณต้องการเขียนสคริปต์สำหรับการหมุนเวียนคีย์.
สรุป
ลงชื่อเข้าใช้, สร้างโปรเจกต์, ซื้อเครดิต, สร้างคีย์, ส่งคำขอหนึ่งครั้งไปยัง /v1/agent ด้วย perplexity/sonar. นั่นคือขั้นตอนทั้งหมด. จัดเก็บคีย์เป็นค่าภายในเครื่องใน Apidog และบันทึกคำขอเป็นการทดสอบ, แล้วคนถัดไปในทีมของคุณก็จะมีการตั้งค่าที่ตรวจสอบได้ในไม่กี่นาที. หากคุณยังมีโค้ดบน endpoint chat-completions, ให้ย้ายมันก่อนวันที่ 27 กันยายน 2026.