docs
การเงิน

การสำรองเงินและการหักเงิน

Markdown

วิธีที่ Ailoot คำนวณค่าใช้จ่าย: กันเงินก่อนส่งคำขอ หักเงินครั้งเดียวหลังได้รับคำตอบ และยอดคงเหลือที่ไม่ติดลบ

สรุป

  • การกันเงิน — ก่อนส่งคำขอข้อความใหม่ Ailoot จะสำรองเงินตามค่าประเมินอินพุตและคำตอบที่มีความยาวตามปกติ ภายใต้เงื่อนไขของคำขอที่ตกลงไว้ สำหรับเอาต์พุตที่เป็นภาพ วิดีโอ และเสียง ยังคงสำรองค่าใช้จ่ายของผลลัพธ์เต็มจำนวน
  • การหักเงิน — หักเพียงครั้งเดียวตามการใช้งานจริงจาก usage. เงินที่กันไว้ส่วนที่เหลือจะคืนทันที
  • หากยอดเงินไม่พอแม้แต่จำนวนขั้นต่ำที่ต้องกันไว้ — จะไม่ส่งคำขอไปยังโมเดล และคุณจะได้รับข้อผิดพลาด 402 พร้อมข้อความที่เข้าใจได้ โดยไม่มีการหักเงิน
คู่มือฉบับเต็ม

สรุป

  • ราคา — หน่วยเป็นดอลลาร์ต่อโทเคนขาเข้าและขาออก 1 ล้านโทเคน (หรือต่อหน่วย: รูปภาพ วินาทีของวิดีโอ หรืออักขระ) ดูราคาของแต่ละโมเดลได้ใน แค็ตตาล็อก.
  • การกันเงิน — ก่อนส่งคำขอข้อความใหม่ Ailoot จะสำรองเงินตามค่าประเมินอินพุตและคำตอบที่มีความยาวตามปกติ ภายใต้เงื่อนไขของคำขอที่ตกลงไว้ สำหรับเอาต์พุตที่เป็นภาพ วิดีโอ และเสียง ยังคงสำรองค่าใช้จ่ายของผลลัพธ์เต็มจำนวน
  • ลดขีดจำกัดแทนการปฏิเสธ — หากยอดเงินสำรองที่คำนวณได้เกินยอดเงินคงเหลือที่ใช้ได้หรือวงเงินของคีย์ จะลดขีดจำกัดคำตอบได้เฉพาะกับโมเดลและเมธอดที่ปฏิบัติตามขีดจำกัดนั้น และลดได้เพียงเท่าปริมาณที่ชำระได้ โดยต้องไม่ต่ำกว่าขั้นต่ำที่ใช้บังคับ โมเดลที่รองรับมีระบุไว้ ด้านล่าง.
  • การหักเงิน — หักเพียงครั้งเดียวตามการใช้งานจริงจาก usage. เงินที่กันไว้ส่วนที่เหลือจะคืนทันที
  • หากคำตอบมีค่าใช้จ่ายสูงกว่าเงินที่กันไว้ — จะหักส่วนต่างจากยอดคงเหลือที่ไม่ได้กันไว้สำหรับคำขออื่น การหักเงินจะไม่เกินยอดคงเหลือของคุณ และยอดคงเหลือจะไม่ติดลบ
  • หากยอดเงินไม่พอแม้แต่จำนวนขั้นต่ำที่ต้องกันไว้ — จะไม่ส่งคำขอไปยังโมเดล และคุณจะได้รับข้อผิดพลาด 402 พร้อมข้อความที่เข้าใจได้ โดยไม่มีการหักเงิน
  • ไม่คิดค่าบริการเมื่อเกิดข้อผิดพลาดโดยไม่ได้รับผลลัพธ์. หากการเชื่อมต่อขาดหาย ให้ตรวจ⁠สอบคำขอด้วย Request ID ในประวัติของแดชบอร์ดก่อนส่งซ้ำ

วิธีคำนวณเงินที่กันไว้

  • อินพุต จะสำรองเงินตามค่าประเมินขนาดคำขอและไฟล์แนบที่รองรับ ไม่ใช่ตามปริมาณการใช้งานจริงที่ทราบแล้ว สำหรับคำขอข้อความใหม่ จะใช้ค่าประเมินเนื้อหาคำขอและไฟล์แนบตามประเภทของข้อมูล การคำนวณแบบ “4 โทเคนต่อไบต์ แต่ไม่น้อยกว่า 4096 โทเคน” ใช้กับยอดเงินสำรองของเวอร์ชันเก่าที่ตกลงไว้ก่อนหน้านี้ และไม่ได้อธิบายยอดเงินสำรองสำหรับคำขอข้อความใหม่ หากส่งไฟล์แนบเป็นลิงก์ (fileData) หรือเปิดใช้เครื่องมือในตัว สำหรับคำขอข้อความที่รองรับ จะประเมินไฟล์แนบและการทำงานของเครื่องมือแยกต่างหาก การมีไฟล์แนบหรือเครื่องมือเพียงอย่างเดียวไม่ได้หมายความว่าจะสำรองเงินสำหรับหน้าต่างอินพุตทั้งหมด ยอดเงินสำรองเดิมยังคงใช้เงื่อนไขที่ตกลงไว้ ส่วนเอาต์พุตสื่อยังคงคำนวณจากผลลัพธ์เต็มจำนวน
  • เอาต์พุต สำหรับการสำรองเงินของคำขอข้อความใหม่ จะประเมินจากความยาวคำตอบตามปกติและเงื่อนไขที่ตกลงไว้ ขีดจำกัดที่ขอจะกำหนดผ่าน max_tokens (max_output_tokens ใน Responses) ขีดจำกัดที่ขอไม่ได้เท่ากับจำนวนโทเคนที่ใช้คำนวณยอดเงินสำรองโดยอัตโนมัติ และไม่ได้รับประกันความยาวคำตอบจริงของโมเดลที่ไม่มีขีดจำกัดที่เชื่อถือได้ ค่าเริ่มต้น 4096 ใช้กับเส้นทางที่เกี่ยวข้องเท่านั้น กฎที่ใช้ขึ้นอยู่กับโมเดลและเมธอด
  • ราคา สำหรับยอดเงินสำรองของคำขอข้อความใหม่ คำนวณโดยคำนึงถึงเงื่อนไขของคำขอนั้น ได้แก่ โหมดมาตรฐานหรือโหมดลำดับความสำคัญสูง และระดับราคาที่อาจถึงได้ตามค่าประเมินอินพุต การคำนวณภายใต้เงื่อนไขที่เลือกยังคงเผื่อค่าใช้จ่ายไว้อย่างระมัดระวัง โหมด flex ไม่ทำให้ยอดเงินสำรองลดลง สำหรับคำขอลำดับความสำคัญสูง ยอดเงินสำรองอาจคำนวณโดยใช้โหมดที่มีค่าใช้จ่ายสูงที่สุดในบรรดาโหมดที่ใช้ได้ รวมถึง priority, flex หรือ fast ยอดเงินสำรองที่ตกลงไว้ก่อนหน้านี้โดยไม่มีเงื่อนไขเหล่านี้ยังคงใช้การคำนวณเดิมตามอัตราสูงสุด
  • การลดขีดจำกัด — เมื่อยอดเงินสำรองที่คำนวณได้เกินเงินที่ใช้ได้ และโมเดลกับเมธอดนั้นรองรับการจำกัดคำตอบ เงินที่ใช้ได้ต้องพอสำหรับค่าประเมินอินพุตและปริมาณเอาต์พุตขั้นต่ำ ขีดจำกัดที่ลดแล้วต้องไม่ต่ำกว่า 256 โทเคน (1025 — เมื่อใช้การคิดวิเคราะห์ในรูปแบบ Anthropic) โมเดลจะได้รับขีดจำกัดที่ลดแล้ว

ตัวอย่างการคำนวณ

โมเดล claude-sonnet-5-5: อินพุต $2 และเอาต์พุต $10 ต่อ 1 ล้านโทเคน คุณส่ง 20 000 โทเคน และโมเดลตอบกลับ 1 200 โทเคน

ขั้นตอนการคำนวณจำนวนเงิน
อินพุตที่ใช้จริง20 000 × $2 / 1 000 000$0.0400
คำตอบที่ได้จริง1 200 × $10 / 1 000 000$0.0120
เงินที่หักหักเงินครั้งเดียวตามการใช้งานจริง$0.0520

ในตัวอย่างการคำนวณนี้ ค่าใช้จ่ายจริงเท่ากับ $0.0520 การหักเงินที่แสดงตั้งอยู่บนสมมติฐานว่ายอดเงินสำรองที่ตกลงไว้และยอดเงินคงเหลือที่ใช้ได้ครอบคลุมค่าใช้จ่ายนี้ ตัวอย่างนี้ไม่ได้คำนวณยอดเงินสำรอง สำหรับคำขอข้อความใหม่ ยอดสำรองจะกำหนดแยกต่างหากจากค่าประเมินอินพุตและคำตอบที่มีความยาวตามปกติ และอาจมากกว่าหรือน้อยกว่าค่าใช้จ่ายจริง ยอดเงินสำรองที่ไม่ได้ใช้จะถูกปล่อยคืน ขีดจำกัดการหักเงินแสดงไว้ในสูตรด้านล่าง

จำนวนเงินที่หักจริง = min(ค่าใช้จ่ายจริงทั้งหมด, ยอดกันไว้ที่ยอมรับแล้ว + ยอดคงเหลือที่ใช้ได้และยังไม่ได้กันไว้). ยอดเงินสำรองอื่นที่ยังเปิดอยู่ยังคงได้รับการคุ้มครอง ดังนั้นยอดเงินคงเหลือรวมจึงไม่จำเป็นต้องเป็นศูนย์ ยอดเงินคงเหลือจะไม่ติดลบ หากค่าใช้จ่ายจริงสูงกว่ายอดเงินสำรองที่ตกลงไว้รวมกับยอดเงินคงเหลือที่ไม่ได้สำรองไว้ ส่วนต่างที่เหลือเป็นผลขาดทุนของ Ailoot ไม่กลายเป็นหนี้ของคุณและจะไม่ถูกเรียกเก็บภายหลัง

การตัดการเชื่อมต่อของไคลเอนต์

การปิดการเชื่อมต่อ แอปของคุณหมดเวลารอ หรือการไม่อ่านคำตอบที่สร้างเสร็จแล้ว ไม่ได้ยกเลิกคำขอโดยอัตโนมัติ: คำตอบที่โมเดลสร้างเสร็จจะคิดค่าบริการเพียงครั้งเดียว หากไม่ได้ส่งมอบผลลัพธ์เนื่องจากความผิดของ Ailoot จะคืนเงินให้ หากการเชื่อมต่อขาดหาย ให้ตรวจ⁠สอบคำขอด้วย Request ID ในประวัติของแดชบอร์ดก่อนส่งซ้ำ

เหตุใดบางครั้งจึงต้องมียอดคงเหลือมากขึ้น

  • สำหรับคำขอข้อความใหม่ ยอดสำรองสำหรับคำตอบจะคำนวณจากความยาวคำตอบตามปกติ โดยคำนึงถึงค่าที่กำหนดใน max_tokens และเงื่อนไขของโมเดลนั้น นี่เป็นการประเมินยอดเงินสำรอง ไม่ใช่การรับประกันความยาวหรือค่าใช้จ่ายจริงของคำตอบ
  • สำหรับโมเดลที่ไม่สามารถจำกัดความยาวคำตอบจริงได้อย่างน่าเชื่อถือ การประเมินยอดเงินสำรองไม่ได้ทำให้เกิดขีดจำกัดความยาว สำหรับคำขอข้อความใหม่ ค่าประเมินนี้จะไม่ถูกแทนที่ด้วยค่าใช้จ่ายของคำตอบที่ยาวที่สุดโดยอัตโนมัติ ยอดเงินสำรองที่ตกลงไว้ก่อนหน้านี้ยังคงใช้เงื่อนไขเดิม
  • รูปภาพในอินพุตจะเพิ่มค่าใช้จ่ายโดยประมาณของรูปภาพเข้าไปในเงินที่กันไว้
  • เอเจนต์ (Claude Code, Codex CLI, Cline) ส่งบริบทขนาดใหญ่ในทุกขั้นตอน: ขั้นตอนเดียวอาจกันเงินหลายสิบเซนต์ ควรมียอดคงเหลืออย่างน้อยหลายดอลลาร์
  • คำแนะนำ: กำหนดค่าอย่างเหมาะสมสำหรับ max_tokens — เพื่อช่วยลดเงินที่ต้องกันไว้สำหรับโมเดลที่รองรับการจำกัดความยาวคำตอบ

แคชพรอมป์ต์

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

ข้อผิดพลาด 402

หากยอดคงเหลือที่ใช้ได้ไม่เพียงพอแม้แต่จำนวนขั้นต่ำที่ต้องกันไว้ Ailoot จะไม่ส่งคำขอและตอบกลับ 402 พร้อมรหัส insufficient_balance. หากใช้วงเงินค่าใช้จ่ายรวมของคีย์ครบแล้ว จะได้รับรหัส api_key_quota_exhausted. หากบัญชีมีหนี้จากการชำระเงินที่ถูกโต้แย้ง จะได้รับรหัส payment_disputed: คำขอใหม่จะถูกระงับจนกว่าจะชำระหนี้ครบ

402 Payment Required
{
  "error": {
    "code": "insufficient_balance",
    "reason": "insufficient_balance",
    "type": "insufficient_quota",
    "param": null,
    "message": "Your balance is too low to start this request. … Request ID: 5c0e7a1d-….",
    "request_id": "5c0e7a1d-…"
  }
}

ดูค่าใช้จ่ายได้ที่ไหน

ดูประวัติคำขอและการหักเงินได้ในแดชบอร์ดที่ ailoot.ai. แต่ละคำขอจะแสดงโมเดล จำนวนโทเคน และจำนวนเงิน

ยังมีคำถามอยู่ใช่ไหม ส่ง Request ID และรายละเอียดมาให้เรา เราจะช่วยตรวจ⁠สอบติดต่อฝ่ายสนับสนุน