TH ▾
Base URL https://api.uncensoredaiapis.com/v1โมเดล uncensored
รับคีย์ API
Uncensored AIคู่มือการย้าย

ตัวติดตามค่าใช้จ่าย AI API: ตรวจสอบการใช้จ่ายด้วย Header

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

อัปเดต

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

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

  • 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 นั่นคือการตั้งค่าทั้งหมด