สิ่งที่คุณต้องมีก่อนเริ่ม
อินสแตนซ์ n8n (แบบคลาวด์หรือโฮสต์เอง) และคีย์ API จากบริการนี้ หากคุณยังไม่มีคีย์ หน้าคีย์ APIจะแนะนำขั้นตอนการสมัครผ่าน Google หรืออีเมลและรหัสผ่าน ผู้ใช้ใหม่สามารถรับเครดิตทดลองใช้มูลค่า $0.50ได้ด้วยคลิกเดียวบนหน้านั้น โดยใช้งานได้ 7 วันโดยไม่ต้องใช้บัตร
ค่าสามค่าที่ส่งเข้า n8n:
- Base URL:
https://api.onekeyllmapi.com/v1 - API key: ส่งเป็น
Authorization: Bearer <key>ซึ่ง n8n จะจัดการให้ - รหัสโมเดล:
uncensored
บริการเป็น API LLM แบบโฮสต์ที่รองรับเฉพาะข้อความ โดยปฏิบัติตามรูปแบบคำขอของ OpenAI สำหรับ /v1/chat/completions, /v1/responses และ /v1/models ไม่ใช่ API ทางการของผู้ขายโมเดลใด ๆ ดังนั้นการที่ n8n ส่งคำขอไปยังเอนด์พอยต์แชทของ OpenAI จึงใช้งานได้ตราบใดที่เป็นคำขอข้อความ
ขั้นตอนที่ 1: สร้างข้อมูลรับรอง
ใน n8n เปิด Credentials, เลือก Create credential และค้นหา OpenAI API กรอกข้อมูลดังนี้:
- วางคีย์ของคุณลงในช่อง API Key
- ปล่อยช่อง Organization ID ให้ว่าง
- แทนที่ Base URL ค่าเริ่มต้นด้วย
https://api.onekeyllmapi.com/v1รักษา/v1ไว้ที่ท้ายและอย่าเพิ่ม/chat/completions - บันทึก n8n จะทำการเรียกทดสอบเล็กน้อยเมื่อคุณบันทึก หากล้มเหลว ให้ไปที่ส่วนการแก้ปัญหาด้านล่าง
ใช้ข้อมูลรับรองหนึ่งรายการต่อสภาพแวดล้อม หากคุณรัน n8n ทั้งแบบ staging และ production ให้ใช้คีย์ที่แตกต่างกันสำหรับแต่ละแบบ เพื่อให้คุณสามารถดูการใช้จ่ายแยกกันและเพิกถอนคีย์หนึ่งโดยไม่กระทบอีกคีย์หนึ่ง
ขั้นตอนที่ 2: สร้างเวิร์กโฟลว์แชทอย่างง่าย
เริ่มต้นด้วยสิ่งเล็กๆ น้อยที่สุดที่พิสูจน์การเชื่อมต่อ: ตัวกระตุ้นแบบแมนนวลและการเรียกใช้โมเดลหนึ่งครั้ง
- เพิ่มโหนด Manual Trigger
- เพิ่มโหนด OpenAI (หรือโหนดย่อย OpenAI Chat Model ภายใน Basic LLM Chain ขึ้นอยู่กับเวอร์ชัน n8n ของคุณ) และเลือกข้อมูลรับรองจากขั้นตอนที่ 1
- สำหรับโมเดล ให้มองหาวิธีป้อน ID ด้วยตนเอง เวอร์ชัน n8n ล่าสุดมีโหมด By ID อยู่ถัดจากรายการ พิมพ์
uncensoredที่นั่น รายการอาจว่างหรือแสดงเฉพาะชื่อของ OpenAI เนื่องจาก n8n กรองรายการนี้ที่ฝั่งของตัวเอง - เพิ่มพรอมต์เช่น สรุปตั๋วขอความช่วยเหลือนี้ในสองประโยค และรันโหนด
หากเวอร์ชัน n8n ของคุณบังคับให้เลือกจากรายการ ให้ใช้แนวทาง HTTP Request ในส่วนถัดไป วิธีนี้ใช้งานได้เสมอเพราะคุณควบคุมคำขอทั้งหมด
การเรียกใช้ API ด้วยโหนด HTTP Request
โหนด HTTP Request เป็นวิธีที่คาดการณ์ได้มากที่สุดในการเรียกใช้ API นี้จาก n8n และเผยพารามิเตอร์ทุกตัวที่ API รองรับ รวมถึง seed, stop, top_p และ tools ตั้งค่าดังนี้:
- วิธีการ:
POST - URL:
https://api.onekeyllmapi.com/v1/chat/completions - การตรวจสอบสิทธิ์: ประเภทข้อมูลรับรองทั่วไป พร้อม การตรวจสอบสิทธิ์แบบ Header ชื่อ
Authorizationค่าBearer YOUR_KEY - ส่ง Body: เปิด, content type JSON
Body (เปลี่ยนค่าฟิลด์เป็น Expression หากต้องการแทรกข้อมูลจากโหนดก่อนหน้า):
{
"model": "uncensored",
"messages": [
{"role": "system", "content": "You are a concise assistant."},
{"role": "user", "content": "Summarize this support ticket in two sentences."}
],
"temperature": 0.4
}
ข้อความตอบกลับอยู่ที่ choices[0].message.content ในโหนดถัดไปคุณสามารถอ้างอิงมันด้วย {{ $json.choices[0].message.content }}
เพื่อทดสอบคำขอเดียวกันก่อน (นอก n8n) ให้รันคำสั่งนี้ในเทอร์มินัล:
curl https://api.onekeyllmapi.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"Say hello in five words."}]}'
หาก curl ทำงานได้แต่ n8n ไม่ทำงาน ปัญหาคือการตั้งค่าโหนด ไม่ใช่คีย์ API หรือยอดเงินของคุณ
โหมด JSON สำหรับเวิร์กโฟลว์ที่แยกวิเคราะห์เอาต์พุต
เวิร์กโฟลว์อาจล้มเหลวเมื่อโมเดลจัดรูปแบบข้อมูลเป็นข้อความบรรยาย โหมด JSON จะสั่งให้ API ส่งคืนวัตถุ JSON ที่ถูกต้อง ซึ่งคุณสามารถส่งต่อไปยังโหนด Set หรือ IF ได้โดยตรง เพิ่ม response_format ลงใน body:
{
"model": "uncensored",
"response_format": {"type": "json_object"},
"messages": [
{"role": "system", "content": "Reply only with a JSON object with keys sentiment and summary."},
{"role": "user", "content": "The delivery was late but support fixed it fast."}
]
}
สองแนวทางนี้ทำให้การทำงานน่าเชื่อถือ ประการแรก ให้ระบุคำว่า JSON และตั้งชื่อคีย์ในพรอมต์ เพราะโหมด JSON รับรองไวยากรณ์ ไม่ใช่สคีมาของคุณ ประการที่สอง ข้อความตอบกลับยังคงมาถึงเป็นสตริงใน message.content ดังนั้นให้เพิ่มโหนด Code หรือใช้ expression พร้อม JSON.parse() ก่อนอ่านฟิลด์ ในโหนด OpenAI ตัวเลือกเดียวกันปรากฏเป็นตัวเลือก Response Format ภายใต้ตัวเลือกโหนด
การจัดการข้อผิดพลาด 429 และข้อผิดพลาดอื่นๆ
n8n ประมวลผลรายการแบบขนาน ดังนั้นชุดรายการ 50 รายการอาจทำให้ถึงขีดจำกัดได้เร็ว คีย์แบบเต็มอนุญาตให้ทำคำขอพร้อมกันได้ 8 คำขอ และ 300 คำขอต่อนาที ส่วนคีย์ทดลองทำได้ 2 และ 60 คำขอ เมื่อเกินขีดจำกัด API จะตอบกลับด้วย HTTP 429 พร้อมโค้ด rate_limited (เกินจำนวนต่อนาที) หรือ concurrency (เกินจำนวนพร้อมกัน) เมื่อเกิดภาวะโอเวอร์โหลดชั่วคราว คุณจะได้รับ 429 พร้อมส่วนหัว Retry-After: 5
การตั้งค่าในทางปฏิบัติใน n8n:
- เปิดโหนด ไปที่ Settings เปิดใช้งาน Retry On Fail ตั้งค่า Max Tries เป็น 3 หรือ 4 และ Wait Between Tries เป็น 5000 ms
- ใส่โหนด Loop Over Items (ขนาดแบทช์ 4 ถึง 6) ก่อนการเรียกโมเดล เพื่อให้คุณอยู่ภายใต้ขีดจำกัดคำขอพร้อมกัน 8 รายการ
- ภายใต้การตั้งค่าโหนด Settings, On Error สามารถตั้งค่าให้ดำเนินการต่อพร้อมเอาต์พุตข้อผิดพลาดได้ เพื่อให้แถวที่ผิดพลาดหนึ่งแถวไม่ทำให้การรันหยุดลง
เพื่อศึกษาขีดจำกัดทั้งสองประเภทให้ลึกซึ้งยิ่งขึ้น โปรดอ่าน เอกสาร API ข้อผิดพลาดอื่น ๆ นั้นเรียบง่าย: 401 หมายถึงคีย์ไม่ถูกต้องหรือส่วนหัวขาดคำว่า Bearer และ 404 มักหมายถึง Base URL มีตัวพิมพ์ผิดหรือมีเส้นทางส่วนเกิน
รายการตรวจสอบการแก้ปัญหา
การล้มเหลวส่วนใหญ่เกิดจากรายการสาเหตุเพียงไม่กี่รายการ ให้ตรวจสอบตามลำดับจากบนลงล่างก่อนจะสงสัยว่าบริการมีปัญหา
| อาการ | สาเหตุที่เป็นไปได้ | การแก้ไข |
|---|---|---|
| 401 เมื่อบันทึกหรือรัน | คีย์ผิด หรือส่วนหัวขาด Bearer | วางคีย์อีกครั้ง; ใน Header Auth ค่าต้องขึ้นต้นด้วย Bearer |
| 404 | Base URL มีตัวพิมพ์ผิดหรือมีเส้นทางส่วนเกิน | ใช้ https://api.onekeyllmapi.com/v1 ในข้อมูลรับรอง |
| ไม่พบโมเดล | Model ID ไม่ได้พิมพ์เป็น uncensored | เปลี่ยนเป็น By ID หรือใช้โหนด HTTP Request |
| 429 เมื่อมีความพร้อมกันของคำขอ | รันพร้อมกันเกิน 8 ครั้ง (2 ครั้งบนคีย์แบบทดลอง) | ทำแบทช์ด้วย Loop Over Items และเพิ่มการลองใหม่ |
| เกิดข้อผิดพลาดการแยกวิเคราะห์ JSON ในขั้นตอนถัดไป | คำตอบเป็นสตริง หรือพรอมต์ไม่ได้ระบุชื่อคีย์ | แยกวิเคราะห์ด้วย JSON.parse() และอธิบายคีย์ในพรอมต์ระบบ |
เมื่อติดต่อฝ่ายสนับสนุน ให้รวมส่วนหัวการตอบกลับ X-Request-Id จากคำขอที่ล้มเหลว ใน n8n คุณสามารถดูส่วนหัวได้โดยเปิด Include Response Headers and Status ในตัวเลือกโหนด HTTP Request
การทดสอบโดยไม่ใช้เงินมาก
ใช้เครดิตทดลองใช้ขณะคุณพัฒนา เมื่อมีคำขอพร้อมกัน 2 คำขอและ 60 คำขอต่อนาที คีย์ทดลองใช้จะประมวลผลชุดข้อมูลได้ช้า แต่เพียงพอสำหรับการตรวจสอบข้อมูลรับรอง พรอมต์ และตรรกะการแยกวิเคราะห์ ให้เปลี่ยนเป็นคีย์เต็มเมื่อคุณกำหนดเวลาเวิร์กโฟลว์
ต้นทุนและการออกแบบเวิร์กโฟลว์ที่เหมาะสม
ราคาเป็นแบบจ่ายตามการใช้งาน: $0.15 ต่อ 1M โทเคนอินพุต และ $0.50 ต่อ 1M โทเคนเอาต์พุต จากเครดิตแบบเติมเงินล่วงหน้า เวิร์กโฟลว์ที่จัดประเภทอีเมล 1,000 ฉบับต่อวันด้วย 600 โทเคนอินพุตและ 100 โทเคนเอาต์พุตต่อฉบับ จะใช้ 0.6M โทเคนอินพุต ($0.09) และ 0.1M โทเคนเอาต์พุต ($0.05) ประมาณ $0.14 ต่อวัน คำขอที่ล้มเหลวหรือถูกปฏิเสธจะไม่ถูกเรียกเก็บเงิน ดังนั้นการลองใหม่เมื่อเกิดข้อผิดพลาดจึงไม่ทำให้บิลเพิ่มขึ้นสองเท่า รายละเอียดมีอยู่ที่ หน้าราคา
รักษาพรอมต์ให้สั้น ส่งเฉพาะฟิลด์ที่โมเดลต้องการ และตั้งค่า max_tokens เมื่อคุณรู้ว่าการตอบจะสั้น หากคุณรันโมเดลบนเครื่องของคุณเอง ดูบทความเกี่ยวกับการ ใช้ LLM ท้องถิ่นผ่าน API สไตล์ OpenAI ซึ่งใช้การตั้งค่าไคลเอนต์เดียวกัน
