เอกสาร

เริ่มต้นใช้งาน

ใช้ OpenAI SDK อยู่แล้วใช่ไหม? แค่เปลี่ยน base URL กับ key 2 บรรทัด ก็ใช้งานกับเราได้ทันที

เข้าถึงได้กับ OpenAI เปลี่ยนแค่ 2 บรรทัด SSE streaming มีอะไรใหม่ · 16/10/2026 →

เริ่มเร็ว

สามขั้นตอนถึง request จริง

เริ่มใช้งานได้ทันที ไม่ต้องย้ายระบบใหม่ แค่เปลี่ยนไม่กี่บรรทัด

  1. 01

    สร้าง API key

    สร้างคีย์ได้ที่เมนู API Keys ในพอร์ทัลสมาชิก โดยคีย์จะแสดงให้ดูแค่ครั้งเดียวตอนสร้าง อย่าลืมเก็บไว้ เพราะหลังจากนั้นจะไม่สามารถเปิดดูหรือกู้คืนคีย์เดิมได้

  2. 02

    เชื่อมต่อ Client กับเรา

    ตั้งค่า Base URL ให้เป็น Endpoint ของเรา แล้วใช้คีย์ที่สร้างไว้เป็น API key ส่วนชื่อโมเดลที่ใช้ได้ ดูได้จาก GET /v1/models

  3. 03

    Streaming

    คำตอบจะทยอยส่งกลับมาทีละส่วนระหว่างที่ระบบกำลังสร้าง ไม่ต้องรอให้ตอบเสร็จทั้งหมดก่อน

ตัวอย่าง

คำขอแบบสั้นที่สุด

ใช้งานเหมือน OpenAI Chat Completions API โดยส่ง model และ messages ตามปกติ ส่วนพารามิเตอร์อื่นๆ บางโมเดลอาจไม่รองรับทุกตัว ถ้าต้องการ Streaming ให้เพิ่ม stream: true ในคำขอเดิม

python
# pip install openai
import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.ic-lueur.ai/v1",
    api_key=os.environ["LLMR_API_KEY"],
)

resp = client.chat.completions.create(
    model="gpt-5-mini",
    messages=[{"role": "user", "content": "Sawasdee!"}],
)

เชื่อมต่อเครื่องมือ

เชื่อมต่อเครื่องมือกับ IC Lueur Ai

ใช้ Base URL และ API Key เพื่อเชื่อมต่อเครื่องมือที่รองรับ OpenAI API ตั้งค่าเพียงไม่กี่ขั้นตอนก็เริ่มใช้งานได้

Base URL
https://api.ic-lueur.ai/v1
API Key

สร้างหรือจัดการ API Key ได้ที่ Member Portal → API Keys

เชื่อมต่อ AI Coding Tools ด้วย Base URL และ API Key ชุดเดียว

  1. 1 ติดตั้ง Roo Code จาก VS Code Marketplace (RooVeterinaryInc.roo-cline)
  2. 2 คลิกไอคอน Roo Code ใน Activity Bar
  3. 3 เปิด Settings → เลือก API Provider เป็น OpenAI Compatible
  4. 4 วาง Base URL และ API key
  5. 5 พิมพ์ชื่อโมเดล เช่น claude-sonnet-4-6 แล้วกด Save
Roo Code ใช้ได้ใน Windsurf และ VSCodium ด้วย — ขั้นตอนเหมือนกัน

Sidebar ของ Roo Code แสดง dropdown API Provider ที่เลือก OpenAI Compatible

ตัดการเชื่อมต่อ ไม่ได้แปลว่ายกเลิกค่าใช้จ่าย

ใช้ stream: true เพื่อรับคำตอบแบบ Streaming ได้ แต่ถ้าตัดการเชื่อมต่อระหว่างทาง คำขออาจยังทำงานต่อและมีค่าใช้จ่ายตามปกติ

  1. 1
    Send request ใส่ stream: true
  2. 2
    Open connection เปิดการเชื่อมต่อกับเซิร์ฟเวอร์
  3. 3
    Streaming รับ server-sent events ต่อเนื่อง
  4. 4
    Done จบสตรีมด้วย [DONE]

รูปแบบ

ใช้ server-sent events (SSE) แบบเดียวกับ OpenAI โดยข้อมูลจะทยอยส่งมาในรูปแบบ data: และจบสตรีมแบบเดียวกัน โดยช่อง model ในแต่ละ chunk จะแสดงชื่อโมเดลที่คุณเรียกใช้

ตัดการเชื่อมต่อก่อนจบ

ถ้าตัดการเชื่อมต่อระหว่างทาง token ที่สร้างไปแล้วจะยังถูกคิดตามการใช้งานจริง เหมือนกับคำขอที่ทำงานจนจบ

หน้าตาของคำขอที่ล้มเหลว

Error Response ใช้โครงสร้างเดียวกับ OpenAI คือ {"error": {"message": "<ข้อความ>"}} พร้อม HTTP status แต่ค่า type และ code อาจไม่ตรงกับของ OpenAI ทุกกรณี หากต้องแยกประเภท Error ให้ดูจาก HTTP status และข้อความใน message แทน

400 Bad Request

ไม่พบโมเดลที่เรียกใช้ หรือโมเดลนั้นยังไม่ได้ตั้งค่าไว้ ตรวจสอบชื่อโมเดลได้ที่ GET /v1/models หรือคำขอใส่ฟิลด์ที่เกตเวย์ไม่รับ ได้แก่ extra_body, kwargs, litellm_params หรือ custom_llm_provider ให้ส่งตัวเลือกของโมเดลเป็นฟิลด์ระดับบนสุดของ body แทน (OpenAI SDK ทำให้อยู่แล้วเมื่อใช้ extra_body ของ SDK)

401 Unauthorized

ไม่พบ API key หรือคีย์ที่ใช้ไม่ถูกต้องหรือถูกยกเลิกแล้ว

402 Insufficient Balance

ยอดเงินคงเหลือไม่พอสำหรับคำขอนี้ โดยระบบจะแจ้งยอดคงเหลือเป็นเงินบาท

403 Forbidden

องค์กรถูกระงับการใช้งาน คีย์ที่ใช้เป็นคีย์ของผู้ดูแลระบบ (Master key) ซึ่งใช้เรียกโมเดลไม่ได้ หรือผู้สร้างคีย์ใช้งานครบวงเงินรายวันหรือรายเดือนที่เจ้าของหรือ Admin ขององค์กรกำหนดไว้

413 Payload Too Large

Prompt มีขนาดเกินที่กำหนดสำหรับโมเดลฟรีประจำสัปดาห์

429 Rate Limit

ส่งคำขอเกินลิมิตที่กำหนดไว้ ให้ดู Retry-After และข้อความที่ระบบส่งกลับมาก่อนลองใหม่

สำหรับ 429 อาจเกิดได้จากหลายสาเหตุ ถ้าต้องการแยกว่าเกิดจากอะไร ให้ดูคำขึ้นต้นของข้อความที่ระบบส่งกลับมาแทนการดูแค่ status code และเทียบแบบตรงตัวพิมพ์เล็ก-ใหญ่ ได้แก่ ลิมิตของคีย์ขึ้นต้นด้วย rate limit exceeded: (ตัวพิมพ์เล็ก) ภูมิภาคที่ใช้ได้ไม่ว่างชั่วคราวขึ้นต้นด้วย no region available ส่วนลิมิตของโมเดลฟรีขึ้นต้นด้วย QUOTA_EXCEEDED, REQUEST_LIMIT_EXCEEDED หรือ RATE_LIMIT_EXCEEDED (ตัวพิมพ์ใหญ่)

RATE_LIMIT_EXCEEDEDQUOTA_EXCEEDEDREQUEST_LIMIT_EXCEEDED
503 Service Unavailable

ระบบไม่สามารถตรวจสอบคีย์ได้ชั่วคราว หรือโมเดลนั้นยังไม่ได้ตั้งราคา จึงยังไม่สามารถทำคำขอนี้ได้

โมเดลฟรีประจำสัปดาห์

โมเดลไหนก็ตามอาจมีช่วงเวลาที่ฟรีชั่วคราวได้ — คำขอแบบเดิม ไม่เสียเงิน ตลอดช่วงที่ยังฟรีอยู่

Rate limit

15 คำขอ / นาที ต่อคีย์

ลิมิตนี้นับแยกจากลิมิตปกติของคีย์ และจะจำกัดมากกว่าปกติ

โควตารายสัปดาห์

1,000,000 tokens หรือ 1,000 คำขอ

นับรวมต่อองค์กร โดยจะยึดตามลิมิตที่ถึงก่อน

รีเซ็ตโควตา

ทุกวันจันทร์

เวลา 00:00 น. (เวลาไทย)

ขนาด Prompt สูงสุด

32,000 tokens

ถ้าเกินจากนี้ ระบบจะไม่รับคำขอนั้น และจะไม่มีการคิดเงิน

ขนาด Output สูงสุด

16,000 tokens

ตอบได้สูงสุด 16,000 tokens หรือตาม max_tokens ที่ตั้งไว้

เมื่อโควตาหมด

ใช้งานได้อีกครั้งวันจันทร์

หากเปิด Auto-fallback ไว้ ระบบจะสลับไปใช้ยอดคงเหลือให้อัตโนมัติ

เช็คได้ว่าตอนนี้โมเดลไหนฟรีอยู่จากตารางแคตตาล็อกราคา — กรองด้วยตัวเลือก "Free" ได้เลย

ทุกคำขอจะเป็นไปตาม Routing ที่ตั้งไว้

องค์กรของคุณมี Routing Policy ที่ทีมงานเป็นผู้ตั้งค่าให้เมื่อคุณแจ้งขอ API key ใหม่จะได้รับค่านี้ตอนสร้าง และระบบจะใช้กับทุกคำขอของคีย์นั้น หากเปลี่ยน Routing Policy ภายหลัง คีย์ที่สร้างไว้ก่อนจะยังใช้ค่าเดิม ดูรายละเอียดด้านล่างว่าตอนนี้คำขอจะถูกส่งไปประมวลผลที่ไหน

ตอนนี้คำขอถูกส่งไปที่ไหน

คำขอส่วนใหญ่ประมวลผลที่สิงคโปร์และโตเกียว บางโมเดลให้บริการจากภูมิภาค global ของผู้ให้บริการ ซึ่งอาจอยู่นอกเอเชีย เช่น สหรัฐอเมริกา และองค์กรที่ใช้ Routing Policy แบบ available จะเข้าถึงผู้ให้บริการในจีนแผ่นดินใหญ่ได้ด้วย

ข้อมูลบัญชี ยอดเงิน และใบกำกับภาษีจัดเก็บบน AWS ในประเทศไทย ไม่ว่าคำขอจะถูกประมวลผลที่ไหน

strict (เข้มงวด)
ใช้เฉพาะภูมิภาคกรุงเทพฯ และไม่ส่งต่อไปภูมิภาคอื่น ตอนนี้ยังไม่มีโมเดลที่ให้บริการจากกรุงเทพฯ คำขอภายใต้ strict จึงจะถูกปฏิเสธด้วย 400
regional (ตามภูมิภาค)
ค่าเริ่มต้น ระบบจะเลือกภูมิภาคที่ใกล้ที่สุดก่อน โดยเรียงจากกรุงเทพฯ สิงคโปร์ และโตเกียว หากโมเดลไม่มีให้บริการในภูมิภาคเหล่านี้ ระบบจะส่งไปยังภูมิภาค global ของผู้ให้บริการโมเดล ซึ่งอาจอยู่นอกเอเชีย
available (ทุกภูมิภาค)
เปิดให้เฉพาะองค์กรที่แจ้งขอเป็นลายลักษณ์อักษร ครอบคลุมทุกภูมิภาคเดียวกับ regional และรวมผู้ให้บริการในจีนแผ่นดินใหญ่ด้วย โมเดลสร้างภาพและวิดีโอที่ให้บริการนอกกรุงเทพฯ สิงคโปร์ และโตเกียว ต้องใช้ Routing Policy นี้

เติมเครดิตและรับใบกำกับภาษี

ทุกคำขอตัดเงินจากเครดิตเงินบาทแบบเติมล่วงหน้าขององค์กร เติมได้ในพอร์ทัลสมาชิกที่เมนูกระเป๋าเครดิต และเครดิตจะเข้าเมื่อยืนยันการชำระเงินแล้ว

การเติมเครดิต

ใครเติมได้
เจ้าของ (Owner) และ Admin ขององค์กร สมาชิกคนอื่นส่งคำขอให้เติมเครดิตถึงคนเหล่านี้ได้จากพอร์ทัล
ยอดเติม
ขั้นต่ำ ฿300 ระบุเป็นบาท ทศนิยมไม่เกิน 2 ตำแหน่ง ยอดที่ระบุคือเครดิตที่จะได้รับ ส่วน VAT 7% จะบวกเพิ่มตอนชำระเงิน
ช่องทางชำระเงิน
PromptPay QR (ค่าเริ่มต้น) หรือบัตรเครดิต/เดบิต QR มีอายุ 30 นาที และพอร์ทัลจะตรวจสถานะการชำระเงินให้อัตโนมัติ
ชำระแล้วแต่เครดิตไม่เข้า
อัปโหลดรูปสลิปที่รายการเติมเงินนั้น เจ้าหน้าที่จะตรวจกับข้อมูลของธนาคารก่อนเพิ่มเครดิต สลิปไม่เพิ่มเครดิตให้เองโดยอัตโนมัติ

ใบกำกับภาษีและภาษีหัก ณ ที่จ่าย

ทุกครั้งที่เติม
กรอกชื่อและอีเมลผู้ซื้อ แล้วรับใบกำกับภาษีอย่างย่อ
ใบกำกับภาษีเต็มรูปแบบ
เลือกใบกำกับภาษีเต็มรูปแบบตอนเติมเงิน แล้วกรอกเลขประจำตัวผู้เสียภาษี 13 หลัก ประเภทผู้ซื้อ (บุคคลหรือนิติบุคคล) และที่อยู่ นิติบุคคลต้องกรอกรหัสสาขา 5 หลักด้วย สำนักงานใหญ่คือ 00000 ถ้าเป็นสาขาให้กรอกชื่อสาขาด้วย
ภาษีหัก ณ ที่จ่าย 3%
สำหรับบัญชีองค์กร (B2B) ชำระเต็มจำนวนก่อน แล้วให้เจ้าของหรือ Admin ขอคืน 3% ในพอร์ทัล โดยอัปโหลดหนังสือรับรองการหักภาษี ณ ที่จ่าย (50 ทวิ) เป็นรูปหรือ PDF ขนาดไม่เกิน 10 MB แล้วเลือกรายการเติมเงินที่หนังสือฉบับนั้นครอบคลุม ฉบับเดียวครอบคลุมได้หลายรายการ ใช้ได้เฉพาะรายการที่ชำระแล้วและมียอดก่อน VAT ตั้งแต่ ฿1,000 และคิด 3% จากยอดก่อน VAT เมื่อเจ้าหน้าที่อนุมัติแล้ว ยอด 3% จะเข้าเครดิตของคุณ

ผู้ช่วย AI สำเร็จรูปสำหรับงานประจำ

ผู้ช่วยคืองานที่ตั้งไว้ครั้งเดียว เช่น จัดหมวดค่าใช้จ่าย สรุปอีเมล คัดรีวิว หรือดึงข้อมูลออกจากข้อความ คุณเลือกงาน ตั้งชื่อ และเลือกโมเดล ส่วนคำสั่งเราเก็บไว้ให้ จากนั้นระบบของคุณเรียกด้วยชื่อ app/ชื่อของคุณ ในโปรแกรมใดก็ได้ที่มีช่องโมเดลแบบ OpenAI

สร้างในพอร์ทัล

  1. เลือกงาน. เริ่มจากงานสำเร็จรูป คือ จัดหมวดค่าใช้จ่าย สรุปเอกสารหรืออีเมล จัดกลุ่มความเห็นลูกค้าเป็น ชม / ติ / สอบถาม หรือดึงชื่อ เบอร์โทร ยอดเงิน วันที่ เป็นข้อมูลมีโครงสร้าง หรือเริ่มจากว่างแล้วเขียนคำสั่งเอง
  2. ตั้งชื่อ. ตั้งชื่อที่แสดงและชื่อที่ใช้เรียก ซึ่งใช้ได้เฉพาะ a–z, 0–9 และ - ยาว 3–40 ตัว ชื่อที่ใช้เรียกจะเป็น app/<ชื่อ> และเปลี่ยนไม่ได้ภายหลัง เพราะระบบของคุณอ้างถึงชื่อนี้
  3. เลือกโมเดล. โมเดลมีป้าย ประหยัด สมดุล หรือแม่นยำสุด พร้อมค่าใช้จ่ายโดยประมาณต่อ 1,000 ครั้งโดยทั่วไป เปรียบเทียบได้โดยไม่ต้องรู้ว่าโทเคนคืออะไร และเปลี่ยนโมเดลภายหลังได้
  4. ลองใช้ แล้วเชื่อมต่อ. ส่งข้อความจริงจากแท็บ “ลองใช้” (คิดเงินเหมือนการเรียกปกติ) แล้วคัดลอก Base URL และชื่อที่ใช้เรียกจากแท็บ “วิธีเชื่อมต่อ” ไปใส่ในระบบของคุณ

วิธีเรียก

ใช้ Base URL และ API key เดียวกับคำขออื่น แล้วใส่ชื่อผู้ช่วยในช่องโมเดล ส่งเฉพาะข้อความที่ต้องการให้ผู้ช่วยทำงานด้วย คำสั่งที่เก็บไว้จะถูกใส่นำหน้าให้เอง

python
resp = client.chat.completions.create(
    model="app/accounting-helper",
    messages=[{"role": "user", "content": "ค่าแท็กซี่ไปพบลูกค้า 250 บาท"}],
)
print(resp.choices[0].message.content)

ควรรู้

ใครตั้งค่าได้
เจ้าของและผู้ดูแลสร้าง แก้ไข ปิดชั่วคราว และลบผู้ช่วยได้ในพอร์ทัล สมาชิกคนอื่นใช้และลองใช้ได้
เปลี่ยนได้โดยไม่ต้องแก้ระบบ
โมเดลและคำสั่งอยู่กับเรา แก้ในพอร์ทัลแล้วการเรียกครั้งถัดไปใช้เวอร์ชันใหม่ ทุกครั้งที่แก้จะบันทึกเป็นเวอร์ชัน ย้อนกลับได้
ค่าใช้จ่าย
คิดตามโทเคนในราคาของโมเดลที่เลือก เหมือนเรียกโมเดลนั้นเอง คำสั่งและตัวอย่างที่เก็บไว้นับเป็นโทเคนขาเข้าทุกครั้งที่เรียก คำสั่งสั้นจึงถูกกว่า ไม่มีค่าธรรมเนียมเพิ่มสำหรับการใช้ผู้ช่วย
สิ่งที่ส่งได้
ข้อความของคุณต่อท้ายคำสั่งที่เก็บไว้ ความยาวคำตอบถูกจำกัดที่ค่าที่ต่ำกว่าระหว่างขีดจำกัดของผู้ช่วยกับ max_tokens ที่คุณส่ง ถ้าผู้ช่วยกำหนด temperature หรือรูปแบบคำตอบไว้ ค่าของผู้ช่วยมีผลก่อนค่าในคำขอ
ข้อมูลมีโครงสร้าง (JSON)
ผู้ช่วยที่ตั้งให้ตอบเป็น JSON จะตอบตามโครงสร้างที่กำหนดไว้เสมอ และใช้ได้เฉพาะโมเดลที่รองรับผลลัพธ์แบบมีโครงสร้าง
รายการและการใช้งาน
GET /v1/models แสดงผู้ช่วยขององค์กรคุณในรูป app/<ชื่อ> ต่อจากรายการโมเดล ส่วนการเรียกดูผู้ช่วยตัวเดียวด้วย GET /v1/models/app/<ชื่อ> ยังไม่รองรับ หน้าการใช้งานในพอร์ทัลแสดงว่าแต่ละคำขอผ่านผู้ช่วยตัวไหน

ข้อผิดพลาดเฉพาะของผู้ช่วย

404 ไม่พบผู้ช่วย

ชื่อผิด ผู้ช่วยถูกปิดหรือลบแล้ว หรือเป็นของอีกองค์กร คำตอบเหมือนกันทุกกรณีโดยตั้งใจ หลังสร้างหรือเปิดใช้ให้รอได้ถึงประมาณ 30 วินาที ไม่คิดเงิน

No assistant named … exists for this organisation.
400 ไม่ใช่คำขอแบบแชต

ผู้ช่วยใช้ได้กับ chat completions เท่านั้น คำขอต้องมีรายการ messages ไม่คิดเงิน

… is an assistant and can only be used with the chat completions endpoint …
503 ใช้งานไม่ได้ชั่วคราว

มีผู้ช่วยนี้อยู่ แต่นำคำสั่งที่เก็บไว้มาใช้ไม่ได้ เราไม่รันคำขอโดยไม่มีคำสั่งของผู้ช่วย จึงไม่คิดเงิน ลองใหม่อีกครั้งในอีกสักครู่

… is temporarily unavailable. Please try again shortly.

ข้อผิดพลาดตอบกลับในรูป {"error": {"message": …}} พร้อมรหัส HTTP ส่วนข้อผิดพลาดเรื่องเครดิต (402) และการจำกัดอัตรา (429) เหมือนที่อธิบายไว้ด้านบน

อัปเดตล่าสุด

มีอะไรเปลี่ยนในรอบล่าสุด

  1. ใหม่

    ผู้ช่วย AI และใบเสร็จทางอีเมล

    • ผู้ช่วย AI: เมนูใหม่ในพอร์ทัลสมาชิก สร้างผู้ช่วยสำเร็จรูปที่เรียกใช้ด้วยชื่อ (`app/<ชื่อ>`) โดยไม่ต้องเลือกและตั้งค่าโมเดลเอง มีตัวช่วยสร้างทีละขั้นตอน
    • คู่มือในหน้าผู้ช่วย AI พร้อมตัวอย่างเริ่มต้น ช่องลองใช้งาน และวิธีเชื่อมต่อกับ n8n และ Make
    • ใช้ผู้ช่วย AI จาก Google Sheets: มีคู่มือทีละขั้นตอนพร้อมสคริปต์สำเร็จรูปให้คัดลอกไปวางในชีต เรียกผู้ช่วยจากสูตรในเซลล์ได้
  2. ใหม่ปรับปรุงแก้ไข

    รีวิวจากผู้ใช้ และบัญชีที่เชื่อมสำหรับเข้าสู่ระบบ

    • รีวิวจากผู้ใช้: เขียนรีวิวการใช้งานได้จากพอร์ทัลสมาชิก (เดือนละ 1 ครั้ง) รีวิวที่ผ่านการตรวจสอบจะแสดงบนหน้าแรก
    • บัญชีที่เชื่อมสำหรับเข้าสู่ระบบในหน้าโปรไฟล์: ดูได้ว่าเชื่อมกับบัญชี Google หรือ Microsoft ใด และยกเลิกการเชื่อมได้หลังยืนยันรหัสผ่าน
    • ประวัติความปลอดภัยแสดงการเข้าสู่ระบบและการยืนยันตัวตนสองขั้นตอนที่ไม่สำเร็จด้วย
ดูการอัปเดตทั้งหมด →

พร้อมยิง request จริงแล้ว

สร้างคีย์แล้วเช็คราคาต่อโมเดลก่อนเริ่มใช้จริง