เชื่อมต่อ
เชื่อมเครื่องมือภายนอกกับ ClickNext
อัปเดตล่าสุด 17 พ.ย. 2026
ต่อ VS Code, Warp, Cursor, Claude Code, OpenCode หรือทุกเครื่องมือที่รับ base URL แบบ OpenAI/Anthropic เข้ากับ ClickNext Gateway ด้วย virtual key cnx- ตัวเดียว
ทุกทราฟฟิกวิ่งผ่านเกตเวย์ของเราเอง — IT หมุนคีย์ คุมโควตา และดู log กลางได้ที่เดียว ผู้ใช้ไม่ต้องถือ provider key ดิบบนเครื่องเลย เลือกโมเดล auto ให้เกตเวย์เลือกให้ หรือระบุโมเดลเองก็ได้ (ดู โมเดลที่ใช้ได้)
/api/v1 · ฝั่ง Claude Code (Anthropic) ใส่แค่ /api (ตัว SDK เติม /v1/messages ให้เอง) · คีย์คือ cnx- ของคุณเสมอขอ cnx- key
virtual key ขึ้นต้นด้วย cnx- ผูกกับอีเมลบริษัทของคุณ เพิกถอน/ออกใหม่ได้โดยไม่กระทบคนอื่น
agent-auto …) — เปิด แดชบอร์ด → เมนู ของฉัน → กล่อง API Key ของฉัน → กด ดู key (เห็นได้เฉพาะคีย์ของตัวเอง และทุกครั้งที่กดดูถูกบันทึกไว้)cnx- เท่านั้น ถ้าคีย์รั่ว แจ้ง IT เพิกถอนได้ทันทีEndpoint และ Schema
เกตเวย์รองรับสองสายโปรโตคอล เลือกให้ตรงกับเครื่องมือ
| สาย | Base URL | ใช้กับ |
|---|---|---|
| OpenAI-compatible | https://caw.clicknext.com/api/v1 | VS Code, Warp, Cursor, OpenCode, Continue, Aider, Zed, OpenAI SDK |
| Anthropic-wire | https://caw.clicknext.com/api | Claude Code, Anthropic SDK (SDK เติม /v1/messages เอง) |
ค่าที่ตั้งไว้ด้วยที่อยู่เดิม https://clicknexttest.biz ยังใช้งานได้ตามปกติ ไม่ต้องแก้
ส่งคีย์ได้ 2 แบบ (ใช้ได้ทั้งสองสาย): Authorization: Bearer cnx-xxxxxxxx หรือ x-api-key: cnx-xxxxxxxx
Endpoint ที่เปิดให้ใช้
| Endpoint | ใช้ทำอะไร |
|---|---|
POST /api/v1/chat/completions | แชทแบบ OpenAI — รองรับ stream และ function tools |
POST /api/v1/messages | แชทแบบ Anthropic (Claude Code) — รองรับ tools, stream และรูปภาพ (ถ้าโมเดลรองรับ) |
GET /api/v1/models | รายชื่อโมเดลแชทที่คีย์นี้ใช้ได้ (พร้อม context_window) |
GET /api/v1/limits | โควตาและยอดใช้ของคีย์ — ดู โควตาและลิมิต |
POST /api/v1/images/generations | สร้างรูปแบบ OpenAI — ดู สร้างรูปผ่าน API |
GET /api/v1/images/generations/<id> | ดูผลงานสร้างรูปที่ส่งแบบ async |
POST /api/v1/audio/transcriptions | ถอดเสียงภาษาไทยแบบ OpenAI (รันบนเครื่องในบริษัท) ไฟล์ไม่เกิน 100 MB ผลเป็น json / text / verbose_json / srt / vtt ไฟล์ยาวใส่ ?async=1 ไม่นับโควตาโทเคน — ดู ถอดเสียงผ่าน API |
GET /api/v1/audio/transcriptions/<id> | ดูผลถอดเสียงที่ส่งแบบ async |
POST /api/v1/agents/<id>/chat/completions | เรียก Agent ที่สร้างใน Agent Studio ของ /chat แบบ OpenAI (ได้คำสั่ง คลังความรู้ และโมเดลของ Agent นั้น) — ดู URL ได้ในหน้าแก้ Agent หัวข้อ เรียกผ่าน API · เจ้าของคีย์ต้องมีสิทธิ์ใช้ Agent นั้น |
GET /api/v1/projects | โปรเจกต์ (งานต่อเนื่อง) ของคุณ — ดู Header เสริม |
GET /api/opencode.json | ไฟล์ตั้งค่า OpenCode ที่สร้างจากรายชื่อโมเดลจริง |
POST /api/mcp | ClickNext MCP — ดู หน้า MCP |
/v1/responses, /v1/embeddings และ /v1/messages/count_tokens (เรียกแล้วได้ 404) ดังนั้นอย่าเลือก schema แบบ “OpenAI Responses” และไม่ต้องตั้ง reasoning_effort เอง เกตเวย์จัดการให้อัตโนมัติเมื่อใช้ tools- stream บนสาย OpenAI
- ไหลเป็นโทเคนตามปกติ ยกเว้นโมเดล Claude: ส่ง Claude แบบ
streamหรือพร้อมtoolsผ่านสาย OpenAI ไม่ได้ (stream จะถูกย้ายไปโมเดลสำรองหรือได้ 400) ให้ใช้สาย Anthropic/api/v1/messages(base/api) - stream บนสาย Anthropic เมื่อรันบนโมเดลที่ไม่ใช่ Claude (เช่น GPT) เกตเวย์ประมวลผลทั้งรอบก่อน แล้วส่งกลับเป็นรูปแบบ SSE ทีเดียวตอนจบ
- ไหลเป็นโทเคนตามปกติ ยกเว้นโมเดล Claude: ส่ง Claude แบบ
- ส่ง
max_tokens/temperatureได้ตามปกติ — กับ GPT รุ่นใหม่ (เช่น GPT-5.x) เกตเวย์แปลงเป็นmax_completion_tokensให้ และตัดtemperatureที่ไม่ใช่ 1 ออก (โมเดลรุ่นนี้ไม่รับ) - ทุกคำขอผ่าน DLP: ถ้าเจอข้อมูลอ่อนไหว (เช่น คีย์/รหัสผ่านในข้อความ) จะถูกบันทึกเป็นเหตุการณ์ให้ IT เห็น แต่บนคลาวด์ ClickNext ไม่บล็อก คำขอยังส่งถึงโมเดลตามปกติ (งานโค้ดมีข้อความหน้าตาเหมือนความลับ) ยกเว้นองค์กรลูกค้าที่ตั้งกฎของตัวเองไว้ · อย่าวางความลับลงใน prompt
- Data Shield: ก่อนคำขอออกไปถึงโมเดลภายนอก เกตเวย์แทนความลับและเลขสำคัญด้วยป้าย เช่น
[API_KEY#1]แล้วใส่ค่าจริงคืนในคำตอบให้เอง ยกเว้นคำสั่งที่ส่งข้อมูลออกนอกเครื่อง — ดู ข้อควรรู้เพิ่มเติม - ขนาดคำขอ ไม่เกิน 10 MB ต่อคำขอ (ถอดเสียงไม่เกิน 100 MB) เกินได้ 413
ตั้งค่าตามเครื่องมือ
เลือกเครื่องมือของคุณ แล้วคัดลอกค่าไปวางได้เลย (แทน cnx-xxxx ด้วยคีย์ของคุณ)
ใน Warp: เปิด Settings แล้วค้นคำว่า inference endpoint (Custom inference endpoint) จากนั้นเพิ่ม endpoint ใหม่
| API schema | OpenAI Chat Completions |
| Endpoint URL | https://caw.clicknext.com/api/v1 |
| API key | cnx-xxxxxxxx |
| Model name | gpt-6-luna · alias (ไม่บังคับ): clicknext |
auto ได้ · รายละเอียดจุดที่มักพลาด ดู Warp โดยละเอียดใช้แชทของ VS Code เอง (Chat / Agent mode) กับโมเดลของ ClickNext — ไม่ต้องล็อกอิน GitHub และไม่ต้องมีแพ็กเกจ Copilot · ต้องใช้ VS Code 1.122 ขึ้นไป
Ctrl+Shift+P (Mac: ⌘⇧P) พิมพ์ Chat: Manage Language Models หรือกดรูปเฟืองในตัวเลือกโมเดลของช่องแชทClickNext → วางคีย์ cnx- ของคุณ → API type เลือก Chat Completions (VS Code เก็บคีย์ไว้ในที่เก็บรหัสลับของเครื่อง ไม่เขียนลงไฟล์)chatLanguageModels.json ให้ — ในกลุ่ม ClickNext แทนที่ "models": [ … ] ทั้งก้อนด้วยข้อความด้านล่าง แล้วบันทึก (บรรทัด apiKey ที่ VS Code เขียนไว้ไม่ต้องแตะ)Developer: Reload Window"models": [
{
"id": "gpt-6-luna",
"name": "GPT-6 Luna",
"url": "https://caw.clicknext.com/api/v1/chat/completions",
"toolCalling": true,
"vision": true,
"maxInputTokens": 400000,
"maxOutputTokens": 64000,
"requestHeaders": { "x-clicknext-client": "vscode/custom-endpoint" }
},
{
"id": "glm-5.3-flash",
"name": "GLM-5.3 Flash (ฟรี)",
"url": "https://caw.clicknext.com/api/v1/chat/completions",
"toolCalling": true,
"vision": true,
"maxInputTokens": 200000,
"maxOutputTokens": 16000,
"requestHeaders": { "x-clicknext-client": "vscode/custom-endpoint" }
},
{
"id": "auto",
"name": "Auto (เกตเวย์เลือกให้)",
"url": "https://caw.clicknext.com/api/v1/chat/completions",
"toolCalling": true,
"vision": true,
"maxInputTokens": 112000,
"maxOutputTokens": 16000,
"requestHeaders": { "x-clicknext-client": "vscode/custom-endpoint" }
}
]- (อ่าน/แก้ไฟล์, รันคำสั่งในเทอร์มินัล) ผ่านเกตเวย์ทุกคำขอ — มีโควตา, DLP และ log เหมือนเครื่องมืออื่น
- header
x-clicknext-clientทำให้แดชบอร์ดแสดงรายการเหล่านี้เป็น VS Code idต้องอยู่ในรายการของคีย์คุณ (ดู/api/v1/models) ลบก้อนที่ไม่ใช้ออกได้
/v1/responses จะได้ 404) และไม่ต้องใส่ "thinking": true เกตเวย์จัดการ reasoning ให้เอง · คำแนะนำโค้ดอัตโนมัติขณะพิมพ์ (inline suggestions) ยังเป็นของ GitHub Copilot ไม่ผ่านเกตเวย์ — เฉพาะแชทและ agent ที่ใช้โมเดลของ ClickNextชอบส่วนขยายอื่นใน VS Code: Cline / Continue ดูแท็บ Cline / Continue / Aider · Claude Code (ส่วนขยาย VS Code) ใช้ค่าเดียวกับแท็บ Claude Code · อยากให้แชทของ VS Code เรียกเครื่องมือของ ClickNext (สกิล, สมององค์กร, Hub) ด้วย ต่อ MCP ที่ หน้า MCP → VS Code
Cursor: Settings → Models → OpenAI API Key เปิด “Override OpenAI Base URL”
| Base URL | https://caw.clicknext.com/api/v1 |
| API Key | cnx-xxxxxxxx |
| Model | gpt-6-luna (หรือ auto) |
gpt-6-luna) ก่อนกด verifyClaude Code ใช้สาย Anthropic — base ใส่แค่ /api (SDK เติม /v1/messages ให้เอง) รองรับ tools เต็มรูปแบบ
macOS / Linux
export ANTHROPIC_BASE_URL=https://caw.clicknext.com/api export ANTHROPIC_AUTH_TOKEN=cnx-xxxxxxxx export ANTHROPIC_MODEL=auto export ANTHROPIC_DEFAULT_HAIKU_MODEL=auto claude
Windows (PowerShell)
$env:ANTHROPIC_BASE_URL="https://caw.clicknext.com/api" $env:ANTHROPIC_AUTH_TOKEN="cnx-xxxxxxxx" $env:ANTHROPIC_MODEL="auto" $env:ANTHROPIC_DEFAULT_HAIKU_MODEL="auto" claude
หรือใส่ถาวรใน ~/.claude/settings.json
{
"env": {
"ANTHROPIC_BASE_URL": "https://caw.clicknext.com/api",
"ANTHROPIC_AUTH_TOKEN": "cnx-xxxxxxxx",
"ANTHROPIC_MODEL": "auto",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "auto"
}
}ANTHROPIC_DEFAULT_HAIKU_MODEL: Claude Code ใช้โมเดลเล็กตระกูล haiku ทำงานเบื้องหลัง ถ้าคีย์ของคุณไม่มีสิทธิ์โมเดล Claude งานเบื้องหลังจะถูกย้ายไปรันบน gpt-6-luna แทน (หรือได้ 403 ถ้าคีย์ใช้ gpt-6-luna ไม่ได้) — ตั้งเป็น auto (หรือโมเดลที่อยู่ในรายการของคุณ) ไว้ด้วย · ถ้าจะสลับโมเดลด้วยคำสั่ง /model ให้ตั้ง ANTHROPIC_DEFAULT_SONNET_MODEL / ANTHROPIC_DEFAULT_OPUS_MODEL เป็นโมเดลที่คีย์ใช้ได้เช่นกัน- โมเดล Claude (
claude-opus-5-5/claude-sonnet-5-5/claude-haiku-5-5) ใช้ได้เฉพาะคีย์ที่แอดมินเปิดสิทธิ์ Anthropic ให้ — เช็กจาก/api/v1/modelsก่อน ถ้าไม่มีในรายการ เกตเวย์จะรันบนgpt-6-lunaแทน (หรือได้ 403 ถ้าคีย์ใช้ gpt-6-luna ไม่ได้) - กับโมเดล GPT-5.x / GPT-6.x (luna / sol / terra) ที่มี tools เกตเวย์ส่งผ่านโหมดคิด (Responses API) ให้เอง
- เมื่อใช้ Claude Code เกตเวย์ให้ agent แนะนำตัวว่า ClickNext Agent และตอบตามภาษาของข้อความล่าสุดของผู้ใช้ (ไม่แน่ใจจะตอบไทย)
วิธีเร็ว (แนะนำ): ให้เกตเวย์สร้างไฟล์ตั้งค่าจากรายชื่อโมเดลจริง
opencode auth login → เลือก Other → ช่อง Provider id พิมพ์ clicknext → วางคีย์ cnx-opencode.json เดิมจะถูกเขียนทับ)opencode แล้วเลือก clicknext/gpt-6-luna (ตั้งเป็นค่าเริ่มต้นไว้ให้แล้ว)mkdir -p ~/.config/opencode && curl -fsSL \ -H "Authorization: Bearer cnx-xxxxxxxx" \ https://caw.clicknext.com/api/opencode.json \ -o ~/.config/opencode/opencode.json
หรือเขียนเอง ในไฟล์ opencode.json
{
"provider": {
"clicknext": {
"npm": "@ai-sdk/openai-compatible",
"options": {
"baseURL": "https://caw.clicknext.com/api/v1",
"apiKey": "cnx-xxxxxxxx"
},
"models": { "gpt-6-luna": {}, "auto": {} }
}
}
}wire_api = "responses") เท่านั้น แต่เกตเวย์มีแค่ Chat Completions — เรียกแล้วจะได้ 404ยังต่อ ClickNext MCP เข้า Codex ได้ (ให้ Codex เรียกคลังสกิล, สมององค์กร, Hub ของเรา) — ดูวิธีที่ หน้า MCP → Codex
Cline / Roo Code (VS Code) — Settings ของส่วนขยาย
| API Provider | OpenAI Compatible |
| Base URL | https://caw.clicknext.com/api/v1 |
| API Key | cnx-xxxxxxxx |
| Model ID | gpt-6-luna (หรือ auto) |
Continue (VS Code / JetBrains) — เพิ่มใน ~/.continue/config.yaml
models:
- name: ClickNext Gateway
provider: openai
model: gpt-6-luna
apiBase: https://caw.clicknext.com/api/v1
apiKey: cnx-xxxxxxxxAider (CLI)
export OPENAI_API_BASE=https://caw.clicknext.com/api/v1 export OPENAI_API_KEY=cnx-xxxxxxxx aider --model openai/gpt-6-luna
ใช้ได้กับ OpenAI SDK, Anthropic SDK, Zed และทุกอย่างที่รับ base URL แบบ OpenAI/Anthropic
curl
curl https://caw.clicknext.com/api/v1/chat/completions \
-H "Authorization: Bearer cnx-xxxxxxxx" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-6-luna","messages":[{"role":"user","content":"สวัสดี"}]}'Python (OpenAI SDK)
from openai import OpenAI
client = OpenAI(api_key="cnx-xxxxxxxx",
base_url="https://caw.clicknext.com/api/v1")
r = client.chat.completions.create(
model="gpt-6-luna",
messages=[{"role": "user", "content": "สวัสดี"}])
print(r.choices[0].message.content)Node.js (OpenAI SDK)
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.CLICKNEXT_KEY, // cnx-xxxxxxxx
baseURL: "https://caw.clicknext.com/api/v1",
});
const r = await client.chat.completions.create({
model: "gpt-6-luna",
messages: [{ role: "user", content: "สวัสดี" }],
});
console.log(r.choices[0].message.content);Python (Anthropic SDK) — base ใส่แค่ /api
import anthropic
client = anthropic.Anthropic(api_key="cnx-xxxxxxxx",
base_url="https://caw.clicknext.com/api")
r = client.messages.create(
model="auto", max_tokens=1024,
messages=[{"role": "user", "content": "สวัสดี"}])
print("".join(b.text for b in r.content if b.type == "text"))Warp โดยละเอียด
สรุปจุดที่ทำให้ Warp ต่อไม่ติดบ่อยที่สุด
- เลือก schema ให้ถูก: ใช้ OpenAI Chat Completions — ไม่ใช่ “OpenAI Responses” (เกตเวย์ไม่มี route
/v1/responsesจะได้ 404) - Endpoint URL ลงท้าย
/api/v1(ไม่ต้องใส่/chat/completionsต่อท้าย) - ปล่อยเรื่อง reasoning ให้เกตเวย์: โมเดลตระกูล GPT-5.x และ GPT-6.x (รวม
gpt-6.1-terra) รวม function tools กับreasoning_effortบน chat/completions ไม่ได้ เกตเวย์จึงตั้งreasoning_effortเป็นnoneให้เองเมื่อคำขอมี tools — ฝั่ง Warp ไม่ต้องตั้งอะไรเพิ่ม (ผลคือรอบที่มี tools บนสายนี้ไม่ใช้โหมดคิดลึก) - Model name ต้องอยู่ในรายการของคีย์คุณ เช่น
gpt-6-lunaหรือauto— ดูรายการจริงจาก/api/v1/models
Function tools with reasoning_effort are not supported… — ตอนนี้เกตเวย์แก้ให้แล้ว เพียงใช้ Chat Completions + โมเดลข้างต้นใช้ GLM-5.3 Flash (ฟรี ไม่นับโควตา)
โมเดลที่รันบนเครื่อง GPU ในบริษัทเอง ใช้ได้ไม่จำกัด เหมาะกับงานทั่วไป งานที่ข้อมูลไม่ควรออกนอกบริษัท หรือตอนโควตาโมเดลหลักใกล้หมด
| Model name | glm-5.3-flash |
| ค่าใช้จ่าย | ฟรี ไม่นับเข้าโควตาโทเคนของคีย์ (ใน /api/v1/limits แถวของโมเดลนี้มี "free": true) |
| Context window | 228K โทเคน (ตามที่เครื่อง GPU ตั้งไว้ ค่าจริงดูจาก context_window ใน /api/v1/models) |
| เรียก tools | ได้ ทั้ง Chat Completions (/api/v1) และ Anthropic Messages (/api) |
| อ่านรูป | ได้ (ส่งรูปให้โมเดลอ่านเอง) แต่ข้อความภาษาไทยในรูปอาจอ่านพลาด งานที่ต้องอ่านรูปให้แม่นใช้ gpt-6-luna |
| ข้อมูล | ประมวลผลบนเครื่องในบริษัท ไม่ส่งออกไปผู้ให้บริการภายนอก (Data Shield จึงไม่แทนค่าในคำขอที่ไป GLM) |
ใช้ endpoint และคีย์ cnx- เดิม แค่เปลี่ยนชื่อโมเดลเป็น glm-5.3-flash ตามเครื่องมือที่ใช้
ตั้งค่าเหมือนใน ตั้งค่าตามเครื่องมือ ทุกอย่าง ยกเว้นช่องชื่อโมเดล
- VS Code: ตัวอย่างในแท็บ VS Code มี
glm-5.3-flashอยู่แล้ว — เลือก GLM-5.3 Flash (ฟรี) จากตัวเลือกโมเดลในช่องแชท - Warp: Custom inference endpoint → Model name =
glm-5.3-flash(เพิ่มเป็น endpoint ที่สองคู่กับgpt-6-lunaได้ จะได้สลับได้) - Cursor: Settings → Models → Add custom model พิมพ์
glm-5.3-flashแล้วเลือกใช้ (Base URL และคีย์ใช้ค่าเดิม) - Cline / Roo Code: API Provider
OpenAI Compatible→ Model ID =glm-5.3-flash
ตั้งตัวแปรเหมือนแท็บ Claude Code ด้านบน แต่ใส่โมเดลเป็น GLM (ตั้ง haiku ด้วย งานเบื้องหลังจะได้ฟรีด้วย)
export ANTHROPIC_BASE_URL=https://caw.clicknext.com/api export ANTHROPIC_AUTH_TOKEN=cnx-xxxxxxxx export ANTHROPIC_MODEL=glm-5.3-flash export ANTHROPIC_DEFAULT_HAIKU_MODEL=glm-5.3-flash
Windows PowerShell
$env:ANTHROPIC_BASE_URL="https://caw.clicknext.com/api" $env:ANTHROPIC_AUTH_TOKEN="cnx-xxxxxxxx" $env:ANTHROPIC_MODEL="glm-5.3-flash" $env:ANTHROPIC_DEFAULT_HAIKU_MODEL="glm-5.3-flash"
ANTHROPIC_DEFAULT_SONNET_MODEL=glm-5.3-flash แล้วพิมพ์ /model sonnet ใน Claude Codeถ้าคีย์ของคุณมีสิทธิ์ GLM คำสั่ง /api/opencode.json ในแท็บ OpenCode ใส่ให้แล้ว ถ้ายังไม่มี เพิ่มบรรทัดนี้ใน models ของ provider clicknext ใน opencode.json
"models": {
"gpt-6-luna": {},
"auto": {},
"glm-5.3-flash": { "name": "GLM-5.3 Flash (ฟรี)", "limit": { "context": 228000, "output": 16384 } }
}จากนั้นใน OpenCode กด /models แล้วเลือก clicknext/glm-5.3-flash
Continue เพิ่มอีกรายการใน ~/.continue/config.yaml
models:
- name: GLM-5.3 Flash (ClickNext, ฟรี)
provider: openai
model: glm-5.3-flash
apiBase: https://caw.clicknext.com/api/v1
apiKey: cnx-xxxxxxxxAider
export OPENAI_API_BASE=https://caw.clicknext.com/api/v1 export OPENAI_API_KEY=cnx-xxxxxxxx aider --model openai/glm-5.3-flash
curl https://caw.clicknext.com/api/v1/chat/completions \
-H "Authorization: Bearer cnx-xxxxxxxx" \
-H "Content-Type: application/json" \
-d '{"model":"glm-5.3-flash","messages":[{"role":"user","content":"สวัสดี"}]}'from openai import OpenAI
client = OpenAI(api_key="cnx-xxxxxxxx",
base_url="https://caw.clicknext.com/api/v1")
r = client.chat.completions.create(
model="glm-5.3-flash",
messages=[{"role": "user", "content": "สวัสดี"}])
print(r.choices[0].message.content)- ไม่ต้องตั้งเรื่อง thinking เอง:
- เกตเวย์ตั้งโหมดคิดของ GLM ให้ (คิดสั้น ตอบไทย เร็ว) ไม่ต้องส่ง
chat_template_kwargsหรือenable_thinking(ถ้าส่งenable_thinkingแบบ Qwen มา เกตเวย์แปลงเป็นค่าของ GLM ให้) - อยากให้คิดลึกขึ้น ส่ง
"reasoning_effort": "medium"หรือ"high"ใน Chat Completions (ลึกสุดใช้"xhigh") - header
x-clicknext-effortมีผลกับ GPT เท่านั้น
- เกตเวย์ตั้งโหมดคิดของ GLM ให้ (คิดสั้น ตอบไทย เร็ว) ไม่ต้องส่ง
- ชื่อเก่ายังใช้ได้: config ที่ยังเขียน
Inferact/Qwen3.8-Flash-Next-NVFP4หรือllm-lab/…เกตเวย์เปลี่ยนเป็นglm-5.3-flashให้เอง แต่แนะนำให้แก้เป็นชื่อใหม่ - เทียบกับโมเดลหลัก: GLM-5.3 Flash เร็วและฟรี แต่งานยาก (โค้ดหลายไฟล์, วิเคราะห์ซับซ้อน)
gpt-6-lunaยังทำได้ดีกว่า ดูผลเทียบที่ ClickNext Bench - เครื่อง GPU อยู่ในบริษัทเครื่องเดียว: ถ้าเครื่องปิดหรือคิวเต็มจะได้ error 5xx ให้สลับกลับไปใช้
autoหรือgpt-6-luna
ทีมของคุณไม่ได้รับสิทธิ์ใช้โมเดลนี้ ส่วนคีย์ cnx- อาจถูกย้ายไปรันบน gpt-6-luna แทน (นับโควตาตามปกติ) ดูโมเดลที่รันจริงจาก field model ในผลลัพธ์ แล้วแจ้งแอดมินให้เปิดที่ Access Control → ทีม · ถ้าไม่เห็น glm-5.3-flash ใน /api/v1/models ก็ยังลองเรียกตรง ๆ ได้ เพราะรายการนั้นแสดงตาม scope ของคีย์โมเดลที่ใช้ได้
รายการโมเดลขึ้นกับสิทธิ์ของคีย์และทีมของคุณ และแอดมินเพิ่ม/ปิดโมเดลได้ตลอด — ดึงรายการจริงจากเกตเวย์เสมอ
curl https://caw.clicknext.com/api/v1/models \ -H "Authorization: Bearer cnx-xxxxxxxx"
ได้ {"object":"list","data":[{"id":"…","owned_by":"…","context_window":…}]} — ใช้ค่า id เป็นชื่อโมเดลในเครื่องมือได้ทันที (รายการนี้มีเฉพาะโมเดลแชท โมเดลสร้างรูป/วิดีโอไม่แสดง)
ตัวอย่างที่ใช้กันบ่อย (ณ 2 พ.ย. 2026 — คีย์ของคุณอาจมีมากหรือน้อยกว่านี้)
| โมเดล | หมายเหตุ |
|---|---|
auto | Auto Router: ค่าเริ่มต้นส่งทุกงานไป gpt-6-luna (ให้ข้อมูลอยู่กับ provider เดียว และอ่านรูปได้) ชนิดงานใช้เลือกสกิลที่แนบให้เท่านั้น ไม่ได้เปลี่ยนโมเดล (ชื่อสกิลที่แนบอยู่ใน header x-clicknext-skill) · ถ้า gpt-6-luna ล่ม ลองต่อที่ GLM-5.3 Flash แล้ว gemini-2.5-flash · Auto ในเว็บแชทดูแผนของทีมด้วย (แผนปิด gpt-6-luna หรือใช้ครบเพดานรายวันแล้ว จะข้ามไปโมเดลถัดไปที่แผนอนุญาต) ส่วน Auto ของ API ไม่ดูแผนของทีม |
gpt-6-luna | โมเดลหลัก (primary) — ค่าเริ่มต้นที่แนะนำสำหรับทุกเครื่องมือ |
gpt-6-sol, gpt-6.1-sol, gpt-6.1-terra, gpt-5.6-luna, gpt-5.6-sol, gpt-5.6-terra, gpt-4o, gpt-4o-mini | GPT รุ่นอื่น (OpenAI) ที่เปิดให้คีย์พนักงานส่วนใหญ่ (ถ้าขึ้นในรายการของคุณ) |
gemini-2.5-pro, gemini-3.8-flash, gemini-4-argon, grok-4.5, grok-4.6, kimi-k3, seed-2-0-pro-260328 ฯลฯ | โมเดลจาก Google, xAI, Moonshot และ BytePlus ใช้ได้ตามสิทธิ์ของคีย์ (ดูรายการจริงจาก /api/v1/models) |
glm-5.3-flash | โมเดลในบริษัท (เครื่อง GPU) ฟรี ไม่นับโควตา context 228K — ดู ใช้ GLM-5.3 Flash |
claude-opus-5-5, claude-sonnet-5-5, claude-haiku-5-5 | Claude (Anthropic) — เฉพาะคีย์ที่แอดมินเปิดสิทธิ์ · ไม่มีในรายการของคีย์คุณ = เกตเวย์รันบน gpt-6-luna แทน (หรือได้ 403 ถ้าคีย์ใช้ gpt-6-luna ไม่ได้) · Auto ไม่เลือกให้เอง ต้องระบุชื่อ claude มาตรง ๆ |
รายการที่ได้โดยไม่ใส่คีย์ (เช่น /api/opencode.json) อาจมีโมเดลที่ใช้แชทไม่ได้ เช่น jev-* (โมเดลตัดสินใจที่ระบบใช้เบื้องหลัง เรียกแล้วได้ 400) ให้ยึดรายการจาก /api/v1/models ที่ใส่คีย์เสมอ
- ขอโมเดลนอกสิทธิ์: ถ้าคีย์ใช้
gpt-6-lunaได้ เกตเวย์รันคำขอนั้นบนgpt-6-lunaแทนโดยไม่แจ้ง error ถ้าใช้ไม่ได้จะตอบ 403This API key is not allowed to use … - คำขอที่มี tools บนโมเดลของ Google, xAI, Moonshot หรือ BytePlus ก็ถูกย้ายไป
gpt-6-luna(ถ้าคีย์ใช้ได้) - และเกตเวย์ย้ายไปรันบนโมเดลภายในของบริษัท (GLM-5.3 Flash) ใน 3 กรณี: โควตาหมด (ดู โควตาและลิมิต), provider ของโมเดลที่เลือกล่มชั่วคราว และ provider ถูกปิดทั้งเจ้า (เช่น DeepSeek คำตอบมี header
x-clicknext-model-replaced) - ดูโมเดลที่รันจริงได้จาก field
modelในผลลัพธ์ หรือ headerx-clicknext-model(สาย Anthropic)
โควตาและลิมิต
โควตาผูกกับคีย์ แอดมินตั้งได้ทั้งจำนวนโทเคนและงบ (USD) ต่อรอบ
- รอบรีเซ็ต: รายสัปดาห์ (เริ่มนับใหม่ทุกวันจันทร์) หรือรายเดือน (วันที่ 1) ตามที่แอดมินตั้งให้คีย์นั้น — เวลารีเซ็ตที่แน่นอนดูจาก
resets_at - นับรวมกับเว็บแชท:
- โทเคนที่คุณใช้ใน /chat บนเว็บ ถูกนับเข้าโควตาโทเคนของคีย์ด้วย
- ถ้าใช้คีย์
agent-autoตัวเดียวกับแอปเดสก์ท็อป ก็เป็นงบก้อนเดียวกับแอป
- โควตาหมดระหว่างแชท:
- คำขอ
/chat/completionsและ/messagesจะถูกย้ายไปรันบน GLM-5.3 Flash (โมเดลภายในของบริษัท) แทนการตัดทันที (ไม่เสียค่าใช้จ่ายเพิ่ม แต่คำตอบอาจช้าหรือต่างจากเดิม) - ถ้าโมเดลภายในไม่พร้อม จะได้ 429
quota_exceeded
- คำขอ
- คำขอที่ใช้เงิน
- เช่น สร้างรูป ตอบ 429
quota_exceededทันทีระหว่างที่โควตาหมด - ส่วนคำขอแบบอ่าน (GET เช่น
/models,/limits) และถอดเสียง/audio/transcriptionsยังใช้ได้ตามปกติ
- เช่น สร้างรูป ตอบ 429
- ยิงถี่เกิน:
- มีด่านกันยิงถี่ต่อ IP — เกินประมาณ 1,200 คำขอ/นาทีจาก IP เดียว ได้ 429
Too many requests. Please slow down.(รอ 60 วินาที) และยิงเป็นชุดเกินราว 30 คำขอ/วินาทีก็ได้ 429 เช่นกัน - ถ้าคีย์ตั้งลิมิตต่อนาทีไว้ (ดู
limits.rate_limit_rpmใน/api/v1/limitsค่าnull= ไม่จำกัด) ยิงเกินจะได้ 429Rate limit exceeded (N req/min) - แอปเดสก์ท็อปได้อย่างน้อย 1,200 ครั้ง/นาที
- มีด่านกันยิงถี่ต่อ IP — เกินประมาณ 1,200 คำขอ/นาทีจาก IP เดียว ได้ 429
- สร้างรูป ไม่จำกัดจำนวนรูปต่อวัน แต่คิดตามโทเคนจริงของรูปลงที่คีย์ที่เรียก และนับรวมในโควตาโทเคน/งบของคีย์เหมือนแชท
- โควตาเป็นก้อนเดียวต่อคีย์
- ไม่มีโควตาแยกต่อโมเดลสำหรับคีย์พนักงาน (
by_modelแสดงแค่ว่าใช้ไปกับโมเดลไหนเท่าไร) - เพดานรายวันต่อโมเดลที่ตั้งในแผนของทีมใช้กับเว็บแชทเท่านั้น
- คีย์ของสมาชิกองค์กรลูกค้ามีโควตาขององค์กรเพิ่ม ดู ข้อควรรู้เพิ่มเติม
- ไม่มีโควตาแยกต่อโมเดลสำหรับคีย์พนักงาน (
ดูโควตาและยอดใช้ของคีย์
curl https://caw.clicknext.com/api/v1/limits \ -H "Authorization: Bearer cnx-xxxxxxxx"
ดูที่ limits.quota_period (week / month), limits.monthly_tokens (used / quota / pct / resets_at — ชื่อ field เป็น monthly แม้รอบจะเป็นรายสัปดาห์), limits.monthly_cost_usd, limits.today_tokens และ by_model (ใช้ไปเท่าไรต่อโมเดล) · quota: null = ไม่จำกัด
Header เสริม + ทำงานต่อข้ามเครื่องมือ
ไม่บังคับ — ใส่เพิ่มในคำขอเมื่ออยากได้ความสามารถเหล่านี้
| Header | ผล |
|---|---|
x-project-id: <ชื่อ> | ผูกบทสนทนาเข้า “โปรเจกต์” (ตัวอักษร a-z 0-9 . _ - ไม่เกิน 80 ตัว) — ไม่ใส่ = ใช้โปรเจกต์ประจำคีย์ (key-<id>) · เกตเวย์สรุปงาน (handoff brief) ให้อัตโนมัติทุก ๆ 5 รอบ |
x-resume: 1 | แนบสรุปงานของโปรเจกต์นั้นให้โมเดลก่อนตอบ — เปลี่ยนเครื่องมือหรือโมเดลแล้วทำต่อจากที่ค้างไว้ได้ ไม่ต้องเล่าใหม่ (ใช้ได้เฉพาะโปรเจกต์ของคุณเอง) |
x-clicknext-effort: low | medium | high | xhigh | เฉพาะ /api/v1/messages + GPT-5.x / GPT-6.x ที่มี tools — กำหนดความลึกของการคิดในรอบนั้น (ค่าเริ่มต้น medium) |
x-clicknext-heartbeat: 1 | เฉพาะ /api/v1/messages แบบไม่ stream สำหรับสคริปต์ที่เขียนเอง: ถ้าคำตอบยังไม่มาในราว 20 วินาที เกตเวย์เปลี่ยนคำตอบเป็น event stream ส่ง event: ping เป็นระยะ (ตัวกลางระหว่างทางจะได้ไม่ตัดสาย) แล้วจบด้วย event: result ที่มี {status, headers, body} — SDK ทั่วไปอ่านรูปแบบนี้ไม่ได้ อย่าใส่ใน Claude Code |
Header ที่เกตเวย์ตอบกลับ
- บน
/api/v1/messages:x-clicknext-model= โมเดลที่รันจริง ·x-clicknext-context-window= ขนาด context ของโมเดลนั้น ·x-clicknext-effort= ระดับการคิดที่ใช้จริง (none= ไม่ได้ใช้โหมดคิด) - ทั้งสองสาย:
x-clicknext-skill= สกิลที่ Auto แนบให้ (ชื่อคั่นด้วยจุลภาค) ·x-clicknext-budget*= โควตาหมดแล้วรันบนโมเดลฟรี ·x-clicknext-model-replaced= โมเดลที่ขอถูกแทน (ดู ข้อควรรู้เพิ่มเติม) - เรียก Agent (
/api/v1/agents/<id>/chat/completions):x-clicknext-agent= id ของ Agent ·x-clicknext-kb= แหล่งในคลังความรู้ที่ใช้ตอบ (JSON แบบ URL-encoded) ·x-clicknext-model-replaced= โมเดลของ Agent ที่คุณไม่มีสิทธิ์ใช้ เกตเวย์จึงใช้ Auto แทน
ดู/ดึงโปรเจกต์: GET /api/v1/projects (รายการ) · GET /api/v1/projects/<id>/resume (สรุปงาน + 10 รอบล่าสุด) · POST /api/v1/projects/<id>/summarize (สรุปใหม่เดี๋ยวนี้) — หรือเรียกผ่าน MCP ด้วย list_projects / resume_project
curl https://caw.clicknext.com/api/v1/chat/completions \
-H "Authorization: Bearer cnx-xxxxxxxx" \
-H "Content-Type: application/json" \
-H "x-project-id: crm-report" \
-H "x-resume: 1" \
-d '{"model":"auto","messages":[{"role":"user","content":"ทำต่อจากเมื่อวาน"}]}'สร้างรูปผ่าน API
โมเดลแชทวาดรูปไม่ได้ — ใช้ endpoint นี้ (รูปแบบเดียวกับ OpenAI Images)
curl https://caw.clicknext.com/api/v1/images/generations \
-H "Authorization: Bearer cnx-xxxxxxxx" \
-H "Content-Type: application/json" \
-d '{"prompt":"โลโก้ร้านกาแฟ โทนเขียว มินิมอล"}'- ได้
{"created":…,"data":[{"b64_json":"…"}],"model":"gpt-image-2.5-sunburst","usage":{…,"cost_usd":…}}(usage คือโทเคนและค่าใช้จ่ายของรูปนี้ที่ลงคีย์ของคุณ) — ใส่"response_format":"url"ถ้าอยากได้เป็น data URL แทน - สร้างครั้งละ 1 รูป ด้วย GPT Image 2.5 Sunburst (
gpt-image-2.5-sunburst) ตัวเดียว ไม่มีเอนจินสำรอง ·promptยาวได้ถึง 8,000 ตัวอักษร (ไทยได้) · ใส่sizeเช่น1536x1024ได้ (ด้านละ 256 ถึง 3,840 px หาร 16 ลงตัว สัดส่วนไม่เกิน 3:1 และรวม 655,360 ถึง 8,294,400 พิกเซล เช่น1024x1024,1536x1024,2048x2048) - ไม่ส่ง
quality= ได้รูปคุณภาพสูงสุด (2048 px, รูปที่ให้ข้อมูลอย่าง infographic 3072×2048) พร้อมตรวจตัวสะกดภาษาไทยในรูป ใช้เวลา 2 ถึง 6 นาที · ส่ง"quality"เป็นxhigh/high/medium/lowถ้าอยากได้เร็วขึ้น · หรือส่ง"async":true(หรือ?async=1) ได้ 202 พร้อมidทันที แล้วดูผลที่GET /api/v1/images/generations/<id>(ตอบ 202 ระหว่างทำ ผลเก็บไว้ราว 20 นาที ดูได้เฉพาะคีย์ที่สั่ง) - ไม่จำกัดจำนวนรูปต่อวัน แต่ค่ารูปนับเข้าโควตาโทเคน/งบของคีย์ ถ้าโควตาหมดจะได้ 429
quota_exceeded(สร้างรูปไม่มีโมเดลฟรีสำรอง) · บัญชีที่ไม่มีสิทธิ์สร้างรูปได้ 403 · ผู้ให้บริการปฏิเสธเนื้อหาได้ 400image_moderation· ผู้ให้บริการไม่พร้อมได้ 503 - ในเครื่องมือที่ต่อ MCP ใช้เครื่องมือ
generate_imageแทนได้ · สร้างวิดีโอและโมเดล 3D ยังไม่เปิดให้คีย์cnx-เรียกตรง — ใช้ในแอปเดสก์ท็อปหรือ /chat
ถอดเสียงผ่าน API
ถอดเสียงพูดภาษาไทยเป็นข้อความ รูปแบบเดียวกับ OpenAI Audio Transcriptions รันบนเครื่อง GPU ในบริษัท ไฟล์เสียงไม่ออกนอกบริษัท
curl https://caw.clicknext.com/api/v1/audio/transcriptions \ -H "Authorization: Bearer cnx-xxxxxxxx" \ -F file=@meeting.m4a \ -F model=typhoon-asr \ -F response_format=srt
- model ใช้
typhoon-asr(ไม่ส่งก็ได้) — ชื่ออื่น เช่นwhisper-1ได้ 400 ดังนั้นใน OpenAI SDK ให้ใส่model="typhoon-asr" - ส่งไฟล์
- แบบ multipart ช่อง
fileหรือส่งเสียงเป็น body ตรง ๆ (Content-Type: audio/…) แล้วใส่ตัวเลือกใน query เช่น?response_format=text - รับไฟล์เสียง/วิดีโอทั่วไป (mp3, m4a, wav, ogg, webm, mp4 ฯลฯ) ไม่เกิน 100 MB และยาวไม่เกิน 3 ชั่วโมง
- แบบ multipart ช่อง
- response_format
json(ค่าเริ่มต้น) /text/verbose_json/srt/vtt- เวลาใน srt / vtt / segments เป็นช่วงละราว 45 วินาที (โมเดลไม่ให้เวลาละเอียดกว่านี้)
- ไฟล์ยาว:
- ใส่
?async=1ได้ 202 พร้อมidทันที แล้วเรียกGET /api/v1/audio/transcriptions/<id>จนได้ผล (ตอบ 202 ระหว่างทำ) · ทำพร้อมกันได้ 3 งานต่อคีย์ - ผลเก็บไว้ 1 ชั่วโมง และหายถ้าเกตเวย์รีสตาร์ต
- ใส่
- ค่าใช้จ่าย:
- ไม่นับโควตาโทเคน และยังใช้ได้ตอนโควตาหมด
- แต่ละครั้งถูกบันทึกในประวัติการใช้งานของคีย์
ข้อควรรู้เพิ่มเติม
พฤติกรรมของเกตเวย์ที่เครื่องมือควรรู้ ตรวจกับระบบที่ใช้งานอยู่ ณ 2 พ.ย. 2026
- Data Shield (แทนค่าลับก่อนส่งให้ AI ภายนอก)
- ก่อนคำขอออกไปถึงโมเดลของผู้ให้บริการภายนอก (OpenAI, Anthropic, Google, xAI ฯลฯ) เกตเวย์แทนค่าลับและเลขสำคัญในทุกข้อความที่โมเดลจะอ่าน (ข้อความ, system, ผลของ tool, argument ของ tool) ด้วยป้าย เช่น
[API_KEY#1],[PASSWORD#1],[THAI_ID#1]ประเภทที่แทน: คีย์ API, โทเค็น, รหัสผ่าน, ค่าลับ, กุญแจส่วนตัว, เลขบัตรประชาชน, เลขบัตรเครดิต, เลขบัญชีธนาคาร, เลขหนังสือเดินทาง (อีเมลและเบอร์โทรไม่แทน) - ค่าเดิมได้ป้ายเดิมทุกรอบ แล้วเกตเวย์ใส่ค่าจริงคืนในคำตอบ ทั้งแบบ JSON และ stream
- คำขอที่ไป GLM-5.3 Flash (ในบริษัท) ไม่ถูกแทน · ไม่มี header แจ้งบนสาย API
- ก่อนคำขอออกไปถึงโมเดลของผู้ให้บริการภายนอก (OpenAI, Anthropic, Google, xAI ฯลฯ) เกตเวย์แทนค่าลับและเลขสำคัญในทุกข้อความที่โมเดลจะอ่าน (ข้อความ, system, ผลของ tool, argument ของ tool) ด้วยป้าย เช่น
- ป้ายของ Data Shield ใน tool call ที่ส่งข้อมูลออก
- ถ้า tool call ที่โมเดลตอบมามี URL / host / IP หรือเป็นคำสั่งเครือข่าย (เช่น
curl,ssh,scp,git push) หรือเป็นเครื่องมือเว็บ/ส่งข้อความ ป้ายจะไม่ถูกใส่ค่าจริงคืน (ความลับจึงไม่ถูกส่งออกไปที่อื่น) และบันทึกเป็นเหตุการณ์ให้ IT เห็น ส่วนการเขียน/แก้ไฟล์ในเครื่องได้ค่าจริง - ถ้างานต้องใช้ความลับกับปลายทางภายนอก ให้เก็บไว้ในตัวแปรแวดล้อมหรือไฟล์บนเครื่อง แล้วให้ agent อ้างชื่อตัวแปร (เช่น
$API_TOKEN) แทนการวางค่าจริงในแชท
- ถ้า tool call ที่โมเดลตอบมามี URL / host / IP หรือเป็นคำสั่งเครือข่าย (เช่น
- โควตาหมดแล้วย้ายไปโมเดลฟรี คำตอบมี header
x-clicknext-budget: fallback,x-clicknext-budget-model,x-clicknext-budget-period,x-clicknext-budget-resetและ/api/v1/limitsมีlimits.fallback(active,unlimited,resets_at) ใช้บอกผู้ใช้ได้ว่าทำไมคำตอบเปลี่ยน - โมเดลของ provider ที่ปิดไปแล้ว (เช่น DeepSeek จากไฟล์ตั้งค่าเก่า) เกตเวย์รันบน GLM-5.3 Flash แทน และใส่ header
x-clicknext-model-replaced: <provider>/<model> - Context window ตามตระกูลโมเดล
- Claude 5.x 1,000,000 · gpt-5.6 / luna / sol / terra 1,050,000 · Gemini 1,048,576 · gpt-6 รุ่นอื่น 400,000 · Grok 4.5-4.7 500,000 · Kimi 262,144
- ค่าที่ใช้จริงดูจาก
context_windowใน/api/v1/models
- รูปภาพ
- โมเดลแชทเกือบทุกตัวอ่านรูปเอง (GPT-6.x / GPT-5.x, GPT-4o, Claude, Gemini, Kimi และ GLM-5.3 Flash) เกตเวย์ส่งรูปให้ตามที่แนบมา
- บนสาย Anthropic (
/api/v1/messages) ถ้าโมเดลที่รันจริงอ่านรูปไม่ได้ (เช่นseed-translation-…) เกตเวย์ให้ตัวอ่านรูปกลางอธิบายภาพเป็นภาษาไทยพร้อมถอดข้อความในภาพทุกตัวอักษรแทนรูปนั้น (รวมรูปในผลของ tool) เก็บผลต่อรูปไว้ 24 ชั่วโมง ค่าใช้จ่ายคิดกับผู้ขอ - บนสาย OpenAI รูปถูกส่งต่อตามเดิม
- GLM-5.3 Flash เกตเวย์จำกัด temperature ไม่เกิน 0.7 และ top_p ไม่เกิน 0.8 (รอบที่ใช้ tools 0.3 / 0.6) ให้ตอบภาษาเดียวกับผู้ใช้ และแก้ตัวสะกดภาษาไทยของคำตอบที่ไม่ผ่านการตรวจ คำตอบจึงอาจต่างจากโมเดลดิบ
- คีย์ของสมาชิกองค์กรลูกค้า
- เห็นเฉพาะโมเดลที่องค์กรซื้อ (และ
auto) ขอโมเดลนอกรายการได้ 403model_not_allowedคำขอต้องผ่านทั้งสิทธิ์ของคีย์และรายการขององค์กร - โควตาองค์กรหมดได้ 429
org_quota_exceededเครดิตองค์กรหมดได้ 429org_credit_exhaustedและโมเดลที่องค์กรตั้งโควตารายเดือนแยกไว้ใช้ครบได้ 429org_model_quota_exceeded(ทั้งสามกรณี ถ้าองค์กรเปิดโมเดลฟรีสำรองไว้ คำขอแชทจะย้ายไปโมเดลฟรีแทน) - ถ้าองค์กรตั้งกฎกันข้อมูลรั่วของตัวเอง คำขอที่โดนกฎบล็อกได้ 403
dlp_blockedและคำตอบที่โดนกฎมี headerx-clicknext-guard - บน MCP ใช้ได้
whoami/list_projects/resume_project
- เห็นเฉพาะโมเดลที่องค์กรซื้อ (และ
- ข้อความ prompt ที่ส่งผ่าน API และ VS Code เก็บไว้ 90 วัน หลังจากนั้นแสดงเป็น
[expired] - กันการใช้งานผิดปกติ นอกจาก 429 ตามลิมิตต่อ IP ระบบอาจแบน IP ชั่วคราวเมื่อเห็นคำขอผิดปกติ เช่น ยืนยันตัวตนผิดซ้ำ ๆ หรือคำขอถี่มาก สคริปต์ที่วนลองคีย์ผิดจากนอกเครือข่ายบริษัทจึงอาจโดนแบน ให้หยุดเมื่อได้ 401
ทดสอบการเชื่อมต่อ
ยิงคำขอเดียวเพื่อเช็กว่า key + endpoint ใช้ได้
curl https://caw.clicknext.com/api/v1/chat/completions \
-H "Authorization: Bearer cnx-xxxxxxxx" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-6-luna","messages":[{"role":"user","content":"ping"}]}'ได้ JSON ที่มี choices[0].message.content = เชื่อมต่อสำเร็จ · ได้ 401 = คีย์ผิด · ได้ 403 = โมเดลนอกสิทธิ์และคีย์ใช้ gpt-6-luna แทนไม่ได้ (ลองเปลี่ยนเป็น auto) · ถ้า field model ในผลลัพธ์ไม่ใช่โมเดลที่ขอ แปลว่าเกตเวย์ย้ายไปรันโมเดลอื่น (ดู โมเดลที่ใช้ได้) · เช็กโควตาที่เหลือด้วย /api/v1/limits
แก้ปัญหาที่พบบ่อย
| อาการ | สาเหตุ / วิธีแก้ |
|---|---|
| เชื่อมไม่ติด / 404 | เช็ก base URL: OpenAI ใช้ /api/v1, Claude Code ใช้ /api · อย่าใช้ schema “OpenAI Responses” · เครื่องมือที่บังคับ Responses API (เช่น Codex CLI รุ่นปัจจุบัน) ยังใช้ไม่ได้ |
| VS Code ไม่มีตัวเลือก Custom Endpoint | อัปเดต VS Code เป็น 1.122 ขึ้นไป · ถ้าล็อกอิน GitHub ของบริษัท (Copilot Business/Enterprise) แอดมิน GitHub ต้องเปิด policy “Bring Your Own Language Model Key in VS Code” ก่อน |
| VS Code: โมเดลของ ClickNext ไม่ขึ้นในตัวเลือก | บันทึก chatLanguageModels.json แล้วสั่ง Developer: Reload Window · เช็กว่า vendor เป็น customendpoint และ JSON ไม่มีจุลภาคเกิน/ขาด |
401 Missing or malformed API key (expected cnx-...) | ไม่ได้ส่งคีย์ หรือคีย์ไม่ได้ขึ้นต้น cnx- — ส่งเป็น Authorization: Bearer cnx-… หรือ x-api-key |
401 Invalid or revoked API key / API key expired | คีย์พิมพ์ผิด ถูกเพิกถอน หรือหมดอายุ — ดูคีย์ปัจจุบันที่แดชบอร์ด (ของฉัน → API Key ของฉัน) หรือขอใหม่จาก IT |
403 This API key is not allowed to use … | โมเดลไม่อยู่ในสิทธิ์ของคีย์ และคีย์ใช้ gpt-6-luna แทนไม่ได้ (ถ้าใช้ได้ เกตเวย์จะรันบน gpt-6-luna ให้แทน) — เลือกจาก /api/v1/models หรือใช้ auto · Claude Code: ตั้ง ANTHROPIC_DEFAULT_HAIKU_MODEL ด้วย (ดูแท็บ Claude Code) · อยากได้โมเดลเพิ่ม แจ้ง IT |
403 This API key is not allowed to use the auto router | คีย์นี้ไม่ได้เปิด auto — ระบุชื่อโมเดลตรง ๆ จากรายการของคีย์ |
400 Streaming Claude via /chat/completions is not supported หรือเลือก Claude แล้วได้คำตอบจากโมเดลอื่น | สาย OpenAI ส่ง Claude แบบ stream ไม่ได้ ใช้ /api/v1/messages (base /api) หรือปิด stream |
429 Rate limit exceeded (N req/min) | ยิงเกินลิมิตต่อนาทีของคีย์ รอสักครู่แล้วลองใหม่ หรือขอ IT ปรับ |
403 Access blocked by security policy | บัญชี/เครื่อง/IP ถูกระงับโดยระบบความปลอดภัย — ติดต่อ IT |
403 account_disabled (บัญชีนี้ถูกปิดการใช้งาน…) | ผู้ดูแลปิดบัญชีเจ้าของคีย์ไว้ ทุกคีย์ของบัญชีนั้นใช้ไม่ได้ (รวม MCP) — ติดต่อผู้ดูแลระบบ |
400 Cannot route model "…" | ชื่อโมเดลไม่มีในระบบ (มักเป็นชื่อเก่าค้างใน config) — คัดลอก id จาก /api/v1/models ใหม่ |
| 400 โมเดล … เป็นโมเดลสร้างวิดีโอ/ภาพ | เรียกโมเดลสร้างสื่อผ่าน chat — ใช้ /api/v1/images/generations แทน |
| 400 โมเดล … เป็นโมเดลตัดสินใจ | เลือกโมเดล jev-* ซึ่งระบบใช้เบื้องหลัง ไม่ใช่โมเดลแชท — ใช้ auto หรือโมเดลจาก /api/v1/models |
| 413 (คำขอใหญ่เกิน) | body เกิน 10 MB (ถอดเสียงเกิน 100 MB) — ลดขนาดรูปที่แนบหรือตัดประวัติแชทให้สั้นลง |
| Function tools … reasoning_effort | ใช้ schema Chat Completions + โมเดล gpt-6-luna เกตเวย์จัดการ reasoning ให้เอง |
max_tokens … use max_completion_tokens | เกตเวย์แปลงให้แล้ว — อัปเดตเครื่องมือเป็นเวอร์ชันล่าสุด แล้วลองใหม่ |
429 Weekly/Monthly token quota exceeded หรือ … budget exceeded ($…) | โควตาของรอบนี้หมด — เช็ก resets_at ที่ /api/v1/limits รอรอบใหม่ หรือขอ IT ปรับโควตา |
429 Too many requests. Please slow down. หรือ 429 ที่ไม่มี JSON | ยิงคำขอถี่เกินจาก IP เดียว (เกินราว 1,200 คำขอ/นาที หรือยิงเป็นชุดเกินราว 30 คำขอ/วินาที) — รอ 60 วินาทีแล้วค่อยลองใหม่ และลดจำนวนคำขอที่ยิงพร้อมกัน |
คำสั่งหรือ URL ที่ agent สร้างมีป้ายอย่าง [API_KEY#1] แทนค่าจริง | Data Shield ไม่ใส่ค่าลับคืนใน tool call ที่ส่งข้อมูลออกนอกเครื่อง (ตั้งใจ) — เก็บค่าไว้ในตัวแปรแวดล้อมหรือไฟล์ แล้วให้ agent อ้างชื่อตัวแปรแทน ดู ข้อควรรู้เพิ่มเติม |
คำตอบช้า/ต่างจากเดิม และ x-clicknext-model ไม่ใช่โมเดลที่เลือก | โควตาหมด หรือ provider ของโมเดลที่เลือกล่มชั่วคราว ระบบจึงรันบนโมเดลภายในของบริษัทแทน — ดู โควตาและลิมิต |
503 No active upstream key configured … / all routed providers failed | provider ปลายทางไม่พร้อมชั่วคราว — ลองใหม่ หรือใช้ auto (มีตัวสำรอง) |
| หลุดหรือ timeout ระหว่างรอคำตอบยาว (เช่น 504 / 524) | เกตเวย์รอคำตอบได้ถึง 1 ชั่วโมงต่อคำขอ แต่ client หรือ proxy ระหว่างทางอาจตัดก่อน — เพิ่ม timeout ของ client · สาย OpenAI เปิด "stream": true · สาย Anthropic แบ่งงานต่อรอบให้เล็กลง หรือสคริปต์ที่เขียนเองใส่ header x-clicknext-heartbeat: 1 (ดู Header เสริม) |
ขั้นถัดไป: ClickNext MCP
นอกจาก endpoint โมเดล ยังต่อ ClickNext MCP เพื่อให้เครื่องมือภายนอกเรียกเครื่องมือของ ClickNext เองได้ — คลังสกิล (รวมสกิลผู้เชี่ยวชาญ), สมององค์กร (Org Brain), ความต่อเนื่องของโปรเจกต์, สร้างรูป และ Hub ที่เรียกทะลุไประบบปลายทาง ด้วยคีย์เดียวกัน ดูวิธีที่ หน้า MCP