ใช้ OpenCode กับ free LLM API
OpenCode เป็นเอเจนต์เขียนโค้ดโอเพนซอร์สสำหรับเทอร์มินัลและเดสก์ท็อป รองรับผู้ให้บริการที่เข้ากันได้กับ OpenAI ทุกราย คู่มือนี้เชื่อมต่อ OpenCode กับโมเดลฟรีผ่าน FreeLLMAPI คำสั่งเดียวเขียนการตั้งค่าและบันทึกคีย์
โค้ด ชื่อโมเดล และป้ายกำกับของแคตตาล็อกสดจะแสดงเป็นภาษาอังกฤษ
ขั้นตอนที่ 1: ติดตั้ง FreeLLMAPI
FreeLLMAPI เป็นเกตเวย์โอเพนซอร์ส ทำงานบนคอมพิวเตอร์ของคุณด้วย Docker และรวมระดับฟรีของผู้ให้บริการ 45 ราย ไว้หลังคีย์เดียว
ติดตั้งบน macOS หรือ Linux
curl -fsSL https://freellmapi.co/install.sh | bashเปิด http://localhost:3001 เพิ่มคีย์ผู้ให้บริการฟรีอย่างน้อยสองรายในหน้า Keys Google AI Studio และ Groq แต่ละรายให้คีย์ฟรีภายในไม่กี่นาที คัดลอกคีย์รวมของคุณจากหน้าเดียวกัน
ขั้นตอนที่ 2: เชื่อม OpenCode ด้วยคำสั่งเดียว
คำสั่งเดียว
npx freellmapi setup-opencode --url http://localhost:3001 --api-key <unified-key> --dry-run
npx freellmapi setup-opencode --url http://localhost:3001 --api-key <unified-key>
opencodeคำสั่งนี้ทำสามอย่าง:
- เพิ่มผู้ให้บริการ
freellmapiลงใน~/.config/opencode/opencode.jsonผู้ให้บริการแสดงรายการโมเดลจากแคตตาล็อกปัจจุบันพร้อมขีดจำกัดบริบท - ตั้ง
freellmapi/autoเป็นโมเดลเริ่มต้น - เก็บคีย์ไว้ในไฟล์ข้อมูลประจำตัวของ OpenCode คือ
~/.local/share/opencode/auth.jsonคุณไม่ต้องใช้ตัวแปรสภาพแวดล้อม ทั้งใน CLI และแอปเดสก์ท็อป
คำสั่งสร้างไฟล์สำรองก่อนเขียน และรวมผู้ให้บริการใหม่เข้ากับการตั้งค่าเดิม ผู้ให้บริการอื่นของคุณจึงยังอยู่ หากตั้งค่า XDG_CONFIG_HOME หรือ XDG_DATA_HOME คำสั่งจะใช้โฟลเดอร์เหล่านั้น
ก่อนเริ่มงานยาว ตรวจว่าเกตเวย์ให้บริการคำขอได้ตอนนี้ การเรียกนี้แสดงเฉพาะโมเดลที่มีคีย์ใช้งานได้ ณ ขณะนี้:
ตรวจสอบว่าโมเดลใดพร้อมใช้งาน
curl "http://localhost:3001/v1/models?execution_status=ready" \
-H "Authorization: Bearer <unified-key>"โมเดลที่มีสถานะ exhausted มีคีย์ แต่ทุกคีย์ถึงขีดจำกัดแล้ว สถานะนี้จะหายไปเมื่อช่วงพักการใช้งานสิ้นสุด รัน npx freellmapi doctor เพื่อตรวจว่าคำขอของไคลเอนต์ไปถึงเกตเวย์ บันทึกคำขอในแดชบอร์ดแสดงแต่ละการเรียกจาก OpenCode header การตอบกลับ X-Routed-Via ระบุผู้ให้บริการและโมเดลที่ตอบแต่ละคำขอ หากคำขอถูกย้ายไปรายอื่น header X-Fallback-Trail ระบุแต่ละขั้นที่ล้มเหลวและเหตุผล
การตั้งค่าด้วยตนเอง: บล็อกผู้ให้บริการใน opencode.json
หากต้องการตั้งค่าด้วยตนเอง ให้เพิ่มบล็อกนี้ลงใน ~/.config/opencode/opencode.json หรือใน opencode.json ของโปรเจกต์ OpenCode ใช้ @ai-sdk/openai-compatible สำหรับ endpoint /v1/chat/completions
opencode.json
{
"$schema": "https://opencode.ai/config.json",
"model": "freellmapi/auto",
"provider": {
"freellmapi": {
"npm": "@ai-sdk/openai-compatible",
"name": "FreeLLMAPI",
"options": {
"baseURL": "http://localhost:3001/v1"
},
"models": {
"auto": {
"name": "Auto",
"limit": { "context": 128000, "output": 8192 }
}
}
}
}
}จากนั้นเพิ่มคีย์ เริ่ม OpenCode รัน /connect เลือกผู้ให้บริการ freellmapi แล้ววางคีย์รวมของคุณ id ของผู้ให้บริการใน /connect ต้องตรงกับ id ในการตั้งค่า รัน /models เพื่อเลือกโมเดล
limit.contextคือจำนวนโทเคนอินพุตสูงสุดของโมเดลlimit.outputคือจำนวนโทเคนสูงสุดที่โมเดลสร้างได้modelระดับบนสุดใช้รูปแบบprovider/modelหากไม่มีค่านี้ OpenCode จะคงโมเดลที่ใช้ก่อนหน้า- Model id ทุกตัวที่คุณต้องการใช้ต้องอยู่ในแผนที่
modelsเพิ่ม id เพิ่มเติมจากGET /v1/models
providers เอกสารระบุว่ารูปแบบ V1 ข้างต้นยังรองรับอยู่ คำสั่งตั้งค่าของ FreeLLMAPI เขียนรูปแบบ V1เลือกโมเดลสำหรับ OpenCode
OpenCode เป็นเอเจนต์ มันอ่านไฟล์ แก้ไขไฟล์ และรันคำสั่งผ่านการเรียกใช้เครื่องมือ แต่ละคำขอมีพรอมต์ระบบ นิยามเครื่องมือ และเนื้อหาไฟล์ ใช้โมเดลที่เรียกใช้เครื่องมือได้และมี context window ขนาดใหญ่
| โมเดล | ฟรีบน | ขนาดบริบท | ขีดจำกัดฟรี (ข้อเสนอที่ดีที่สุด) | เครื่องมือ | การอ่านภาพ |
|---|---|---|---|---|---|
| GLM 5.3 | UnoRouter | 1M | 1 คำขอ/นาที 1 req/min per model | ใช่ | ไม่ |
| GLM 5.3 Flash | NVIDIA NIM, UnoRouter | 1M | 40 คำขอ/นาที 40 RPM | ใช่ | ใช่ |
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | ใช่ | ใช่ |
| Qwen3.8 Flash Next | AMD Radeon Cloud | 262K | Recurring daily account allowance | ใช่ | ไม่ |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | ใช่ | ใช่ |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 คำขอ/นาที 20 คำขอ/วัน 250,000 โทเคน/นาที ~3M | ใช่ | ใช่ |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | ใช่ | ใช่ |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 คำขอ/นาที 50 คำขอ/วัน 50 req/day account-wide (1,000 after a $10 purchase) | ใช่ | ใช่ |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 คำขอ/นาที 50 คำขอ/วัน Shared rate limit | ใช่ | ไม่ |
| Qwen3.8 27B | ElectronHub, Groq, OVH AI Endpoints | 262K | 30 คำขอ/นาที 250 คำขอ/วัน 70,000 โทเคน/นาที ~6M | ใช่ | ใช่ |
| Gemini 3.6 Flash | Google AI Studio | 1M | 10 คำขอ/นาที 20 คำขอ/วัน 250,000 โทเคน/นาที ~3M | ใช่ | ใช่ |
| Qwen 3.8 27B | Cloudflare Workers AI | 262K | Shared 10k neurons/day | ใช่ | ใช่ |
แสดง 12 จาก 109 โมเดลฟรีที่ตรงกัน ดูโมเดลทั้งหมด.
ข้อมูลสดจากแคตตาล็อก FreeLLMAPI (เวอร์ชัน 2026.11.19 ตรวจสอบเมื่อ 2026-11-19) ขีดจำกัดฟรีเปลี่ยนบ่อย แคตตาล็อกถูกตรวจสอบทุกวัน
ใช้ freellmapi/auto เพื่อให้เราเตอร์เลือกโมเดลสำหรับแต่ละคำขอ เพิ่ม auto:smart หรือ auto:fast ลงในแผนที่ models เพื่อกำหนดทิศทางคำขอตามความฉลาดหรือความเร็ว คุณยังเพิ่มโปรไฟล์ที่ตั้งชื่อไว้ได้ เช่น auto:coding หลังจากสร้างโปรไฟล์นั้นในแดชบอร์ด
ขีดจำกัดอัตราและเซสชันยาว
งานของเอเจนต์หนึ่งงานอาจส่งคำขอหลายสิบครั้ง ระดับฟรีเพียงระดับเดียวจะหยุดงานยาวได้อย่างรวดเร็ว FreeLLMAPI นับจำนวนคำขอและโทเคนของแต่ละคีย์ เมื่อผู้ให้บริการส่งข้อผิดพลาด 429 เราเตอร์จะส่งคำขอไปยังโมเดลถัดไปในห่วงโซ่ และเซสชันจะดำเนินต่อ
- เพิ่มคีย์จากผู้ให้บริการสี่รายขึ้นไป ผู้ให้บริการที่มากขึ้นให้คำขอต่อวันที่มากขึ้น
- เปิดการส่งต่อบริบทด้วย
FREELLMAPI_CONTEXT_HANDOFF=on_model_switchในไฟล์.envของ FreeLLMAPI เมื่อโมเดลเปลี่ยน โมเดลถัดไปจะได้รับโน้ตสั้น ๆ ว่ากำลังทำงานต่อจากงานเดิม - เซสชันแบบยึดโมเดลจะคงการสนทนาไว้กับโมเดลเดียวเป็นเวลา 30 นาที ซึ่งช่วยให้เอเจนต์ทำงานสม่ำเสมอ
- เริ่มเซสชันใหม่สำหรับแต่ละงาน บริบทที่เล็กลงใช้โทเคนน้อยลงต่อคำขอ
การแก้ปัญหา
| ปัญหา | สาเหตุ | วิธีแก้ |
|---|---|---|
| "Invalid API key" ทั้งที่คีย์ถูกต้อง | apiKey ที่ว่างเปล่าในการตั้งค่าแทนที่คีย์จาก /connect | ลบ apiKey ออกจาก options หรือรัน setup-opencode อีกครั้ง |
| OpenCode ไม่ใช้ผู้ให้บริการใหม่ | ยังไม่ได้ตั้ง model ระดับบนสุด | ตั้งค่า "model": "freellmapi/auto" |
| Model not found | Model id ไม่อยู่ในแผนที่ models ของผู้ให้บริการ | เพิ่ม id ลงในแผนที่ หรือรัน setup-opencode อีกครั้ง |
คีย์ {env:VAR} ว่างเปล่า | OpenCode แทนที่ตัวแปรที่ไม่ได้ตั้งค่าด้วยสตริงว่าง | export ตัวแปรในเชลล์เดียวกัน หรือเก็บคีย์ด้วย /connect |
| การเรียกใช้เครื่องมือล้มเหลว | โมเดลรองรับการเรียกใช้เครื่องมืออ่อน | เลือกโมเดลจากตารางด้านบน |
| "ทุกโมเดลถูกจำกัดอัตราหลังจาก N ครั้ง" | ทุกคีย์ถึงขีดจำกัดแล้ว | เพิ่มคีย์จากผู้ให้บริการอื่น หรือรอให้ช่วงพักการใช้งานสิ้นสุด |
คำถามที่พบบ่อย
ฉันใช้ OpenCode ฟรีได้ไหม
ได้ OpenCode เป็นโอเพนซอร์ส เชื่อมต่อกับ FreeLLMAPI ในฐานะผู้ให้บริการที่เข้ากันได้กับ OpenAI เกตเวย์ส่งแต่ละคำขอไปยังระดับฟรีของผู้ให้บริการ ดังนั้นค่าการอนุมานคือ $0
ฉันจะเพิ่มผู้ให้บริการ OpenAI-compatible ที่กำหนดเองใน OpenCode ได้อย่างไร
เพิ่มผู้ให้บริการใน opencode.json โดยตั้ง npm เป็น @ai-sdk/openai-compatible ตั้ง options.baseURL และแผนที่ models จากนั้นรัน /connect เพื่อเก็บคีย์ และ /models เพื่อเลือกโมเดล
โมเดลฟรีตัวใดดีที่สุดสำหรับ OpenCode
ใช้โมเดลที่เรียกใช้เครื่องมือได้และมีบริบทอย่างน้อย 128K ตารางในหน้านี้แสดงโมเดลฟรีที่แข็งแรงที่สุดซึ่งผ่านทั้งสองข้อในวันนี้ ใช้ freellmapi/auto เพื่อให้เราเตอร์เลือกให้
OpenCode เก็บคีย์ API ไว้ที่ใด
คีย์ที่เพิ่มด้วย /connect จะถูกเก็บที่ ~/.local/share/opencode/auth.json คำสั่งตั้งค่าของ FreeLLMAPI เขียนคีย์ไว้ที่นั่น ดังนั้นทั้ง CLI และแอปเดสก์ท็อปจึงพบคีย์
คู่มือที่เกี่ยวข้อง
- ใช้ Aider กับ LLM API ฟรี
- ใช้ Codex CLI กับโมเดลฟรี
- วิธีใช้ Claude Code ฟรี
- API โมเดลเขียนโค้ดฟรีที่ดีที่สุด
- Base URL ของ API ฟรีที่เข้ากันได้กับ OpenAI
แหล่งข้อมูล
- OpenCode docs: providers (V1 config) (ตรวจสอบเมื่อ 20 November 2026)
- OpenCode docs: config (ตรวจสอบเมื่อ 20 November 2026)
- OpenCode docs: migrate from V1 (ตรวจสอบเมื่อ 20 November 2026)
- FreeLLMAPI CLI generators (ตรวจสอบเมื่อ 20 November 2026)
- FreeLLMAPI docs: context handoff (ตรวจสอบเมื่อ 20 November 2026)