วิธีการทำงาน

รูปแบบกำหนดจากพาธของคำขอ ไม่ใช่ตัวโมเดล คุณเรียกโมเดล Claude ตัวเดียวกันผ่าน OpenAI Chat, OpenAI Responses หรือ Anthropic Messages ได้ และคำตอบจะอยู่ในรูปแบบของพาธที่เรียกใช้.

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

ดูรายละเอียดและตัวอย่างการคำนวณได้ที่หน้า การสำรองเงินและการหักเงิน.

ทุกคำตอบมีตัวระบุคำขออยู่ในส่วนหัว X-Request-ID และในข้อความข้อผิดพลาด ข้อผิดพลาดส่งมาเป็น JSON ตามรูปแบบที่คุณเรียกใช้ SDK จึงรู้จักได้อย่างถูกต้อง หากมีปัญหา ให้ส่ง Request ID ไปยัง ฝ่ายสนับสนุน — เพื่อให้เราค้นหาคำขอได้ภายในหนึ่งนาที.

{
  "code": "API_KEY_REQUIRED",
  "error": {
    "code": "invalid_api_key",
    "message": "No API key was sent with the request. Nothing was charged. Please check that the full key is sent in the Authorization header as \"Bearer <key>\". Request ID: 3b28d3de-5b02-4d07-9f3c-4b9a7d0e68d6.",
    "param": null,
    "reason": "invalid_api_key",
    "request_id": "3b28d3de-5b02-4d07-9f3c-4b9a7d0e68d6",
    "type": "invalid_request_error"
  },
  "message": "No API key was sent with the request. Nothing was charged. …"
}

คำตอบแบบสตรีม (stream: true) ส่งเป็น Server-Sent Events โดย Ailoot จะส่งคำตอบข้อความที่มีค่าใช้จ่ายหลังคำนวณค่าใช้จ่ายแล้ว ดังนั้นเมื่อใช้ stream: true รูปแบบยังคงเป็นสตรีม (SSE) แต่ข้อความจะมาถึงเป็นก้อนเดียวเมื่อโมเดลทำงานเสร็จ แทนที่จะส่งมาทีละคำ หากการเตรียมคำตอบใช้เวลานานกว่าประมาณ 15 วินาที สตรีม Chat Completions, Responses และ Messages จะส่งบรรทัดสถานะก่อน : ping (ประมาณทุก 10 วินาที) ตามด้วยบรรทัด : ailoot-charged-usd … ที่ระบุจำนวนเงินที่หัก จากนั้นจึงส่งข้อมูลคำตอบจริง SDK จะข้ามเฉพาะบรรทัดข้อมูลระบบเหล่านี้.

รูปแบบ Gemini ไม่มีบรรทัดสถานะ: คำตอบ :streamGenerateContent จะมาถึงครบทั้งหมดหลังคำนวณค่าใช้จ่าย สำหรับโมเดลที่ใช้การคิดวิเคราะห์ ให้ตั้ง timeout ของไคลเอนต์เผื่อไว้ การรอหลายนาทีเป็นเรื่องปกติ.

X-Request-ID จะมาในทุกคำตอบ ส่วนหัวอื่น ๆ ที่ Ailoot เพิ่มให้คำตอบข้อความที่ชำระเงินแล้ว ได้แก่:

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

หากโมเดลรองรับแคช การส่งคำนำหน้ายาว ๆ ซ้ำ (คำสั่งระบบ เอกสาร) อาจมีค่าใช้จ่ายต่ำลง ราคาการอ่านและเขียนแคชแสดงอยู่ในการ์ดโมเดลใน แค็ตตาล็อก. ผู้พัฒนาโมเดลเป็นผู้ตัดสินว่าจะใช้แคชได้หรือไม่ Ailoot ไม่รับประกันการใช้แคช.