เชื่อมต่อ

เชื่อมเครื่องมือภายนอกกับ ClickNext

อัปเดตล่าสุด 17 พ.ย. 2026

ต่อ VS Code, Warp, Cursor, Claude Code, OpenCode หรือทุกเครื่องมือที่รับ base URL แบบ OpenAI/Anthropic เข้ากับ ClickNext Gateway ด้วย virtual key cnx- ตัวเดียว

ทุกทราฟฟิกวิ่งผ่านเกตเวย์ของเราเอง — IT หมุนคีย์ คุมโควตา และดู log กลางได้ที่เดียว ผู้ใช้ไม่ต้องถือ provider key ดิบบนเครื่องเลย เลือกโมเดล auto ให้เกตเวย์เลือกให้ หรือระบุโมเดลเองก็ได้ (ดู โมเดลที่ใช้ได้)

หลักการเดียวจำง่าย: base URL ฝั่ง OpenAI ลงท้าย /api/v1 · ฝั่ง Claude Code (Anthropic) ใส่แค่ /api (ตัว SDK เติม /v1/messages ให้เอง) · คีย์คือ cnx- ของคุณเสมอ
ใช้แอป ClickNext เดสก์ท็อป หรือ /chat อยู่แล้ว? ไม่ต้องตั้งค่าอะไรในหน้านี้ — แอปเชื่อมเกตเวย์ให้เองหลังล็อกอิน หน้านี้สำหรับเครื่องมือภายนอกที่อยากใช้โมเดลผ่านเกตเวย์

ขอ cnx- key

virtual key ขึ้นต้นด้วย cnx- ผูกกับอีเมลบริษัทของคุณ เพิกถอน/ออกใหม่ได้โดยไม่กระทบคนอื่น

1
เช็กก่อนว่ามีคีย์อยู่แล้วหรือยังถ้าเคยล็อกอินแอปเดสก์ท็อป ระบบออกคีย์ส่วนตัวให้แล้ว (ชื่อ agent-auto …) — เปิด แดชบอร์ด → เมนู ของฉัน → กล่อง API Key ของฉัน → กด ดู key (เห็นได้เฉพาะคีย์ของตัวเอง และทุกครั้งที่กดดูถูกบันทึกไว้)
2
ยังไม่มี หรืออยากได้คีย์แยกต่อเครื่องมือ — ขอจากทีม IT / แอดมินแอดมินออกคีย์จากแดชบอร์ด (หน้า ค่าใช้จ่าย คีย์ และผู้ให้บริการ AI) พร้อมกำหนดสิทธิ์โมเดลและโควตา
3
เก็บให้ดี ใช้ซ้ำได้ทุกเครื่องมือคีย์เดียวใช้ได้ทั้ง endpoint โมเดล (หน้านี้) และ ClickNext MCP
4
อย่าวาง provider key ดิบห้ามใส่คีย์ OpenAI/Anthropic/DeepSeek ตรง ๆ บนเครื่อง — ใช้ cnx- เท่านั้น ถ้าคีย์รั่ว แจ้ง IT เพิกถอนได้ทันที

Endpoint และ Schema

เกตเวย์รองรับสองสายโปรโตคอล เลือกให้ตรงกับเครื่องมือ

สายBase URLใช้กับ
OpenAI-compatiblehttps://caw.clicknext.com/api/v1VS Code, Warp, Cursor, OpenCode, Continue, Aider, Zed, OpenAI SDK
Anthropic-wirehttps://caw.clicknext.com/apiClaude 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/mcpClickNext MCP — ดู หน้า MCP
ข้อควรรู้เรื่อง schema: ฝั่ง OpenAI ให้เลือก “OpenAI Chat Completions” เท่านั้น — เกตเวย์ ไม่มี /v1/responses, /v1/embeddings และ /v1/messages/count_tokens (เรียกแล้วได้ 404) ดังนั้นอย่าเลือก schema แบบ “OpenAI Responses” และไม่ต้องตั้ง reasoning_effort เอง เกตเวย์จัดการให้อัตโนมัติเมื่อใช้ tools

ตั้งค่าตามเครื่องมือ

เลือกเครื่องมือของคุณ แล้วคัดลอกค่าไปวางได้เลย (แทน cnx-xxxx ด้วยคีย์ของคุณ)

ใน Warp: เปิด Settings แล้วค้นคำว่า inference endpoint (Custom inference endpoint) จากนั้นเพิ่ม endpoint ใหม่

API schemaOpenAI Chat Completions
Endpoint URLhttps://caw.clicknext.com/api/v1
API keycnx-xxxxxxxx
Model namegpt-6-luna · alias (ไม่บังคับ): clicknext
อยากให้เกตเวย์เลือกโมเดลเอง ตั้ง Model name เป็น auto ได้ · รายละเอียดจุดที่มักพลาด ดู Warp โดยละเอียด

ใช้แชทของ VS Code เอง (Chat / Agent mode) กับโมเดลของ ClickNext — ไม่ต้องล็อกอิน GitHub และไม่ต้องมีแพ็กเกจ Copilot · ต้องใช้ VS Code 1.122 ขึ้นไป

1
เปิดหน้าจัดการโมเดลกด Ctrl+Shift+P (Mac: ⌘⇧P) พิมพ์ Chat: Manage Language Models หรือกดรูปเฟืองในตัวเลือกโมเดลของช่องแชท
2
เพิ่ม Custom Endpointกด Add Models → Custom Endpoint → ชื่อกลุ่ม ClickNext → วางคีย์ cnx- ของคุณ → API type เลือก Chat Completions (VS Code เก็บคีย์ไว้ในที่เก็บรหัสลับของเครื่อง ไม่เขียนลงไฟล์)
3
ใส่รายชื่อโมเดลVS Code เปิดไฟล์ chatLanguageModels.json ให้ — ในกลุ่ม ClickNext แทนที่ "models": [ … ] ทั้งก้อนด้วยข้อความด้านล่าง แล้วบันทึก (บรรทัด apiKey ที่ VS Code เขียนไว้ไม่ต้องแตะ)
4
เลือกโมเดลแล้วใช้ได้เลยเปิดตัวเลือกโมเดลในช่องแชท → GPT-6 Luna ในกลุ่ม ClickNext · ถ้ายังไม่ขึ้น สั่ง 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" }
  }
]
ใช้ได้ทั้งถามตอบและ Agent mode
  • (อ่าน/แก้ไฟล์, รันคำสั่งในเทอร์มินัล) ผ่านเกตเวย์ทุกคำขอ — มีโควตา, DLP และ log เหมือนเครื่องมืออื่น
  • header x-clicknext-client ทำให้แดชบอร์ดแสดงรายการเหล่านี้เป็น VS Code
  • id ต้องอยู่ในรายการของคีย์คุณ (ดู /api/v1/models) ลบก้อนที่ไม่ใช้ออกได้
อย่าเลือก API type “Responses” (เกตเวย์ไม่มี /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 URLhttps://caw.clicknext.com/api/v1
API Keycnx-xxxxxxxx
Modelgpt-6-luna (หรือ auto)
เพิ่มชื่อโมเดลในช่อง custom model ของ Cursor ให้ตรงกับที่พิมพ์ไว้ (gpt-6-luna) ก่อนกด verify

Claude 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 และตอบตามภาษาของข้อความล่าสุดของผู้ใช้ (ไม่แน่ใจจะตอบไทย)

วิธีเร็ว (แนะนำ): ให้เกตเวย์สร้างไฟล์ตั้งค่าจากรายชื่อโมเดลจริง

1
เก็บคีย์เข้า OpenCodeรัน opencode auth login → เลือก Other → ช่อง Provider id พิมพ์ clicknext → วางคีย์ cnx-
2
ดึงไฟล์ตั้งค่าคำสั่งด้านล่าง (ใส่ header คีย์ด้วย จะได้เฉพาะโมเดลที่คีย์ของคุณใช้ได้ · ไฟล์ไม่มีคีย์อยู่ข้างใน · ถ้ามี opencode.json เดิมจะถูกเขียนทับ)
3
เปิดใช้งานรัน 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": {} }
    }
  }
}
มีหน้าตั้งค่าเฉพาะพร้อมไฟล์ให้โหลด (รวม Windows) ที่ caw.clicknext.com/opencode
Codex CLI ใช้เป็นโมเดลผ่านเกตเวย์ไม่ได้ในตอนนี้: Codex รุ่นปัจจุบันคุยกับ provider ผ่าน OpenAI Responses API (wire_api = "responses") เท่านั้น แต่เกตเวย์มีแค่ Chat Completions — เรียกแล้วจะได้ 404

ยังต่อ ClickNext MCP เข้า Codex ได้ (ให้ Codex เรียกคลังสกิล, สมององค์กร, Hub ของเรา) — ดูวิธีที่ หน้า MCP → Codex

Cline / Roo Code (VS Code) — Settings ของส่วนขยาย

API ProviderOpenAI Compatible
Base URLhttps://caw.clicknext.com/api/v1
API Keycnx-xxxxxxxx
Model IDgpt-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-xxxxxxxx

Aider (CLI)

export OPENAI_API_BASE=https://caw.clicknext.com/api/v1
export OPENAI_API_KEY=cnx-xxxxxxxx
aider --model openai/gpt-6-luna
เครื่องมือที่ไม่มีช่อง custom base URL (เช่น Antigravity ของ Google ณ ตอนที่เขียน) ต่อผ่านเกตเวย์ไม่ได้ — คำขอจะวิ่งตรงไปผู้ให้บริการ ไม่มีโควตา/log/สกิลของ ClickNext · ถ้างานต้องผ่านเกตเวย์ ให้ใช้ Claude Code, Cursor หรือ Cline แทน

ใช้ได้กับ 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 ต่อไม่ติดบ่อยที่สุด

ถ้าเคยเจอ error Function tools with reasoning_effort are not supported… — ตอนนี้เกตเวย์แก้ให้แล้ว เพียงใช้ Chat Completions + โมเดลข้างต้น

ใช้ GLM-5.3 Flash (ฟรี ไม่นับโควตา)

โมเดลที่รันบนเครื่อง GPU ในบริษัทเอง ใช้ได้ไม่จำกัด เหมาะกับงานทั่วไป งานที่ข้อมูลไม่ควรออกนอกบริษัท หรือตอนโควตาโมเดลหลักใกล้หมด

Model nameglm-5.3-flash
ค่าใช้จ่ายฟรี ไม่นับเข้าโควตาโทเคนของคีย์ (ใน /api/v1/limits แถวของโมเดลนี้มี "free": true)
Context window228K โทเคน (ตามที่เครื่อง 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"
อยากใช้ GPT เป็นหลักแต่สลับมา GLM เมื่อต้องการ: ตั้ง 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-xxxxxxxx

Aider

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)
ถ้าแผนของทีมปิด GLM ไว้: แอปเดสก์ท็อปได้ 403 ทีมของคุณไม่ได้รับสิทธิ์ใช้โมเดลนี้ ส่วนคีย์ 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 — คีย์ของคุณอาจมีมากหรือน้อยกว่านี้)

โมเดลหมายเหตุ
autoAuto 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-miniGPT รุ่นอื่น (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-5Claude (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 ถ้าใช้ไม่ได้จะตอบ 403 This 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 ในผลลัพธ์ หรือ header x-clicknext-model (สาย Anthropic)

โควตาและลิมิต

โควตาผูกกับคีย์ แอดมินตั้งได้ทั้งจำนวนโทเคนและงบ (USD) ต่อรอบ

ดูโควตาและยอดใช้ของคีย์

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 ที่เกตเวย์ตอบกลับ

ดู/ดึงโปรเจกต์: 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":"โลโก้ร้านกาแฟ โทนเขียว มินิมอล"}'

ถอดเสียงผ่าน 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

ข้อควรรู้เพิ่มเติม

พฤติกรรมของเกตเวย์ที่เครื่องมือควรรู้ ตรวจกับระบบที่ใช้งานอยู่ ณ 2 พ.ย. 2026

ทดสอบการเชื่อมต่อ

ยิงคำขอเดียวเพื่อเช็กว่า 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 failedprovider ปลายทางไม่พร้อมชั่วคราว — ลองใหม่ หรือใช้ 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