ตัวติดตามค่าใช้จ่าย AI API: ตรวจสอบการใช้จ่ายด้วย Header
คุณสามารถสร้างตัวติดตามค่าใช้จ่าย API AI ได้ในประมาณห้าสิบบรรทัด เพราะทุก response บอกยอดคงเหลือของคุณอยู่แล้ว คู่มือนี้แสดงวิธีการบันทึกค่าใช้จ่ายต่อคำขอ อ่าน balance endpoints และแจ้งเตือนก่อนเครดิตหมด


ประเด็นสำคัญ
- response ทุกครั้งมี header X-Balance-USD พร้อมเครดิตคงเหลือของคุณ
- GET /v1/balance และ endpoint credit_grants คืนค่ายอดคงเหลือเมื่อต้องการ
- ค่าใช้จ่ายต่อการเรียกคือ (input x 0.15 + output x 0.50) / 1,000,000 ดอลลาร์
- บันทึกเป็น CSV แล้วแจ้งเตือนเมื่อยอดคงเหลือต่ำกว่าเกณฑ์
ที่มาของตัวเลข
เครดิตแบบเติมเงินล่วงหน้าทำให้การติดตามต้นทุนทำได้ง่าย เพราะผู้ให้บริการมีการบันทึกยอดรวมไว้แล้ว คุณจะได้รับข้อมูลนี้จากสามแหล่ง:
- ส่วนหัวของคำตอบ
X-Balance-USDในการเรียก API ซึ่งแสดงยอดคงเหลือหลังจากคำขอนั้น GET /v1/balanceสำหรับการตรวจสอบยอดคงเหลือแบบพื้นฐานGET /v1/dashboard/billing/credit_grantsเส้นทางรูปแบบ OpenAI ที่เครื่องมือเช่นแดชบอร์ดและ wrapper รู้วิธีเรียกใช้งานอยู่แล้ว
พร้อมกับสิ่งเหล่านั้น แต่ละการสร้างข้อความจะส่งคืนวัตถุ usage พร้อมจำนวนโทเคนของ prompt และ completion รวมโทเคนกับราคา ($0.15 ต่อ 1M input, $0.50 ต่อ 1M output) คุณสามารถคำนวณค่าใช้จ่ายของคำขอใด ๆ เองได้ จากนั้นเปรียบเทียบกับยอดคงเหลือที่ลดลง ทั้งสองควรตรงกัน หากไม่ตรงกัน แสดงว่าคุณพบสิ่งที่ต้องตรวจสอบ รายละเอียดพารามิเตอร์เต็มอยู่ใน docs
อ่านส่วนหัวในคำขอเดียว
ด้วย curl ให้เพิ่ม -i และดูส่วนหัว:
curl -si https://api.uncensoredaiapis.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"Say hi."}]}' \
| grep -i "x-balance-usd"
ใน Python SDK ของ OpenAI การตอบสนองแบบดิบจะถูกเปิดเผยผ่าน with_raw_response ซึ่งให้คุณได้ทั้งส่วนหัวและวัตถุที่แปลงรูปแบบแล้วร่วมกัน:
from openai import OpenAI
client = OpenAI(base_url="https://api.uncensoredaiapis.com/v1", api_key="sk-your-key")
raw = client.chat.completions.with_raw_response.create(
model="uncensored",
messages=[{"role": "user", "content": "Say hi."}],
)
resp = raw.parse()
print(raw.headers.get("x-balance-usd"), resp.usage.total_tokens)ตัวบันทึกขนาดเล็กที่บันทึกทุกการเรียก
ห่อการเรียกของคุณไว้ในฟังก์ชันเดียวและเขียนแถว CSV ทุกครั้ง แถวนี้มีเวลา, ID คำขอ, จำนวนโทเคน, ต้นทุนที่คำนวณได้ และยอดคงเหลือ
import csv, time
from openai import OpenAI
client = OpenAI(base_url="https://api.uncensoredaiapis.com/v1", api_key="sk-your-key")
PRICE_IN, PRICE_OUT = 0.15, 0.50 # dollars per 1M tokens
LOG = "api_spend.csv"
def cost(usage):
return (usage.prompt_tokens * PRICE_IN + usage.completion_tokens * PRICE_OUT) / 1_000_000
def tracked_chat(messages, tag="default"):
raw = client.chat.completions.with_raw_response.create(
model="uncensored", messages=messages)
r = raw.parse()
row = [
time.strftime("%Y-%m-%d %H:%M:%S"),
raw.headers.get("x-request-id"),
tag,
r.usage.prompt_tokens,
r.usage.completion_tokens,
round(cost(r.usage), 6),
raw.headers.get("x-balance-usd"),
]
with open(LOG, "a", newline="") as f:
csv.writer(f).writerow(row)
return r, row
อาร์กิวเมนต์ tag คือเคล็ดลับที่ทำให้ log มีประโยชน์ ส่งชื่อฟีเจอร์เช่น "summaries" หรือ "chat" แล้วภายหลังคุณสามารถรวมค่าใช้จ่ายตาม tag เพื่อดูว่าส่วนใดของผลิตภัณฑ์ใช้เงินมากที่สุด รหัสคำขอช่วยหากคุณต้องการถาม เกี่ยวกับค่าใช้จ่าย หรือรายงานปัญหา เนื่องจากระบุการเรียกที่แน่นอน
ตรวจสอบความสมเหตุสมผลของตัวเลข
รับคำขอที่มี input tokens 2,400 และ output tokens 600:
- Input: 2,400 x 0.15 / 1,000,000 = $0.00036
- Output: 600 x 0.50 / 1,000,000 = $0.00030
- รวม: $0.00066
จำนวนหนึ่งพันครั้งแบบนั้นจะมีค่าใช้จ่าย $0.66 หาก CSV ของคุณแสดงยอดเงินลดลงเร็วกว่าผลรวมของต้นทุนที่คำนวณได้ ให้ตรวจสอบการเรียกซ้ำที่คุณไม่ได้บันทึก, งานพื้นหลังที่ใช้คีย์ API เดียวกัน หรือสตรีมที่คุณยังเปิดอยู่ คำขอที่ล้มเหลวหรือถูกปฏิเสธจะไม่ถูกคิดเงิน ดังนั้นข้อผิดพลาดไม่ควรทำให้ยอดเงินเปลี่ยนแปลง เปรียบเทียบยอดรวมจากการเรียกหลายครั้ง ไม่ใช่ครั้งเดียว เพื่อให้ผลต่างจากการปัดเศษเฉลี่ยกัน
การเรียกแบบสตรีมมิงและการใช้งาน
เมื่อใช้ stream: true ตัวเลขการใช้งานจะปรากฏที่ท้ายสตรีม ให้รวบรวมจากชิ้นส่วนสุดท้าย แล้วบันทึกแถวหลังจากที่สตรีมปิด
def tracked_stream(messages, tag="chat"):
usage = None
for chunk in client.chat.completions.create(
model="uncensored", messages=messages, stream=True):
if chunk.choices and chunk.choices[0].delta.content:
yield chunk.choices[0].delta.content
usage = getattr(chunk, "usage", None) or usage
if usage:
with open(LOG, "a", newline="") as f:
csv.writer(f).writerow([time.strftime("%F %T"), "", tag,
usage.prompt_tokens, usage.completion_tokens, round(cost(usage), 6), ""])
หากต้องการเฉพาะยอดคงเหลือ ให้เรียก GET /v1/balance หลังจากสตรีมมิงสิ้นสุดลงแทน เป็นคำขอที่ใช้ทรัพยากรต่ำ และสามารถใช้ตรวจสอบเป็นระยะจาก cron job ได้ด้วย
การรวมยอดค่าใช้จ่ายตามฟีเจอร์
ไฟล์ CSV จะมีประโยชน์ก็ต่อเมื่อคุณอ่านมัน สคริปต์สั้นๆ นี้จะรวมต้นทุนตามแท็กและแสดงยอดคงเหลือล่าสุด โดยไม่ต้องใช้แพ็กเกจเพิ่มเติม
import csv
from collections import defaultdict
totals, last_balance = defaultdict(float), None
with open("api_spend.csv") as f:
for row in csv.reader(f):
ts, req_id, tag, pin, pout, cost_usd, balance = row
totals[tag] += float(cost_usd)
last_balance = balance or last_balance
for tag, usd in sorted(totals.items(), key=lambda kv: -kv[1]):
print(f"{tag:15s} ${usd:.4f}")
print("latest balance:", last_balance)
เรียกใช้สคริปต์ทุกวันแล้ววางผลลัพธ์ลงในช่องแชทของทีมของคุณ ค่าใช้จ่ายที่มองไม่เห็นจะกลายเป็นตัวเลขที่ทีมสามารถพูดคุยได้ และฟีเจอร์ที่ใช้งบประมาณมากกว่าฟีเจอร์อื่นสิบเท่าจะปรากฏชัดเจนทันที สำหรับการทำงบประมาณโดยประมาณ ให้คูณยอดรวมรายวันด้วย 30 และเพิ่มพื้นที่สำรองอีก 20 เปอร์เซ็นต์
เพิ่มการแจ้งเตือนเมื่อยอดคงเหลือต่ำ
การหมดเครดิตระหว่างวันจะทำให้ผลิตภัณฑ์หยุดทำงาน ดังนั้นควรแจ้งเตือนล่วงหน้า cron job ที่ทำงานทุก 15 นาทีก็เพียงพอแล้ว
import requests
BASE = "https://api.uncensoredaiapis.com/v1"
THRESHOLD = 5.00 # dollars
r = requests.get(BASE + "/balance", headers={"Authorization": "Bearer sk-your-key"}, timeout=10)
print(r.status_code, r.text) # inspect the JSON once to see the field name
# After you know the field name, parse it and compare with THRESHOLD,
# then post to your chat webhook or send an email.
พิมพ์ JSON แบบ raw ออกมาหนึ่งครั้งและตรวจสอบก่อนเขียนโค้ดสำหรับแยกข้อมูล ชื่อฟิลด์ที่แท้จริงใช้เวลาตรวจสอบเพียงสิบวินาที และการเดาชื่อฟิลด์จากบทความอาจทำให้การแจ้งเตือนล้มเหลวโดยไม่รู้ตัว เลือกเกณฑ์ที่ครอบคลุมค่าใช้จ่ายปกติอย่างน้อยหนึ่งวัน ซึ่งคุณสามารถทราบได้จาก CSV: นำยอดค่าใช้จ่ายของเมื่อวานมาบวกกันและใช้ค่านั้นเป็นค่าต่ำสุด
เมื่อมีการแจ้งเตือน เติมเงิน จำนวนเต็มใดๆ ตั้งแต่ $20 ถึง $500 ใช้ได้ โดยได้รับเครดิตเพิ่ม +5% เมื่อเติม $50, +10% เมื่อเติม $100 และ +15% เมื่อเติม $200 และเครดิตไม่หมดอายุ ก่อนอื่นให้ใช้ หน้าคีย์ API เพื่อรับคีย์สำหรับตัวติดตาม
นิสัยที่ช่วยให้ค่าใช้จ่ายคาดเดาได้
- ใช้คีย์แยกกันสำหรับแต่ละสภาพแวดล้อม เพื่อให้ปริมาณการทดสอบไม่ไปบดบังตัวเลขในสภาพแวดล้อมการผลิต
- จำกัด
max_tokensบนเอนด์พอยต์ที่ไม่จำเป็นต้องใช้คำตอบยาวๆ ค่านี้ไม่บังคับในค่าเริ่มต้น ดังนั้นการตอบกลับที่ไม่มีขอบเขตจึงเป็นไปได้ - ตัดประวัติแชทออก โทเคนอินพุตมีราคาถูกกว่าโทเคนเอาต์พุต แต่ประวัติที่ยาวและถูกเรียกซ้ำในทุกๆ รอบจะสะสมค่าใช้จ่าย
- ตรวจสอบยอดรวมรายสัปดาห์ตามแท็ก และมองหาแท็กเดียวที่มีค่าใช้จ่ายมากกว่าครึ่งหนึ่งของบิล
อีกนิสัยหนึ่ง: เก็บ ID ของคำขอพร้อมกับแถวที่บันทึกไว้ทุกครั้ง หากตัวเลขดูผิดปกติในอีกเดือนหนึ่ง คุณสามารถจับคู่กับคำขอเฉพาะเจาะจงได้ แทนที่จะโต้แย้งจากค่าเฉลี่ย เนื่องจากคำขอที่ล้มเหลวจะไม่ถูกเรียกเก็บเงิน การลองใหม่เมื่อเกิดข้อผิดพลาดจึงไม่เพิ่มต้นทุน แต่การลองใหม่หลังจากได้รับคำตอบสำเร็จแล้วจะเพิ่มต้นทุน ดังนั้นให้แน่ใจว่าตรรกะการลองใหม่ของคุณจะทำงานเฉพาะเมื่อเกิดข้อผิดพลาดจริงๆ บั๊กที่ส่งคำขอที่สำเร็จแล้วซ้ำในลูปเป็นสาเหตุที่พบบ่อยที่สุดของบิลที่เกินคาดใน API ที่คิดค่าบริการตามโทเคน
คู่มือเพิ่มเติม
ถาม-ตอบ
ส่วนหัวของยอดคงเหลือปรากฏในทุกการตอบกลับหรือไม่
header X-Balance-USD เป็นส่วนหนึ่งของ response headers สำหรับ API นี้ อ่านค่าจาก raw response และพิจารณาค่าที่ขาดหายไปในฐานะค่าที่ไม่ทราบ
ฉันสามารถรับข้อมูลค่าใช้จ่ายโดยไม่ต้องบันทึกคำขอแต่ละคำได้หรือไม่
ใช่. ทำการ poll GET /v1/balance ตามกำหนดเวลาและคำนวณผลต่างระหว่างค่าที่อ่านได้
คำขอที่ล้มเหลวส่งผลต่อยอดคงเหลือหรือไม่
ไม่ คำขอที่ล้มเหลวหรือถูกปฏิเสธจะไม่ถูกเรียกเก็บเงิน
เอนด์พอยต์ใดที่เครื่องมือแดชบอร์ด OpenAI ที่มีอยู่ควรใช้
ใช้เส้นทาง GET /v1/dashboard/billing/credit_grants แบบ OpenAI-style ซึ่งเครื่องมือหลายตัวรองรับอยู่แล้ว
คีย์ของคุณอยู่ห่างแค่ขั้นตอนการกรอกแบบฟอร์ม
สร้างบัญชี คัดลอกคีย์ และเปลี่ยน base URL นั่นคือการตั้งค่าทั้งหมด