TH ▾

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

กุญแจที่หมุนในลูกบิดพร้อมไฟแสดงสถานะสีเขียวสามดวง แทนการทดสอบคีย์ API สำเร็จ

นี่คือวิธีทดสอบการเข้าถึง ai api key โดยไม่ต้องสร้างอะไรเลย: สามคำขอ ใช้เวลาประมาณสองนาที และคุณจะรู้ว่าคีย์ใช้งานได้ มีเงิน และอนุญาตให้สร้างข้อความได้หรือไม่

อัปเดต

ประเด็นสำคัญ

  • เรียก GET /v1/models ก่อน: เพื่อพิสูจน์ว่าคีย์ได้รับการยอมรับโดยไม่ใช้เครดิต
  • ส่งคำขอแชทสั้นๆ หนึ่งคำขอไปยังโมเดล uncensored เพื่อยืนยันว่าการสร้างข้อความทำงานได้
  • อ่านส่วนหัว X-Balance-USD หรือ GET /v1/balance เพื่อดูยอดคงเหลือ
  • 401 หมายถึงที่คีย์, 402 หมายถึงที่ยอดเงิน, 429 หมายถึงที่ขีดจำกัดอัตราคำขอของคุณ

การทดสอบแบบสามคำขอ

การทดสอบ API key ของ AI อย่างถูกต้องต้องพิสูจน์สามสิ่ง: เซิร์ฟเวอร์ยอมรับคีย์, คีย์มีเครดิตรองรับ, และมีการตอบกลับ (completion) จริง คำขอหนึ่งต่อคำถามทำให้การวินิจฉัยง่ายขึ้น หากมีข้อผิดพลาด คุณจะรู้ได้ทันทีว่าชั้นใดเป็นสาเหตุ

  1. รายการโมเดล ตรวจสอบความถูกต้องของคีย์และไม่ต้องเสียค่าใช้จ่าย
  2. การสร้างข้อความแชท ยืนยันว่าโมเดลตอบได้และรูปแบบคำขอของคุณถูกต้อง
  3. ยอดเงิน ยืนยันยอดเงินคงเหลือหลังจากการทดสอบ

ทุกอย่างด้านล่างใช้ 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 พื้นฐาน นั่นคือการตั้งค่าทั้งหมด

รับคีย์ API