เริ่มต้นใช้งาน

เอกสาร BasicRouter

เริ่มต้นอย่างรวดเร็ว

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

URL ฐานhttps://api.basicrouter.ai/api

เข้ากันได้กับ OpenAIhttps://api.basicrouter.ai/api/v1

Anthropic-messageshttps://api.basicrouter.ai/api/v1

การรับรองความถูกต้องAuthorization: Bearer <key>

สร้างคีย์ API

สร้างคีย์ API BasicRouter ในคอนโซล เก็บคีย์ไว้บนเซิร์ฟเวอร์ของคุณและอย่า เปิดเผยในโค้ดเบราว์เซอร์หรือไคลเอนต์มือถือ

กลยุทธ์คีย์ที่แนะนำ:

ประเภทคีย์	การใช้งานที่แนะนำ
คีย์การพัฒนา	การพัฒนาในเครื่อง, การจัดเตรียม, การทดสอบ และต้นแบบ
คีย์สำหรับการผลิต	สำหรับงานผลิตแบ็กเอนด์เท่านั้น
คีย์การรวมระบบ	คีย์เฉพาะสำหรับเครื่องมือ เช่น Cursor, Claude Code, Codex, Hermes หรือ OpenClaw
คีย์ลูกค้า / ผู้เช่า	การแยกคีย์แบบเลือกได้สำหรับลูกค้าองค์กร ทราฟฟิกของผู้เช่า หรือหน่วยธุรกิจ

หมุนเวียนคีย์เมื่อการเข้าถึงของทีมเปลี่ยนแปลง เพิกถอนคีย์ที่ไม่ใช้งานแล้ว

ชี้ SDK ของคุณไปยัง BasicRouter

ไคลเอนต์ที่เข้ากันได้กับ OpenAI ส่วนใหญ่ต้องการเพียง URL ฐานและคีย์ API ใหม่

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.BASICROUTER_API_KEY,
  baseURL: "https://api.basicrouter.ai/api/v1"
});

ส่งการเติมแชท

curl --request POST \
  --url https://api.basicrouter.ai/api/v1/chat/completions \
  --header "Authorization: Bearer $BASICROUTER_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "model": "claude-sonnet-5",
    "messages": [
      { "role": "user", "content": "Explain BasicRouter in one sentence." }
    ]
  }'

ตรวจสอบการใช้งานและยอดคงเหลือ

curl --request GET \
  --url https://api.basicrouter.ai/api/v1/billing/balance \
  --header "Authorization: Bearer $BASICROUTER_API_KEY"

การค้นพบโมเดล

ใช้หน้าโมเดลหรือ Models API เพื่อตรวจสอบโมเดลข้อความที่พร้อมใช้งาน ข้อมูลเมตาของโมเดล รวมถึงผู้ผลิต ผู้ให้บริการ รูปแบบ ความยาวบริบท ตระกูล API ที่รองรับ ความสามารถที่รองรับ ความพร้อมใช้งาน ขีดจำกัดระดับบัญชี และราคาเครดิต

จุดเชื่อมต่อ: GET /v1/models วัตถุประสงค์: แสดงรายการโมเดลที่พร้อมใช้งานสำหรับบัญชีปัจจุบัน

curl --request GET \
  --url https://api.basicrouter.ai/api/v1/models \
  --header "Authorization: Bearer $BASICROUTER_API_KEY"

ตารางความสามารถ

ความสามารถ	คำอธิบาย	ใช้โดยทั่วไปโดย
`streaming`	รองรับการสตรีมเหตุการณ์ที่ส่งโดยเซิร์ฟเวอร์	แอปแชท, ตัวแทนเขียนโค้ด, UX แบบเรียลไทม์
`tool_calling`	รองรับการเรียกเครื่องมือหรือฟังก์ชัน	ตัวแทน, ระบบอัตโนมัติเวิร์กโฟลว์, ผู้ช่วยเขียนโค้ด
`structured_outputs`	รองรับเอาต์พุตที่จำกัดด้วยสคีมาหรือ JSON	การสกัดข้อมูล, ระบบอัตโนมัติเวิร์กโฟลว์, แอปองค์กร
`json_mode`	สามารถส่งคืนเอาต์พุตในรูปแบบ JSON	การตอบกลับแบบโครงสร้างน้ำหนักเบา
`vision`	รับอินพุตรูปภาพ	แชทหลายรูปแบบ, การวิเคราะห์ UI, ภาพหน้าจอเอกสาร
`prompt_caching`	รองรับอินพุตแคชหรือการนำบริบทกลับมาใช้ใหม่	ตัวแทนบริบทยาว, พร้อมต์ระบบที่ใช้ซ้ำ
`reasoning`	รองรับการควบคุมการให้เหตุผลอย่างชัดเจนเมื่อมี	การวางแผนที่ซับซ้อน, การเขียนโค้ด, เวิร์กโฟลว์การวิเคราะห์
`logprobs`	รองรับเอาต์พุตความน่าจะเป็นของโทเค็น	การประเมิน, การจัดอันดับ, เวิร์กโฟลว์ NLP ขั้นสูง

ตารางความเข้ากันได้ของตระกูล API

ตระกูล API	ข้อความ	อินพุตภาพ	การเรียกเครื่องมือ	เอาต์พุตแบบโครงสร้าง	การสตรีม	หมายเหตุ
OpenAI Chat Completions	ใช่	ขึ้นอยู่กับโมเดล	ขึ้นอยู่กับโมเดล	ขึ้นอยู่กับโมเดล	ใช่	ค่าเริ่มต้นที่ดีที่สุดสำหรับตัวแทนและ SDK ที่เข้ากันได้กับ OpenAI
OpenAI Responses	ใช่	ขึ้นอยู่กับโมเดล	ขึ้นอยู่กับโมเดล	ขึ้นอยู่กับโมเดล	ใช่	แนะนำสำหรับเวิร์กโฟลว์ตัวแทนสไตล์ OpenAI รุ่นใหม่
Anthropic Messages	ใช่	ขึ้นอยู่กับโมเดล	ขึ้นอยู่กับโมเดล	ขึ้นอยู่กับโมเดล	ใช่	ดีที่สุดสำหรับไคลเอนต์ที่เข้ากันได้กับ Claude และ Claude Code
Gemini OpenAI compatibility	ใช่	ขึ้นอยู่กับโมเดล	ขึ้นอยู่กับโมเดล	ขึ้นอยู่กับโมเดล	ใช่	ใช้โมเดล Gemini ผ่านไคลเอนต์สไตล์ OpenAI
Gemini native compatibility	ใช่	ขึ้นอยู่กับโมเดล	ขึ้นอยู่กับโมเดล	ขึ้นอยู่กับโมเดล	ใช่	ดีที่สุดสำหรับแอปพลิเคชัน Gemini-native ที่มีอยู่
BasicRouter image generation	ไม่	ขึ้นอยู่กับโมเดล	ไม่	ไม่	ไม่	ใช้การโพลงานอะซิงโครนัสหรือเว็บฮุก
BasicRouter video generation	ไม่	ขึ้นอยู่กับโมเดล	ไม่	ไม่	ไม่	ใช้การโพลงานอะซิงโครนัสหรือเว็บฮุก

การรับรองความถูกต้อง

คำขอ API ทุกรายการใช้โทเค็นผู้ถือ เก็บคีย์ในตัวแปรสภาพแวดล้อมฝั่งเซิร์ฟเวอร์ หมุนเวียนเมื่อการเข้าถึงของทีมเปลี่ยนแปลง และบันทึกรหัสคำขอเพื่อการดีบัก

ส่วนหัว	ค่า	หมายเหตุ
`Authorization`	`Bearer YOUR_API_KEY`	จำเป็นสำหรับทุกคำขอ
`Content-Type`	`application/json`	จำเป็นสำหรับเนื้อหาคำขอ JSON

ข้อแนะนำด้านความปลอดภัยของคีย์

เก็บคีย์ API ไว้บนเซิร์ฟเวอร์ อย่าเปิดเผยคีย์ในโค้ดเบราว์เซอร์หรือไคลเอนต์มือถือ
ใช้คีย์แยกกันสำหรับการพัฒนา การจัดเตรียม การผลิต และการรวมระบบของบุคคลที่สาม
กำหนดขอบเขตคีย์ตามสภาพแวดล้อม บริการ ลูกค้า หรือผู้เช่าเมื่อมีให้
หมุนเวียนคีย์หลังพนักงานลาออก การเปลี่ยนแปลงสิทธิ์การเข้าถึงของผู้จำหน่าย หรือเมื่อสงสัยว่ามีการรั่วไหล
เก็บคีย์ในตัวจัดการความลับหรือตัวแปรสภาพแวดล้อม ไม่ใช่โค้ดต้นฉบับ

การใช้งานคอนโซล

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

การจัดการคีย์ API

สร้าง หมุนเวียน เพิกถอน และติดป้ายกำกับคีย์ API จากคอนโซล ใช้คีย์แยกสำหรับ การพัฒนา การจัดเตรียม การผลิต และบริการแต่ละรายการ เพื่อให้สามารถตรวจสอบและ แยกการใช้งานตามสภาพแวดล้อมหรือแอปพลิเคชัน

แนวปฏิบัติ	คำอธิบาย
แยกสภาพแวดล้อม	ใช้คีย์ API คนละชุดสำหรับทราฟฟิกการพัฒนา การจัดเตรียม และการผลิต
ใช้ป้ายกำกับที่สื่อความหมาย	ติดป้ายกำกับคีย์ตามแอปพลิเคชัน บริการ สภาพแวดล้อม หรือการรวมระบบ
หมุนเวียนเป็นประจำ	หมุนเวียนคีย์เมื่อสิทธิ์การเข้าถึงเปลี่ยนแปลงหรือข้อมูลรับรองอาจถูกเปิดเผย
หลีกเลี่ยงการเปิดเผยฝั่งไคลเอนต์	เก็บคีย์ API ไว้บนระบบฝั่งเซิร์ฟเวอร์เท่านั้น อย่าเปิดเผยคีย์ในโค้ดเบราว์เซอร์หรือไคลเอนต์มือถือ
ติดตามการใช้งานคีย์	ตรวจสอบปริมาณคำขอ การใช้เครดิต และรูปแบบข้อผิดพลาดตามคีย์

รายการโมเดล

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

ตัวกรอง	วัตถุประสงค์
ผู้ผลิต	กรองตามผู้ผลิตโมเดล เช่น OpenAI, Anthropic, Google, Qwen, DeepSeek หรือผู้ให้บริการรายอื่น
ผู้ให้บริการ	กรองตามผู้ให้บริการหรือผู้ให้บริการคลาวด์
รูปแบบ	กรองตามการรองรับข้อความ ภาพ วิดีโอ การฝัง เสียง หรือหลายรูปแบบ
ความสามารถ	กรองตามการรองรับการสตรีม การเรียกเครื่องมือ เอาต์พุตแบบโครงสร้าง วิชัน การแคชพร้อมต์ หรือการให้เหตุผล
ความพร้อมใช้งาน	ระบุโมเดลที่พร้อมใช้งานสำหรับบัญชีปัจจุบัน

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

การใช้งาน & บันทึก

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

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

การตอบกลับ API แต่ละรายการรวมหรือเปิดเผยรหัสคำขอ BasicRouter เก็บรหัสนี้ใน บันทึกแอปพลิเคชันของคุณเพื่อให้การดีบักการผลิตและการขยายการสนับสนุนมีประสิทธิภาพมากขึ้น

การสำรอง

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

การรับประกันความพร้อมใช้งานสูง
Fallback acts like a safety net, keeping your application running smoothly even when a model failure, quota limit, or network fluctuation occurs.

ทำไมการสำรองจึงสำคัญ

ในการผลิต บริการโมเดลอาจประสบปัญหาที่คาดเดาไม่ได้หลายประการ:

ความล้มเหลวของบริการโมเดล: API ต้นน้ำกลายเป็น ไม่พร้อมใช้งานชั่วคราวหรือหมดเวลา
การผันผวนของประสิทธิภาพ: โหลดโมเดลสูงนำไปสู่การตอบกลับ ช้าหรือล้มเหลว
ความล้มเหลวของการกำหนดเส้นทาง: โมเดลผู้สมัครทั้งหมดที่เลือกโดยการกำหนดเส้นทางอัจฉริยะ กลายเป็นไม่พร้อมใช้งาน

การสำรองทำให้แอปพลิเคชันของคุณพร้อมใช้งานโดยให้เส้นทางสำรองที่เชื่อถือได้

ข้อได้เปรียบหลัก

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

การกำหนดค่าโมเดลสำรองทั่วไป

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

วิธีการกำหนดค่า:

Go to the หน้าการตั้งค่ากลยุทธ์ BasicRouter.
ค้นหาการตั้งค่า โมเดลสำรองเริ่มต้น
เลือกโมเดลสำรองทั่วไปจากรายการแบบเลื่อนลง
บันทึกการตั้งค่าเพื่อใช้ทันที

ข้อได้เปรียบของการกำหนดค่าทั่วไป:

ไม่ต้องเปลี่ยนแปลงโค้ด: กำหนดค่าครั้งเดียวและใช้ทั่วโลก โดยไม่ต้องทำซ้ำการตั้งค่าในทุกคำขอ
การจัดการแบบรวมศูนย์: จัดการนโยบายสำรองในที่เดียวเพื่อ การปรับเปลี่ยนและการติดตามที่ง่ายขึ้น
การบำรุงรักษาที่ง่ายขึ้น: ลดความซับซ้อนของโค้ดและโอกาส เกิดข้อผิดพลาดในการกำหนดค่า
การแทนที่ที่ยืดหยุ่น: การกำหนดค่าสำรองระดับคำขอมี ลำดับความสำคัญสูงกว่าและสามารถแทนที่การตั้งค่าทั่วไปสำหรับสถานการณ์เฉพาะ

การกำหนดค่าสำรองระดับคำขอ

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

ระบุโมเดลสำรองด้วยพารามิเตอร์ router.fallBackModels:

{
  "model": "claude-sonnet-4",
  "messages": [
    {
      "role": "user",
      "content": "Explain what quantum computing is"
    }
  ],
  "router": {
    "fallBackModels": ["glm-5.2"]
  }
}

กฎลำดับความสำคัญ

เมื่อมีการกำหนดค่าสำรองหลายรายการ ลำดับความสำคัญจะทำงานจากสูงสุดไปยัง ต่ำสุด:

ระดับคำขอ router.fallBackModels: โมเดลสำรองที่ระบุในคำขอแต่ละรายการ
โมเดลสำรองเริ่มต้นทั่วไป: โมเดลสำรองทั่วไปที่กำหนดค่า ในคอนโซล
ไม่มีการสำรอง: หากไม่ได้กำหนดค่าทั้งสองอย่าง คำขอจะส่งกลับข้อผิดพลาด เมื่อล้มเหลว

⚠ หมายเหตุสำคัญ

หากโมเดลสำรองทั้งหมดล้มเหลว ระบบจะส่งกลับเหตุผลความล้มเหลวจาก โมเดลสุดท้ายที่ลอง
เมื่อเกิดการสำรอง การตอบกลับจะระบุโมเดลที่ใช้จริง ทำให้ ง่ายต่อการติดตามและวิเคราะห์

การบริหารบัญชี

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

รายการตรวจสอบการดำเนินงานการผลิต

รายการ	ข้อแนะนำ
คีย์ API	ใช้คีย์การผลิตเฉพาะที่มีป้ายกำกับชัดเจน
โมเดล	ยืนยันความพร้อมใช้งานของโมเดล ราคา ความยาวบริบท และความสามารถที่จำเป็น
การกำหนดเส้นทาง	กำหนดค่าชื่อแทนการกำหนดเส้นทางหรือนโยบายการสำรองสำหรับงานที่สำคัญ
บันทึก	ตรวจสอบให้รหัสคำขอถูกบันทึกในบันทึกแอปพลิเคชัน
การเรียกเก็บเงิน	ยืนยันยอดคงเหลือกระเป๋าเงิน สถานะแผน และกฎการหักเครดิต
ขีดจำกัดอัตรา	ตรวจสอบขีดจำกัด RPM, TPM, การทำงานพร้อมกัน และงานสื่อระดับบัญชี
การแจ้งเตือน	ติดตามการเติบโตของการใช้งาน ยอดคงเหลือเครดิต ข้อผิดพลาด และความพร้อมใช้งานของผู้ให้บริการ

การเรียกเก็บเงิน & เครดิต

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

ราคาโมเดลโดยละเอียดมีให้ในหน้าโมเดลหรือผ่าน API ข้อมูลเมตาของโมเดล ราคาอาจแตกต่างกันตามโมเดล ผู้ให้บริการ รูปแบบ ความละเอียด ประเภทโทเค็น ความยาวเอาต์พุต ระยะเวลางาน ประเภทบัญชี และข้อตกลงเชิงพาณิชย์

เติมเงิน & กระเป๋าเงิน

บัญชีสามารถเพิ่มเครดิตกระเป๋าเงินจ่ายตามการใช้งานสำหรับการใช้งานที่ยืดหยุ่น เครดิตกระเป๋าเงิน ใช้หลังจากเครดิตแผนรายเดือนและแพ็กเกจทรัพยากรถูกใช้หมด ยกเว้นกฎการเรียกเก็บเงิน แบบกำหนดเองที่ใช้กับบัญชี

เครดิตกระเป๋าเงินไม่หมดอายุ เว้นแต่ระบุไว้เป็นอย่างอื่นในเงื่อนไขทางพาณิชย์ที่บังคับใช้ มีค่าธรรมเนียมบริการเมื่อเติมเงินกระเป๋าเงินจ่ายตามการใช้งาน

แผนรายเดือนและแพ็กเกจทรัพยากร

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

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

ลำดับการหักเงิน

เว้นแต่จะกำหนดค่ากฎการเรียกเก็บเงินแบบกำหนดเอง เครดิตจะถูกหักใน ลำดับต่อไปนี้:

ลำดับความสำคัญ	แหล่งเครดิต	คำอธิบาย
1	แผนรายเดือน	ความจุการใช้งานรายเดือนที่รวมถูกใช้ก่อน
2	แพ็กเกจทรัพยากร	แพ็กเกจที่ซื้อเพิ่มถูกใช้หลังเครดิตแผนรายเดือน
3	กระเป๋าเงินจ่ายตามการใช้งาน	ยอดคงเหลือกระเป๋าเงินถูกใช้หลังเครดิตแผนและแพ็กเกจทรัพยากร

สำหรับบัญชีที่มีเงื่อนไขทางพาณิชย์แบบกำหนดเอง ลำดับการหักเงิน กฎการหมดอายุ การใช้งาน ที่รวม และราคาอาจแตกต่างกัน กฎเฉพาะบัญชีจะแสดงในคอนโซลหรือ ระบุผ่านข้อตกลงทางพาณิชย์

ราคาที่กำหนดเอง

ราคาสามารถกำหนดเองสำหรับผู้ใช้หรือบัญชีแต่ละราย ลูกค้าองค์กร บัญชีผู้ค้าต่อ บัญชีผู้แจกจ่าย และลูกค้าที่ใช้ปริมาณมากอาจมีสิทธิ์ได้รับราคา กำหนดเอง ติดต่อฝ่ายขายเพื่อขอราคา

ราคากำหนดเองสามารถกำหนดค่าตามบัญชี โมเดล ผู้ให้บริการ รูปแบบ ภูมิภาค ปริมาณ การใช้งาน หรือข้อตกลงทางพาณิชย์ เมื่อเปิดใช้งานราคากำหนดเอง คอนโซลและ API การเรียกเก็บเงินจะแสดงราคาและกฎการหักเงินเฉพาะบัญชีเมื่อมี

หน่วยราคา

โมดอลิตี้โมเดลที่แตกต่างกันใช้หน่วยวัดที่แตกต่างกัน BasicRouter แปลง หน่วยเหล่านี้เป็นเครดิตตามกฎการกำหนดราคาของโมเดล

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

หน่วยราคาอาจแตกต่างกันตามโมเดล โปรดดูหน้ารายละเอียดโมเดลหรือข้อมูลเมตา ราคาก่อนเปิดใช้งานโมเดลในการผลิตเสมอ

การระบุแหล่งที่มาการใช้งาน

การใช้งาน BasicRouter สามารถตรวจสอบได้ตามบัญชี คีย์ API โมเดล รูปแบบ หรือช่วงเวลา ซึ่งช่วยให้ทีมสามารถระบุต้นทุนให้กับแอปพลิเคชัน สภาพแวดล้อม ลูกค้า หรือ หน่วยธุรกิจภายใน

มิติข้อมูล	คำอธิบาย
คีย์ API	จัดกลุ่มการใช้งานตามแอปพลิเคชัน บริการ หรือสภาพแวดล้อม
โมเดล	เปรียบเทียบต้นทุนและปริมาณตามโมเดลที่เลือก
โมเดลที่ใช้จริง	ตรวจสอบโมเดลจริงที่ใช้หลังการกำหนดเส้นทางหรือการสำรอง
รูปแบบ	แยกการใช้งานข้อความ ภาพ วิดีโอ การฝัง และเสียง
ช่วงเวลา	ตรวจสอบรอบการรายงานรายวัน รายเดือน หรือกำหนดเอง
ข้อมูลเมตา	จัดกลุ่มการใช้งานตามข้อมูลเมตาคำขอแบบกำหนดเอง เช่น รหัสลูกค้า รหัสผู้เช่า รหัสผู้ใช้ หรือสภาพแวดล้อม

ยอดเครดิตคงเหลือ

ตรวจสอบจำนวนเครดิตที่พร้อมใช้งานในบัญชีของคุณ ยอดคงเหลือถูกแบ่งเป็น กระเป๋าเงินสามใบที่หักตามลำดับ: เงินช่วยเหลือแผนรายเดือน แพ็กเกจทรัพยากรที่ซื้อ และกระเป๋าเงินจ่ายตามการใช้งาน ยอดรวมทรัพยากรรวม (แผนรายเดือน + แพ็กเกจ ทรัพยากร ไม่รวมจ่ายตามการใช้งาน) ยังมีให้สำหรับติดตามการใช้งานที่รวมแยกจาก การใช้จ่ายเติมเงิน

เพื่อดึงข้อมูลนี้โดยใช้โปรแกรม ดู GET /v1/billing/balance ใน การอ้างอิง API

รายละเอียดการใช้งาน

ตรวจสอบรายการการใช้งานแต่ละรายการแบบแบ่งหน้าตามลำดับเวลาสำหรับการรายงาน การติดตาม และการจัดสรรต้นทุนภายใน แต่ละรายการแสดงโมเดล ประเภทโมเดล (ข้อความ ภาพ หรือวิดีโอ) เครดิตที่หัก และรายละเอียดว่าการหักแต่ละรายการถูกหักจากกระเป๋าเงินใด ผลลัพธ์สามารถกรองตามช่วงเวลาเฉพาะ

เพื่อดึงข้อมูลนี้โดยใช้โปรแกรม ดู GET /v1/usage ใน การอ้างอิง API

ประวัติธุรกรรม

ใช้ประวัติธุรกรรมเพื่อตรวจสอบการเคลื่อนไหวของเครดิต รวมถึงการเติมเงิน การจัดสรร แผน การให้แพ็กเกจทรัพยากร การหักการใช้งาน การปรับ และการแก้ไข ทางการบริหาร

เพื่อดึงข้อมูลนี้โดยใช้โปรแกรม ดู GET /v1/billing/transactions ใน การอ้างอิง API

คำขอที่ล้มเหลวและการคืนเงิน

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

สำหรับงานภาพและวิดีโออะซิงโครนัส พฤติกรรมการเรียกเก็บเงินขึ้นอยู่กับว่างานถูก ยอมรับ เริ่ม เสร็จสิ้น ล้มเหลว หรือยกเลิก การตอบกลับรายละเอียดงานรวม ข้อมูลการใช้งานเมื่อเครดิตถูกใช้

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

การดำเนินงาน

ข้อผิดพลาด

BasicRouter ส่งคืนรหัสข้อผิดพลาดที่เสถียรเพื่อให้แอปพลิเคชันสามารถจัดการการลองใหม่ การสำรอง ปัญหาการเรียกเก็บเงิน และการดีบักได้อย่างสม่ำเสมอ

จุดเชื่อมต่อที่เข้ากันได้กับผู้ให้บริการจะพยายามรักษารูปร่างข้อผิดพลาด ของตระกูล API ต้นฉบับเมื่อเป็นไปได้ จุดเชื่อมต่อ BasicRouter-native ใช้ออบเจ็กต์ข้อผิดพลาด BasicRouter

การแมปสถานะ HTTP และรหัสข้อผิดพลาด

สถานะ HTTP	ประเภทข้อผิดพลาด	รหัสตัวอย่าง	ลองใหม่
400	`invalid_request_error`	`invalid_request`, `unsupported_parameter`, `invalid_messages`, `invalid_image_url`	ไม่
401	`authentication_error`	`missing_api_key`, `invalid_api_key`	ไม่
402	`billing_error`	`insufficient_credits`, `payment_required`, `quota_exceeded`	ไม่
403	`permission_error`	`model_access_denied`, `endpoint_access_denied`, `key_scope_denied`	ไม่
404	`not_found_error`	`model_not_found`, `response_not_found`, `task_not_found`	ไม่
408	`timeout_error`	`gateway_timeout`, `provider_timeout`	ใช่
409	`conflict_error`	`idempotency_conflict`, `task_already_cancelled`	ขึ้นอยู่กับ
422	`validation_error`	`schema_validation_failed`, `unsupported_modality`	ไม่
429	`rate_limit_error`	`account_rpm_exceeded`, `account_tpm_exceeded`, `provider_rate_limited`	ใช่
500	`internal_error`	`internal_error`	ใช่
502	`provider_error`	`provider_bad_gateway`, `provider_invalid_response`	ใช่
503	`service_unavailable`	`model_unavailable`, `provider_unavailable`, `insufficient_capacity`	ใช่
504	`timeout_error`	`provider_timeout`, `gateway_timeout`	ใช่

รหัสข้อผิดพลาดทั่วไป

รหัส	ความหมาย	การดำเนินการที่แนะนำ
`missing_api_key`	ไม่ได้ระบุคีย์ API	เพิ่มส่วนหัว `Authorization`
`invalid_api_key`	คีย์ API ไม่ถูกต้องหรือถูกเพิกถอน	สร้างหรือหมุนเวียนคีย์ API
`model_not_found`	รหัสโมเดลไม่มีอยู่หรือไม่ได้เปิดใช้งานสำหรับบัญชี	ตรวจสอบหน้าโมเดลหรือเรียก `GET /v1/models`
`model_access_denied`	คีย์ API หรือบัญชีไม่มีสิทธิ์เข้าถึงโมเดล	เปิดใช้งานโมเดลหรือติดต่อผู้ดูแล
`unsupported_parameter`	คำขอมีพารามิเตอร์ที่ไม่รองรับโดยเอนด์พอยต์หรือโมเดลที่เลือก	ลบพารามิเตอร์หรือเลือกโมเดลที่เข้ากันได้
`unsupported_modality`	รูปแบบอินพุตหรือเอาต์พุตไม่ได้รับการรองรับโดยโมเดลที่เลือก	เลือกโมเดลที่รองรับรูปแบบ
`account_rpm_exceeded`	เกินขีดจำกัดคำขอต่อนาทีของบัญชี	ลองใหม่ด้วยการถดถอยหรือขอขีดจำกัดที่สูงขึ้น
`account_tpm_exceeded`	เกินขีดจำกัดโทเค็นต่อนาทีของบัญชี	ลองใหม่ด้วยการถดถอย ลดโทเค็น หรือขอขีดจำกัดที่สูงขึ้น
`provider_rate_limited`	ผู้ให้บริการอัปสตรีมจำกัดอัตราคำขอ	ลองใหม่หรือเปิดใช้งานการสำรอง
`insufficient_credits`	บัญชีมีเครดิตไม่เพียงพอ	เติมเงินกระเป๋าเงิน ซื้อแพ็กเกจ หรืออัปเกรดแผน
`provider_timeout`	ผู้ให้บริการอัปสตรีมไม่ตอบกลับในเวลาที่กำหนด	ลองใหม่หรือเปิดใช้งานการสำรอง
`model_unavailable`	โมเดลไม่พร้อมใช้งานชั่วคราว	ลองใหม่หรือใช้นามแฝงการกำหนดเส้นทาง
`content_policy_error`	คำขอหรือเอาต์พุตถูกบล็อกโดยนโยบายความปลอดภัย	แก้ไขอินพุตหรือเลือกเวิร์กโฟลว์ที่เหมาะสม