API สาธารณะ

Libre WebUI มี API ที่เข้ากันได้กับ OpenAI ดังนั้น SDK โปรแกรมแก้ไข และสคริปต์ที่มีอยู่เพียงเปลี่ยน URL ฐาน

การยืนยันตัวตน

สร้าง token API แบบมี scope ที่ การตั้งค่า → บัญชี → Token API (ขึ้นต้น lwk_ และเก็บเป็น hash) /v1 ต้องใช้ scope chat ส่ง token ด้วยรูปแบบ Bearer:

export OPENAI_BASE_URL="https://your-instance/v1"
export OPENAI_API_KEY="lwk_..."

ขีดจำกัดคือ 600 คำขอต่อนาทีต่อ token รวมกับขีดจำกัด chat ที่ใช้ร่วมกัน

Endpoint

Endpoint	วัตถุประสงค์
GET /v1/models	โมเดล local และจาก provider ที่ใช้ได้
POST /v1/chat/completions	chat แบบ stateless ทั้ง streaming และไม่ streaming

POST /v1/chat/completions รับ model, messages (system/user/assistant), stream, temperature, top_p, max_tokens/max_completion_tokens, seed และ stop แบบ streaming ส่ง SSE chat.completion.chunk จนถึง data: [DONE] ส่วนการตอบแบบไม่ streaming มี usage หาก provider รายงาน

curl "$OPENAI_BASE_URL/chat/completions" \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "llama3.2",
    "messages": [{"role": "user", "content": "One sentence on herons."}]
  }'

ขอบเขตที่กำหนดไว้

/v1 คือ inference แบบ stateless: ไม่สร้าง chat ไม่แก้ฐานความรู้ และไม่เรียกใช้ tool การสนทนาแบบ stateful, event ที่คงทน, การยกเลิกผูกกับตัวตน, คิวแบบ idempotent และวงจร tool แบบ native อยู่ใน /api/chat ซึ่ง token เดิมเข้าถึงได้ด้วย scope chat role อื่นนอกจาก system/user/assistant เช่น tool จะถูกปฏิเสธ

เอกสารที่เกี่ยวข้อง

• การยืนยันตัวตน
• เครื่องมือ chat