วิธีทดสอบคีย์ API AI ด้วย curl และ Python

นี่คือวิธีทดสอบการเข้าถึง ai api key โดยไม่ต้องสร้างอะไรเลย: สามคำขอ ใช้เวลาประมาณสองนาที และคุณจะรู้ว่าคีย์ใช้งานได้ มีเงิน และอนุญาตให้สร้างข้อความได้หรือไม่
ประเด็นสำคัญ
- เรียก GET /v1/models ก่อน: เพื่อพิสูจน์ว่าคีย์ได้รับการยอมรับโดยไม่ใช้เครดิต
- ส่งคำขอแชทสั้นๆ หนึ่งคำขอไปยังโมเดล uncensored เพื่อยืนยันว่าการสร้างข้อความทำงานได้
- อ่านส่วนหัว X-Balance-USD หรือ GET /v1/balance เพื่อดูยอดคงเหลือ
- 401 หมายถึงที่คีย์, 402 หมายถึงที่ยอดเงิน, 429 หมายถึงที่ขีดจำกัดอัตราคำขอของคุณ
การทดสอบแบบสามคำขอ
การทดสอบ API key ของ AI อย่างถูกต้องต้องพิสูจน์สามสิ่ง: เซิร์ฟเวอร์ยอมรับคีย์, คีย์มีเครดิตรองรับ, และมีการตอบกลับ (completion) จริง คำขอหนึ่งต่อคำถามทำให้การวินิจฉัยง่ายขึ้น หากมีข้อผิดพลาด คุณจะรู้ได้ทันทีว่าชั้นใดเป็นสาเหตุ
- รายการโมเดล ตรวจสอบความถูกต้องของคีย์และไม่ต้องเสียค่าใช้จ่าย
- การสร้างข้อความแชท ยืนยันว่าโมเดลตอบได้และรูปแบบคำขอของคุณถูกต้อง
- ยอดเงิน ยืนยันยอดเงินคงเหลือหลังจากการทดสอบ
ทุกอย่างด้านล่างใช้ Base URL https://api.aiapisource.com/v1 และ model ID uncensored ใส่คีย์ของคุณในตัวแปรสภาพแวดล้อมเพื่อไม่ให้ปรากฏในประวัติ shell หรือ repository
export AIAPI_KEY="paste-your-key-here"
หากคุณยังไม่มีคีย์ หน้า คีย์ API แสดงวิธีสร้างคีย์ บัญชีใหม่สามารถรับเครดิตทดลองใช้ $0.50 ได้เพียงคลิกเดียว ซึ่งเพียงพอสำหรับการทดสอบทุกการทดสอบในบทความนี้
ขั้นตอนที่ 1: แสดงรายการโมเดลด้วย curl
การตรวจสอบที่ประหยัดที่สุดคือคำขอแบบอ่านอย่างเดียว GET /v1/models จะส่งคืนรายการโมเดลและต้องการคีย์ที่ถูกต้อง ดังนั้นการตอบกลับที่สำเร็จพิสูจน์การตรวจสอบสิทธิ์
curl -s https://api.aiapisource.com/v1/models \
-H "Authorization: Bearer $AIAPI_KEY"
การตอบกลับที่สมบูรณ์คือ JSON ที่มีอาร์เรย์ data ซึ่งรวม uncensored ไว้ หากเห็นหน้า HTML ข้อผิดพลาดการเชื่อมต่อ หรือการตอบกลับว่างเปล่า ปัญหาอยู่ที่ URL ไม่ใช่คีย์ ตรวจสอบว่าคุณคง /v1 ไว้ และไม่มีช่องว่างต่อท้ายคีย์ในตัวแปรของคุณ
เพิ่ม -i ไปยังคำสั่ง curl เพื่อดู response headers API ส่ง X-Request-Id ทุกครั้งที่เรียกใช้ เก็บค่านั้นไว้หากคุณติดต่อ support เพราะมันระบุคำขอที่แน่นอน
ขั้นตอนที่ 2: ส่งคำขอแชทหนึ่งคำขอ
ตอนนี้ตรวจสอบการสร้างข้อความ เก็บพรอมต์ให้สั้นที่สุดและจำกัดผลลัพธ์เพื่อให้การทดสอบมีค่าใช้จ่ายเพียงเศษเสี้ยวของเซ็นต์
curl -s https://api.aiapisource.com/v1/chat/completions \
-H "Authorization: Bearer $AIAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Reply with the single word: ready"}],
"max_tokens": 10
}'
มองหา choices[0].message.content และออบเจ็กต์ usage ที่มี prompt_tokens และ completion_tokens คำขอที่มี input tokens ประมาณ 20 และ output tokens 5 มีค่าใช้จ่าย 20 / 1,000,000 x $0.15 บวก 5 / 1,000,000 x $0.50 ซึ่งคิดเป็นประมาณ $0.0000055 คุณสามารถรันคำขอเหล่านี้ได้ร้อยคำขอด้วยต้นทุนต่ำกว่าหนึ่งเซ็นต์
เอนด์พอยต์เดียวกันนี้ยังรองรับการสตรีมมิง: เพิ่ม "stream": true และโทเคนจะมาถึงในรูปแบบ server-sent events ทดสอบส่วนนี้แยกต่างหากเมื่อการเรียกพื้นฐานทำงานได้แล้ว
ขั้นตอนที่ 3: การทดสอบเดียวกันใน Python
หากโค้ดจริงของคุณใช้ OpenAI SDK ให้ทดสอบผ่าน SDK ด้วยเช่นกัน SDK จะจับปัญหาที่ curl ไม่สามารถตรวจจับได้ เช่น การส่ง base URL ไปยังอาร์กิวเมนต์ที่ไม่ถูกต้อง
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["AIAPI_KEY"],
base_url="https://api.aiapisource.com/v1",
)
print([m.id for m in client.models.list().data])
r = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Reply with the single word: ready"}],
max_tokens=10,
)
print(r.choices[0].message.content)
print(r.usage)
การพิมพ์ครั้งแรกควรแสดงรายการที่มี uncensored การพิมพ์ครั้งที่สองแสดงการตอบกลับของโมเดล สำหรับการตั้งค่า SDK ที่ละเอียดกว่า ดู คู่มือ Python API ของ OpenAI ในเว็บไซต์นี้
รันเวอร์ชัน Python จาก shell เดียวกับที่คุณส่งออกคีย์ หากเกิด KeyError บน AIAPI_KEY แสดงว่าตัวแปรไม่ได้ถูกตั้งค่าในเซสชันนั้น ซึ่งเป็นสาเหตุที่พบบ่อยที่สุดที่ทำให้การทดสอบล้มเหลวก่อนที่จะเข้าถึงเครือข่าย
Node ทำงานในลักษณะเดียวกัน: ส่ง baseURL: "https://api.aiapisource.com/v1" และคีย์ไปยังคอนสตรัคเตอร์ไคลเอนต์ OpenAI
ตรวจสอบยอดเงินคงเหลือ
คีย์อาจยังใช้งานได้แต่ไม่มีเงินเหลือให้ใช้ มีสองวิธีในการตรวจสอบยอดเงิน:
curl -s https://api.aiapisource.com/v1/balance \
-H "Authorization: Bearer $AIAPI_KEY"
# OpenAI-style alternative
curl -s https://api.aiapisource.com/v1/dashboard/billing/credit_grants \
-H "Authorization: Bearer $AIAPI_KEY"
ทุกการตอบกลับยังมีหัว X-Balance-USD อยู่ ดังนั้นการเรียกแชทจากขั้นตอนที่ 2 จึงบอกยอดเครดิตคงเหลือของคุณไว้แล้วหากคุณเรียกใช้ด้วย -i ใน Python SDK ของ OpenAI จะเปิดเผยข้อมูลนี้ผ่าน client.chat.completions.with_raw_response.create(...) โดยคุณอ่านค่า response.headers["X-Balance-USD"]
คำขอที่ล้มเหลวหรือถูกปฏิเสธจะไม่ถูกเรียกเก็บเงิน ดังนั้นการทดสอบที่ส่งข้อผิดพลาดจะไม่ใช้เครดิต เครดิตแบบเติมเงินล่วงหน้าไม่หมดอายุ ซึ่งหมายความว่ายอดเงินที่ไม่ได้ใช้จะยังคงมีอยู่สัปดาห์หน้า
การอ่านรหัสข้อผิดพลาด
เมื่อการทดสอบล้มเหลว รหัส HTTP จะช่วยระบุสาเหตุได้รวดเร็ว
| สถานะ | ความหมายปกติ | สิ่งที่ควรทำ |
|---|---|---|
| 401 | คีย์หายไป พิมพ์ผิด หรือถูกเพิกถอน | ตรวจสอบหัว Authorization: Bearer คัดลอกคีย์อีกครั้ง มองหาช่องว่างหรือเครื่องหมายคำพูดที่ซ่อนอยู่ |
| 402 | ไม่มีเครดิตเหลือสำหรับการจ่ายคำขอ | อ่านยอดเงิน แล้วเติมเงินที่ หน้ากำหนดราคา |
| 404 | เส้นทางหรือ ID โมเดลผิด | ใช้ /v1/chat/completions และโมเดล uncensored |
| 429 | ขีดจำกัดอัตราหรือความพร้อมใช้งานพร้อมกัน หรือการโอเวอร์โหลดสั้นๆ | รอแล้วลองใหม่; ดูด้านล่าง |
429 มีรหัสข้อผิดพลาด rate_limited หมายถึงคำขอเกินต่อนาที และ concurrency หมายถึงคำขอพร้อมกันเกิน ขีดจำกัดคีย์เต็มอนุญาต 300 คำขอต่อนาทีและ 8 คำขอพร้อมกัน; คีย์ทดลองอนุญาต 60 ต่อนาทีและ 2 พร้อมกัน เมื่อโอเวอร์โหลดชั่วคราว API จะตอบ 429 พร้อม Retry-After: 5 ดังนั้นรอห้าวินาทีแล้วส่งคำขออีกครั้ง คำขอแบบสตรีมจะครอบครองช่องความพร้อมใช้งานพร้อมกันจนกว่าสตรีมจะเสร็จ ซึ่งเป็นสาเหตุทั่วไปที่คีย์ทดลองชนขีดจำกัดในการทดสอบแบบขนาน
รหัสสถานะ 401, 402 และ 404 ปฏิบัติตามมาตรฐาน API ปกติ ดังนั้นให้ใช้ตารางนี้เป็นเพียงการคาดเดาเบื้องต้น และอ่านเนื้อหาข้อผิดพลาด JSON สำหรับข้อความที่แน่นอน
สคริปต์ทดสอบเบื้องต้นที่นำกลับมาใช้ใหม่ได้
เมื่อการทดสอบด้วยมือผ่านแล้ว ให้เก็บสคริปต์ที่คุณสามารถเรียกใช้หลังจากหมุนคีย์หรือเปลี่ยนสภาพแวดล้อม
import os, sys
import requests
BASE = "https://api.aiapisource.com/v1"
H = {"Authorization": "Bearer " + os.environ["AIAPI_KEY"]}
m = requests.get(BASE + "/models", headers=H, timeout=15)
print("models", m.status_code)
c = requests.post(
BASE + "/chat/completions",
headers=H,
json={"model": "uncensored",
"messages": [{"role": "user", "content": "ping"}],
"max_tokens": 5},
timeout=60,
)
print("chat", c.status_code, "balance", c.headers.get("X-Balance-USD"))
sys.exit(0 if m.ok and c.ok else 1)
รหัสการออกทำให้การตรวจสอบการปรับใช้ทำได้ง่าย สำหรับพารามิเตอร์ที่เกินขั้นต่ำนี้ API docs ระบุทุกอย่างที่เอนด์พอยต์ยอมรับ
คู่มือเพิ่มเติม
ถาม-ตอบ
การทดสอบคีย์ API มีค่าใช้จ่ายหรือไม่?
การเรียกใช้รายการโมเดลฟรี ค่าคำขอแชทสั้นๆ ที่กำหนด max_tokens ต่ำ มีราคาเพียงไม่กี่ล้านส่วนของ $1 โดยคิด $0.15 ต่อ 1M input tokens และ $0.50 ต่อ 1M output tokens คำขอที่ล้มเหลวจะไม่ถูกเรียกเก็บเงิน
ฉันจะทดสอบคีย์โดยไม่ใช้บัตรได้อย่างไร?
รับเครดิตทดลองใช้ $0.50 ในหน้า API key หลังจากเข้าสู่ระบบ โดยไม่ต้องใช้บัตร และใช้งานได้ 7 วัน ต่อหนึ่งบุคคล
ทำไมคีย์ที่ใช้งานได้จึงได้รับรหัสสถานะ 429 ทันที?
คุณน่าจะชนขีดจำกัดความพร้อมใช้งานพร้อมกันหรือต่อนาที คีย์ทดลองอนุญาต 2 คำขอพร้อมกันและ 60 ต่อนาที; คีย์เต็มอนุญาต 8 และ 300 ตรวจสอบรหัสข้อผิดพลาดแล้วลดความเร็วหรือลองใหม่หลังจากผ่านไปไม่กี่วินาที
ฉันสามารถทดสอบคีย์ใน Postman หรือแอปแทน curl ได้หรือไม่
ได้ ไคลเอนต์ที่เข้ากันได้กับ OpenAI ทุกตัวใช้งานได้: ตั้งค่า Base URL เป็น https://api.aiapisource.com/v1, วางคีย์เป็นโทเคน Bearer และใช้โมเดล uncensored
คีย์ของคุณอยู่ห่างแค่การกรอกแบบฟอร์มเดียว
สร้างบัญชี คัดลอกคีย์ และเปลี่ยน URL พื้นฐาน นั่นคือการตั้งค่าทั้งหมด