กลับไปที่บล็อก

เครื่องมือและการเชื่อมต่อคู่มือ

เชื่อมต่อ OpenHands กับ CheapTokens: โมเดล, Base URL, คีย์

กรอกสามช่องใน OpenHands Settings > LLM (Advanced) เพื่อรันเอเจนต์บนโมเดล CheapTokens และเรียนรู้วิธีอ่านความล้มเหลวที่พบบ่อยสามแบบ

โดย CheapTokens Teamเผยแพร่เมื่อ ใช้เวลาอ่าน 4 นาที

ช่องตั้งค่า OpenHands พร้อม Base URL และ model id ของ CheapTokens
ในหน้านี้
  1. ก่อนเปิด Settings
  2. สามช่อง
  3. ตรวจสอบส่วนประกอบนอก OpenHands ก่อน
  4. หน้าตาเมื่อช่องใดช่องหนึ่งผิด
  5. หนึ่งเซสชันมีค่าใช้จ่ายเท่าไร
  6. ใช้ OpenHands กับผู้ให้บริการรายอื่นอยู่แล้ว?

คุณสามารถรัน OpenHands บนโมเดล CheapTokens ได้โดยกรอกสามช่องใน Settings > LLM หลังจากเปิด Advanced: Custom Model (openai/deepseek-ai/DeepSeek-V4-Flash-0731), Base URL (https://api.cheaptokens.dev/v1) และ API Key เท่านี้ก็เสร็จสิ้นการตั้งค่า ส่วนที่เหลือของหน้านี้คือความหมายของแต่ละช่องและหน้าตาเมื่อมีช่องใดช่องหนึ่งผิด

ชื่อฟิลด์และกฎการตั้งชื่อโมเดลมาจากหน้าเอกสาร OpenHands เกี่ยวกับ endpoint ที่เข้ากันได้กับ OpenAI (ตรวจสอบเมื่อ 8 พฤศจิกายน 2026; หน้านั้นไม่มีวันที่หรือเวอร์ชัน) รุ่นล่าสุดของ OpenHands ณ วันนั้นคือ v1.37.0 (6 พฤศจิกายน 2026) หากป้ายชื่อในบิลด์ของคุณดูแตกต่างเล็กน้อย ให้ยึดตามตำแหน่ง: โมเดล, base URL, คีย์

ก่อนเปิด Settings#

การเตรียมสามอย่างไว้จะช่วยให้คุณไม่ต้องย้อนกลับมาใหม่: คีย์, model id และการเข้าถึง Settings

เช็กลิสต์

พร้อมตั้งค่าหรือยัง?

เพิ่งเริ่มใช้คีย์และ base URL? base_url คืออะไรและวิธีสลับ อธิบายไว้ในไม่กี่นาที และ list models ด้วย GET /v1/models แสดงวิธีค้นหา id ด้วยตัวเอง

สามช่อง#

เปิด Settings > LLM แล้วเปิด Advanced ช่อง Base URL อยู่ใต้ปุ่มสลับ Advanced

ค่าทั้งสามสำหรับ OpenHands Settings > LLM (Advanced)
แผนภาพของค่า ไม่ใช่ภาพหน้าจอ: อะไรใส่ในแต่ละช่องทั้งสาม ช่องคีย์เป็นตัวแทน

เอกสารอธิบายกฎของโมเดลไว้ดังนี้: Custom Model คือ openai/ ตามด้วยชื่อโมเดล และหากคุณผ่านพร็อกซีที่มีคำนำหน้าของตัวเอง ให้ใช้ openai/<proxy-prefix>/<model-name> ส่วนที่อยู่หลัง openai/ คือชื่อโมเดล สำหรับ CheapTokens id คือ deepseek-ai/DeepSeek-V4-Flash-0731 ดังนั้นสตริงเต็มคือ openai/deepseek-ai/DeepSeek-V4-Flash-0731

Field Value
Custom Model openai/deepseek-ai/DeepSeek-V4-Flash-0731
Base URL https://api.cheaptokens.dev/v1
API Key คีย์ CheapTokens ของคุณ

ทำไมต้องใช้โมเดลนี้กับเอเจนต์? DeepSeek-V4-Flash มีหน้าต่างบริบท 380K และเอาต์พุตได้สูงสุด 32,768 โทเค็นต่อคำตอบ และราคาเดียวทุกชั่วโมง เซสชันยาวจึงไม่แพงขึ้นในช่วงพีค เอเจนต์เขียนโค้ดส่งบริบทซ้ำจำนวนมากในทุกขั้นตอน และนั่นคือสิ่งที่หน้าต่างบริบทมีไว้รองรับ

ชอบ GLM มากกว่า? ใช้ openai/zai-org/GLM-5.3-Flash (บริบท 390K, เอาต์พุตสูงสุด 8,192 โทเค็น) ในช่องเดียวกันและไม่ต้องเปลี่ยนอย่างอื่น ยอดเงินเดิม คีย์เดิม Base URL เดิม

ตรวจสอบส่วนประกอบนอก OpenHands ก่อน#

ก่อนจะโทษเอเจนต์ ให้ส่งคำขอหนึ่งครั้งด้วย URL, คีย์ และ id เดียวกัน หากคำขอนี้ทำงานได้ ปัญหาที่เหลืออยู่คือวิธีที่คุณพิมพ์ในช่องต่างๆ

bash
curl https://api.cheaptokens.dev/v1/chat/completions \
  -H "Authorization: Bearer $CHEAPTOKENS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"deepseek-ai/DeepSeek-V4-Flash-0731","messages":[{"role":"user","content":"Say ready"}],"max_tokens":20}'

สังเกตว่าอะไรหายไป: ไม่มี openai/ ในค่า model คำนำหน้านั้นมีไว้สำหรับ OpenHands ไม่ใช่สำหรับ API คำตอบมีบล็อก usage พร้อม prompt_tokens และ completion_tokens — ตัวเลขสองตัวเดียวกับที่คุณจะเห็นสะสมตลอดเซสชันของเอเจนต์

เปรียบเทียบ

สตริงโมเดล: คำนำหน้าหนึ่ง ผลลัพธ์สองแบบ

เฉพาะ id

deepseek-ai/DeepSeek-V4-Flash-0731 — รูปแบบสำหรับ curl และ API

พร้อมคำนำหน้า

openai/deepseek-ai/DeepSeek-V4-Flash-0731 — รูปแบบสำหรับช่อง Custom Model

หน้าตาเมื่อช่องใดช่องหนึ่งผิด#

แต่ละช่องทั้งสามอาจเป็นสาเหตุได้:

แต่ละข้อผิดพลาดชี้ไปที่ใด: คีย์, Base URL, สตริงโมเดล
อาการไปยังช่อง: 401 ชี้ไปที่คีย์, 404 ชี้ไปที่ Base URL หรือสตริงโมเดล
  • คีย์ผิด API ตอบ 401 — คีย์หาย พิมพ์ผิด หรือมีช่องว่างต่อท้ายจากการคัดลอก
  • Base URL ผิด คำขอไปผิดที่และคุณจะได้ 404 หรือข้อผิดพลาดการเชื่อมต่อ ที่อยู่ต้องลงท้ายด้วย /v1 และไม่มีพาธเพิ่มเติม
  • สตริงโมเดลผิด อาจขาดคำนำหน้า หรือ id ที่ตามมาไม่ใช่ id เต็ม (API ยอมรับเฉพาะ gateway_id เต็ม ไม่ใช่ id สั้นอย่าง deepseek-v4-flash-0731)

เหตุผลทั้งหมดสำหรับ 401 กับ 404 อยู่ใน API 401 หรือ 404: คีย์, base URL หรือ model id ผิด

ลองด้วยตัวเองลองดู: คีย์ถูก URL ถูก แต่เอเจนต์ยังล้มเหลวที่ขั้นตอนแรก คุณจะเปิดช่องไหน?แสดงคำตอบ

ช่อง Custom Model ตรวจสอบว่าขึ้นต้นด้วย openai/ และ id ที่ตามมาสะกดตรงกับตารางด้านบนทุกตัวอักษร คีย์และ URL เป็นสิ่งที่ตรวจสอบด้วย curl ได้ง่าย

หนึ่งเซสชันมีค่าใช้จ่ายเท่าไร#

เอเจนต์คิดเงินสำหรับบริบททั้งหมดในทุกขั้นตอน ไม่ใช่แค่งานบรรทัดเดียวของคุณ สมมติว่า OpenHands แก้บั๊ก 40 ขั้นตอน โดยส่งประมาณ 30,000 โทเค็นเข้าและเขียนกลับ 1,500 โทเค็นต่อขั้นตอน หนึ่งขั้นตอนบน DeepSeek-V4-Flash คือ $0.0006 สี่สิบขั้นตอนอยู่ด้านล่าง เทียบกับโมเดลอื่นและ OpenRouter

โมเดล ต่อคำขอ 40 คำขอ OpenRouter, 40 คำขอ
GLM-5.3-Flash $0.00066 $0.0264 $0.0452
DeepSeek-V4-Flash $0.0006 $0.024 $0.0924
MiniMax-M2.7 $0.0017 $0.069 $0.828

30,000 โทเค็นอินพุตและ 1,500 โทเค็นเอาต์พุตต่อคำขอ ราคาต่อ 1M โทเค็นเป็นราคาปัจจุบันและเปลี่ยนแปลงไปพร้อมกับอัตราค่าบริการของเรา คอลัมน์ OpenRouter แสดงราคาอ้างอิงสำหรับปริมาณงานเดียวกัน

โดยรวม เมื่อนับอินพุตและเอาต์พุตรวมกัน DeepSeek-V4-Flash ถูกกว่า OpenRouter สำหรับภาระงานนี้ สมมติฐานเป็นของคุณที่จะปรับ: การแก้สั้นๆ อาจใช้ 10 ขั้นตอน การรีแฟกเตอร์ใหญ่ 100 ราคาปัจจุบันอยู่ที่ หน้าราคา และหน้าโมเดลคือ DeepSeek ราคาถูก

ใช้ OpenHands กับผู้ให้บริการรายอื่นอยู่แล้ว?#

คุณเพียงสลับสามค่า: Custom Model, Base URL, API Key ไม่มีอย่างอื่นในโปรเจกต์เปลี่ยน และคุณสลับกลับได้ด้วยวิธีเดียวกัน ขั้นตอนการเชื่อมต่อสำหรับ API เองอยู่ใน เอกสาร CheapTokens การตั้งค่าที่คล้ายกันในเครื่องมืออื่นคือ เชื่อมต่อ Aider