ใส่โมเดลในแคตตาล็อกลงใน Raycast AI ด้วย providers.yaml ไฟล์เดียว

คำตอบสั้น ๆ: เปิด Custom Providers แก้ไฟล์เดียว

เส้นทางของ Raycast สำหรับ OpenAI-compatible endpoint คือฟีเจอร์ Custom Providers ซึ่งมุ่งไปที่ผู้ใช้ขั้นสูงและปิดอยู่โดยค่าเริ่มต้น เปิดมันที่ด้านล่างของส่วน AI ใน Raycast Settings ใช้ Reveal Providers Config เพื่อเปิดโฟลเดอร์ config แล้ว copy providers.template.yaml ที่มาพร้อมระบบเป็น providers.yaml ไฟล์นี้อยู่ที่ ~/.config/raycast/ai/providers.yaml แต่ละ provider entry รับ id, ชื่อที่แสดง, base_url และ block api_keys โมเดลแต่ละตัวที่คุณต้องการให้อยู่ใน picker ถูกประกาศอย่างชัดเจนด้วย id, ชื่อที่แสดง และ context window ของมัน บวก block abilities ที่อธิบายว่า Raycast ขออะไรจากมันได้บ้าง รูปทรงของ base_url ตามธรรมเนียมเดียวกับตัวอย่างโมเดล local ที่มากับระบบ ซึ่งชี้ไปที่ root /v1 ดังนั้นค่าของ APIsRouter คือ https://api.apisrouter.com/v1 ไฟล์นี้เก็บ credential ไว้ ดังนั้นปฏิบัติกับมันเหมือนไฟล์ secret ใด ๆ

providers:
  - id: apisrouter
    name: APIsRouter
    base_url: https://api.apisrouter.com/v1
    api_keys:
      default: sk-APIsRouter-...
    models:
      - id: claude-sonnet-4-6
        name: Claude Sonnet 4.6
        context: 200000
        abilities:
          temperature:
            supported: true
          tools:
            supported: true
      - id: claude-haiku-4-5-20251001
        name: Claude Haiku 4.5
        context: 200000
        abilities:
          temperature:
            supported: true

ฟีเจอร์สองตัวของ Raycast ที่ฟังดูคล้ายกัน แต่ไม่ใช่

Raycast มีเอกสารระบุสองวิธีที่จะนำการเข้าถึง AI ของคุณเองมาใช้ และการค้นหาหาตัวหนึ่งมักเจออีกตัวแทนอย่างสม่ำเสมอ ดังนั้นความแตกต่างนี้คุ้มค่าที่จะบอกให้ชัดเจน Bring Your Own Keys หน้า BYOK ในคู่มือของ Raycast เชื่อม key ส่วนตัวของ Anthropic, Google หรือ OpenAI ของคุณ (OpenRouter บน iOS) เข้ากับ Raycast AI มันเป็นฟีเจอร์ที่ง่ายกว่า มีเอกสารระบุว่าทำงานได้โดยไม่ต้องสมัคร Pro แต่มันไม่ใช่ custom endpoint: request route ผ่านเซิร์ฟเวอร์ของ Raycast เพื่อรวม API และคู่มือระบุชัดเจนว่ามีแค่โมเดลที่มีอยู่ใน Raycast AI แล้วเท่านั้นที่เข้าถึงได้ key ของ gateway ไม่สามารถเสียบตรงนั้นได้ เพราะ BYOK ไม่เคยขอ URL เลย Custom Providers คือฟีเจอร์ที่หน้านี้ตั้งค่า: base_url ของคุณเอง, key ของคุณเอง, โมเดลที่คุณประกาศเอง request ไปที่ที่คุณชี้ มันคือเส้นทางสำหรับ gateway หลาย vendor, สำหรับ server local และสำหรับโมเดลใดก็ตามที่รายการในตัวของ Raycast ไม่มี ข้อแลกเปลี่ยนคือความชัดเจน Raycast ไม่ดึงรายการโมเดลของ endpoint ให้คุณ (ความสะดวกนั้นเป็น feature request ที่ยังค้างอยู่) ดังนั้น picker จะแสดงตามที่ YAML ของคุณประกาศเท่านั้น ไม่มากไม่น้อยไปกว่านั้น

ประกาศโมเดลอย่างซื่อตรง: id, context, abilities

เพราะไม่มีการค้นหาอัตโนมัติ YAML คือสัญญา และแต่ละฟิลด์ในนั้นทำงานจริง id ของโมเดลต้องตรงกับรายการ /v1/models ของ gateway เป๊ะ มันคือสิ่งที่เดินทางไปกับ request name เป็นแค่ label ที่ Raycast แสดง ค่า context บอก Raycast ว่ามันบรรจุประวัติบทสนทนาลงใน request ได้แค่ไหน ดังนั้นการระบุต่ำเกินไปจะเสียความสามารถ และระบุสูงเกินไปจะสร้าง request ที่โมเดลปฏิเสธ ใช้ window ที่มีเอกสารระบุสำหรับ id ที่คุณกำลังประกาศ block abilities คือส่วนที่คนมักทำผิด มันประกาศว่า Raycast อาจพึ่งพาอะไรจากโมเดล: การควบคุม temperature, input รูปภาพ, system message, การใช้ tool, reasoning effort การประกาศ ability ที่โมเดลไม่มีจะสร้างความล้มเหลวที่งงข้างในฟีเจอร์ของ Raycast แทนที่จะเป็น error ที่ชัดเจน และการละไว้ตัวที่โมเดลมีจริงจะปิดพฤติกรรมของ Raycast ที่สอดคล้องกันอย่างเงียบ ๆ เริ่มจากน้อยที่สุด: temperature บวก tools สำหรับโมเดลที่คุณจะใช้กับ AI extension แล้วเพิ่ม ability ตามที่คุณยืนยันกับเอกสารของโมเดลแล้ว มี Raycast extension ที่ชุมชนดูแลรักษาที่สร้างมาเพื่อจัดการไฟล์นี้จาก UI พร้อม backup อัตโนมัติก่อนการเปลี่ยนแปลงแต่ละครั้ง คุ้มค่าที่จะรู้ไว้ถ้าการเขียน YAML ด้วยมือไม่ใช่สิ่งที่คุณชอบ ไม่ว่าทางไหน Raycast อ่านไฟล์จากดิสก์ ดังนั้นหลังแก้ไข ให้รอสักครู่หรือ toggle ฟีเจอร์เพื่อให้แน่ใจว่า picker สะท้อนไฟล์ปัจจุบัน

curl -s https://api.apisrouter.com/v1/models \
  -H "Authorization: Bearer $APISROUTER_API_KEY" | head -50
# declare these ids verbatim in providers.yaml

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

เพราะทุกโมเดลที่ประกาศไว้เรียกเก็บเงินผ่าน key เดียวกัน loop การเปรียบเทียบคือการสลับ picker: รัน quick command เดียวกันบนสอง id เป็นเวลาหนึ่งวัน แล้วอ่านค่าใช้จ่ายต่อโมเดลใน console แล้วเก็บตัวที่คุ้มค่ากับตำแหน่งของมันไว้

• AI ของ launcher เป็นงานเป็นช่วง ๆ: สรุปนี่, เขียนใหม่นั่น, อธิบายส่วนที่เลือก claude-haiku-4-5-20251001 และ gemini-3.5-flash ตอบกลับก่อนที่ animation ของ window จะจบเสียอีก ซึ่งเป็นความรู้สึกที่ผู้ใช้ Raycast คาดหวัง
• session AI Chat และการร่างยาวคุ้มค่ากับ claude-sonnet-4-6 หรือ gpt-5.5 ประกาศไว้คู่กับระดับเร็วแล้วสลับต่องานใน picker
• AI extension ที่เรียก tool ต้องการโมเดลที่ใช้ tool ได้อย่างไว้ใจได้ และ block abilities ที่ประกาศให้ตรง claude-sonnet-4-6 คือตัวเลือกแรกที่ปลอดภัยตรงนั้น
• deepseek-v4-flash คือตัวเลือกปริมาณสำหรับผู้ใช้ที่เชื่อม AI เข้ากับทุกช่องข้อความที่พวกเขาแตะ completion เล็ก ๆ ต่อเนื่องรวมกันเป็นจำนวนมาก และระดับเร็วเก็บนิสัยนี้ให้มองไม่เห็นบนยอดคงเหลือ
• ประกาศโมเดลให้น้อยอย่างตั้งใจแทนที่จะประกาศเยอะตามเดา ทุก entry คือแถวใน picker ที่คุณต้องเลื่อนผ่าน และ YAML ก็ขยายง่ายในวันที่คุณต้องการ id เพิ่ม

จ่ายตามการใช้งาน · ถูกกว่าราคาทางการ

Selected models are priced below official list prices. Exact input, output, cache, and per-request prices are shown for each model.

รูปแบบความล้มเหลวเฉพาะของ Raycast

การตั้งค่า BYOK ทั้งที่ตั้งใจใช้ Custom Providers เป็นความผิดพลาดระดับบนสุด และไม่ใช่ความผิดของคุณ: ฟีเจอร์ทั้งสองแชร์พื้นที่การค้นหากัน ถ้า flow ที่คุณอยู่ขอ key ของ vendor แต่ไม่เคยขอ URL คุณอยู่ใน BYOK และ gateway ไม่ควรอยู่ตรงนั้น ถอยกลับไปที่ Settings, AI และ toggle Custom Providers ที่ด้านล่าง ไฟล์ที่ถูกเมินมักหมายความว่า toggle ฟีเจอร์ปิดอยู่ ไฟล์ยังชื่อ providers.template.yaml หรือ YAML มี syntax error ซึ่งกรณีนั้น Raycast ไม่มีอะไรที่ถูกต้องให้โหลด และ picker แค่ไม่แสดงโมเดล custom ใด ๆ ตรวจสอบความถูกต้องของ YAML ก่อนสงสัยอะไรที่ลึกกว่านั้น โมเดลที่ error บางฟีเจอร์ของ Raycast แต่ไม่ error ตัวอื่นคือความไม่ตรงกันของ abilities: AI extension ที่ใช้ tool ล้มเหลวในขณะที่แชทธรรมดาทำงานได้เมื่อ tools ถูกประกาศบนโมเดลที่ไม่มีมัน หรือไม่เคยประกาศบนโมเดลที่มี request ที่ถูกปฏิเสธเพราะขนาดชี้ไปที่ค่า context ที่ระบุสูงเกินจริง และสังเกตขอบเขต platform อย่างซื่อตรง: Custom Providers ตั้งค่าบน Mac ในไฟล์ config local ถ้าส่วนหนึ่งของการใช้ Raycast ของคุณอยู่ที่อื่น ตรวจสอบคู่มือว่าฟีเจอร์รองรับอะไรตรงนั้นก่อนสมมติว่าเท่าเทียมกัน

ใครที่ route Raycast AI ผ่าน gateway

• power user ที่ใช้ชีวิตอยู่ใน launcher และต้องการ quick AI command บน id ในแคตตาล็อกที่เร็วโดยไม่มี subscription ตัดสินว่าพวกเขาแตะโมเดลไหนได้บ้าง
• คนที่ route editor และ terminal tool ผ่าน gateway อยู่แล้วที่ต้องการ launcher บน key เดียวกัน มี usage log เดียวข้ามทุกพื้นผิว
• ผู้ใช้ที่ต้องการโมเดลที่รายการในตัวของ Raycast ไม่มี รวม id ของ DeepSeek และ GLM ประกาศครั้งเดียวใน YAML และใช้ได้ทุกที่ในแอป
• builder ของ AI extension ที่ต้องการโมเดลที่ใช้ tool ได้เฉพาะเจาะจงหลัง extension ของพวกเขา pin ด้วย id แทนที่จะขึ้นกับรายการที่โฮสต์ไว้
• นักพัฒนาที่ไม่มีสิทธิ์เข้าถึงระบบเก็บเงินของ vendor รายหนึ่ง การเข้าถึงแบบเติมเงินโดยไม่ต้องใช้บัตรตัดการพึ่งพาการสมัครต่อ provider ออกไป

ตรวจสอบ endpoint และ debug command แรก

รัน curl โมเดลก่อนแล้ว copy id จาก output ของมันลงใน YAML การพิมพ์ id จากความจำคือสาเหตุอันดับหนึ่งของ error model-not-found ตรงนี้ เพราะไฟล์คือแหล่งโมเดลเดียวที่ Raycast มี จากนั้นเปิด toggle ยืนยันว่า picker แสดงชื่อที่ประกาศไว้ แล้วรัน quick AI command หนึ่งครั้งบนโมเดลที่เร็ว picker ที่ว่างเปล่าคือ toggle, ชื่อไฟล์ หรือ syntax ของ YAML authentication error คือ block api_keys error not-found คือ id ไม่ตรงกับรายการที่คุณเพิ่ง curl มา command ที่ทำงานในแชทแต่ล้มเหลวใน AI extension คือการประกาศ abilities บนโมเดลนั้น เมื่อ command ไหลลื่นแล้ว console ของ APIsRouter แสดงโมเดลต่อ request, จำนวน token และค่าใช้จ่าย AI ของ launcher คือ request เล็ก ๆ หลายร้อยครั้งมากกว่าจะเป็น request ใหญ่ไม่กี่ครั้ง และ usage log คือที่ที่รูปแบบนั้นกลายเป็นตัวเลข ต่อโมเดล ต่อวัน บนหน้าเดียวกับทุกเครื่องมืออื่นที่คุณ route ผ่าน gateway

curl -s https://api.apisrouter.com/v1/chat/completions \
  -H "Authorization: Bearer $APISROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-haiku-4-5-20251001",
       "messages":[{"role":"user","content":"ping"}]}'

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