หน้าแรก / คู่มือ / ใช้ OpenCode กับ free LLM API

ใช้ 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
หมายเหตุเกี่ยวกับเวอร์ชันการตั้งค่า: ตอนนี้เอกสารของ OpenCode อธิบายรูปแบบการตั้งค่า V2 ที่มีคีย์ providers เอกสารระบุว่ารูปแบบ V1 ข้างต้นยังรองรับอยู่ คำสั่งตั้งค่าของ FreeLLMAPI เขียนรูปแบบ V1

เลือกโมเดลสำหรับ OpenCode

OpenCode เป็นเอเจนต์ มันอ่านไฟล์ แก้ไขไฟล์ และรันคำสั่งผ่านการเรียกใช้เครื่องมือ แต่ละคำขอมีพรอมต์ระบบ นิยามเครื่องมือ และเนื้อหาไฟล์ ใช้โมเดลที่เรียกใช้เครื่องมือได้และมี context window ขนาดใหญ่

โมเดลฟรีสำหรับ OpenCode: เรียกใช้เครื่องมือได้และมีบริบท 128K ขึ้นไป
โมเดลฟรีบนขนาดบริบทขีดจำกัดฟรี (ข้อเสนอที่ดีที่สุด)เครื่องมือการอ่านภาพ
GLM 5.3UnoRouter1M1 คำขอ/นาที
1 req/min per model
ใช่ไม่
GLM 5.3 FlashNVIDIA NIM, UnoRouter1M40 คำขอ/นาที
40 RPM
ใช่ใช่
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaใช่ใช่
Qwen3.8 Flash NextAMD Radeon Cloud262KRecurring daily account allowanceใช่ไม่
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring creditใช่ใช่
Gemini 3.7 FlashGoogle AI Studio1M10 คำขอ/นาที
20 คำขอ/วัน
250,000 โทเคน/นาที
~3M
ใช่ใช่
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring creditใช่ใช่
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 คำขอ/นาที
50 คำขอ/วัน
50 req/day account-wide (1,000 after a $10 purchase)
ใช่ใช่
DeepSeek V4 FlashAMD Radeon Cloud, BazaarLink, ElectronHub1M10 คำขอ/นาที
50 คำขอ/วัน
Shared rate limit
ใช่ไม่
Qwen3.8 27BElectronHub, Groq, OVH AI Endpoints262K30 คำขอ/นาที
250 คำขอ/วัน
70,000 โทเคน/นาที
~6M
ใช่ใช่
Gemini 3.6 FlashGoogle AI Studio1M10 คำขอ/นาที
20 คำขอ/วัน
250,000 โทเคน/นาที
~3M
ใช่ใช่
Qwen 3.8 27BCloudflare Workers AI262KShared 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 foundModel id ไม่อยู่ในแผนที่ models ของผู้ให้บริการเพิ่ม id ลงในแผนที่ หรือรัน setup-opencode อีกครั้ง
คีย์ {env:VAR} ว่างเปล่าOpenCode แทนที่ตัวแปรที่ไม่ได้ตั้งค่าด้วยสตริงว่างexport ตัวแปรในเชลล์เดียวกัน หรือเก็บคีย์ด้วย /connect
การเรียกใช้เครื่องมือล้มเหลวโมเดลรองรับการเรียกใช้เครื่องมืออ่อนเลือกโมเดลจากตารางด้านบน
"ทุกโมเดลถูกจำกัดอัตราหลังจาก N ครั้ง"ทุกคีย์ถึงขีดจำกัดแล้วเพิ่มคีย์จากผู้ให้บริการอื่น หรือรอให้ช่วงพักการใช้งานสิ้นสุด
ใช้ทุกตัวในรายการนี้ผ่านคีย์เดียว FreeLLMAPI คือเราเตอร์โอเพนซอร์สที่คุณโฮสต์เอง รวมระดับฟรีทั้งหมดนี้ไว้หลังปลายทางเดียวที่เข้ากันได้กับ OpenAI และเปลี่ยนไปใช้ตัวอื่นเมื่อตัวใดตัวหนึ่งถูกจำกัดอัตรา ดูแคตตาล็อก หรือ เริ่มใช้งานจริง.

คำถามที่พบบ่อย

ฉันใช้ 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 และแอปเดสก์ท็อปจึงพบคีย์

คู่มือที่เกี่ยวข้อง

แหล่งข้อมูล

คู่มือทั้งหมด · ดูโมเดลฟรีทั้งหมด