เชื่อมต่อ

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

อัปเดตล่าสุด 29 ก.ย. 2026

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

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

ขอ cnx- key

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

Endpoint และ Schema

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

ส่งคีย์ได้ 2 แบบ (ใช้ได้ทั้งสองสาย): Authorization: Bearer cnx-xxxxxxxx หรือ x-api-key: cnx-xxxxxxxx

Endpoint ที่เปิดให้ใช้

• stream บนสาย OpenAI ไหลเป็นโทเคนตามปกติ · stream บนสาย Anthropic เมื่อรันบนโมเดลที่ไม่ใช่ Claude (เช่น GPT) เกตเวย์ประมวลผลทั้งรอบก่อน แล้วส่งกลับเป็นรูปแบบ SSE ทีเดียวตอนจบ
• ส่ง max_tokens / temperature ได้ตามปกติ — กับ GPT รุ่นใหม่ (เช่น GPT-5.x) เกตเวย์แปลงเป็น max_completion_tokens ให้ และตัด temperature ที่ไม่ใช่ 1 ออก (โมเดลรุ่นนี้ไม่รับ)
• ทุกคำขอผ่าน DLP — ถ้าเจอข้อมูลอ่อนไหว (เช่น คีย์/รหัสผ่านในข้อความ) จะถูกตรวจและบันทึกเป็นเหตุการณ์ให้ IT เห็น — อย่าวางความลับลงใน prompt

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

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

export ANTHROPIC_BASE_URL=https://clicknexttest.biz/api
export ANTHROPIC_AUTH_TOKEN=cnx-xxxxxxxx
export ANTHROPIC_MODEL=auto
export ANTHROPIC_DEFAULT_HAIKU_MODEL=auto
claude

$env:ANTHROPIC_BASE_URL="https://clicknexttest.biz/api"
$env:ANTHROPIC_AUTH_TOKEN="cnx-xxxxxxxx"
$env:ANTHROPIC_MODEL="auto"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL="auto"
claude

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://clicknexttest.biz/api",
    "ANTHROPIC_AUTH_TOKEN": "cnx-xxxxxxxx",
    "ANTHROPIC_MODEL": "auto",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "auto"
  }
}

mkdir -p ~/.config/opencode && curl -fsSL \
  -H "Authorization: Bearer cnx-xxxxxxxx" \
  https://clicknexttest.biz/api/opencode.json \
  -o ~/.config/opencode/opencode.json

{
  "provider": {
    "clicknext": {
      "npm": "@ai-sdk/openai-compatible",
      "options": {
        "baseURL": "https://clicknexttest.biz/api/v1",
        "apiKey": "cnx-xxxxxxxx"
      },
      "models": { "gpt-5.6-luna": {}, "auto": {} }
    }
  }
}

models:
  - name: ClickNext Gateway
    provider: openai
    model: gpt-5.6-luna
    apiBase: https://clicknexttest.biz/api/v1
    apiKey: cnx-xxxxxxxx

export OPENAI_API_BASE=https://clicknexttest.biz/api/v1
export OPENAI_API_KEY=cnx-xxxxxxxx
aider --model openai/gpt-5.6-luna

curl https://clicknexttest.biz/api/v1/chat/completions \
  -H "Authorization: Bearer cnx-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-5.6-luna","messages":[{"role":"user","content":"สวัสดี"}]}'

from openai import OpenAI
client = OpenAI(api_key="cnx-xxxxxxxx",
                base_url="https://clicknexttest.biz/api/v1")
r = client.chat.completions.create(
    model="gpt-5.6-luna",
    messages=[{"role": "user", "content": "สวัสดี"}])
print(r.choices[0].message.content)

import OpenAI from "openai";
const client = new OpenAI({
  apiKey: process.env.CLICKNEXT_KEY,          // cnx-xxxxxxxx
  baseURL: "https://clicknexttest.biz/api/v1",
});
const r = await client.chat.completions.create({
  model: "gpt-5.6-luna",
  messages: [{ role: "user", content: "สวัสดี" }],
});
console.log(r.choices[0].message.content);

import anthropic
client = anthropic.Anthropic(api_key="cnx-xxxxxxxx",
                             base_url="https://clicknexttest.biz/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 รวม function tools กับ reasoning_effort บน chat/completions ไม่ได้ เกตเวย์จึงตั้ง reasoning_effort เป็น none ให้เองเมื่อคำขอมี tools — ฝั่ง Warp ไม่ต้องตั้งอะไรเพิ่ม (ผลคือรอบที่มี tools บนสายนี้ไม่ใช้โหมดคิดลึก)
• Model name ต้องอยู่ในรายการของคีย์คุณ เช่น gpt-5.6-luna หรือ auto — ดูรายการจริงจาก /api/v1/models

โมเดลที่ใช้ได้

รายการโมเดลขึ้นกับสิทธิ์ของคีย์และทีมของคุณ และแอดมินเพิ่ม/ปิดโมเดลได้ตลอด — ดึงรายการจริงจากเกตเวย์เสมอ

curl https://clicknexttest.biz/api/v1/models \
  -H "Authorization: Bearer cnx-xxxxxxxx"

ได้ {"object":"list","data":[{"id":"…","owned_by":"…","context_window":…}]} — ใช้ค่า id เป็นชื่อโมเดลในเครื่องมือได้ทันที (รายการนี้มีเฉพาะโมเดลแชท โมเดลสร้างรูป/วิดีโอไม่แสดง)

ตัวอย่างที่ใช้กันบ่อย (ณ 29 ก.ย. 2026 — คีย์ของคุณอาจมีมากหรือน้อยกว่านี้)

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

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

• รอบรีเซ็ต: รายสัปดาห์ (เริ่มนับใหม่ทุกวันจันทร์) หรือรายเดือน (วันที่ 1) ตามที่แอดมินตั้งให้คีย์นั้น — เวลารีเซ็ตที่แน่นอนดูจาก resets_at
• นับรวมกับเว็บแชท: โทเคนที่คุณใช้ใน /chat บนเว็บ ถูกนับเข้าโควตาโทเคนของคีย์ด้วย · ถ้าใช้คีย์ agent-auto ตัวเดียวกับแอปเดสก์ท็อป ก็เป็นงบก้อนเดียวกับแอป
• โควตาหมดระหว่างแชท: คำขอ /chat/completions และ /messages จะถูกย้ายไปรันบนโมเดลภายในของบริษัทแทนการตัดทันที (ไม่เสียค่าใช้จ่ายเพิ่ม แต่คำตอบอาจช้าหรือต่างจากเดิม) · ถ้าโมเดลภายในไม่พร้อม จะได้ 429 quota_exceeded
• endpoint อื่นทั้งหมด (รวม /models, /limits, สร้างรูป) ตอบ 429 quota_exceeded ทันทีระหว่างที่โควตาหมด
• ยิงถี่เกิน: มีด่านกันยิงถี่ต่อ IP — เกินประมาณ 1,200 คำขอ/นาทีจาก IP เดียว ได้ 429 Too many requests. Please slow down. (รอ 60 วินาที) · ลิมิตต่อนาทีระดับคีย์ แอดมินเปิดได้ถ้าจำเป็น
• สร้างรูป มีโควตารายวันแยกตามสิทธิ์ทีม

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

curl https://clicknexttest.biz/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 ที่เกตเวย์ตอบกลับ (บน /api/v1/messages): x-clicknext-model = โมเดลที่รันจริง · x-clicknext-context-window = ขนาด context ของโมเดลนั้น · x-clicknext-effort = ระดับการคิดที่ใช้จริง

ดู/ดึงโปรเจกต์: GET /api/v1/projects (รายการ) · GET /api/v1/projects/<id>/resume (สรุปงาน + 10 รอบล่าสุด) · POST /api/v1/projects/<id>/summarize (สรุปใหม่เดี๋ยวนี้) — หรือเรียกผ่าน MCP ด้วย list_projects / resume_project

curl https://clicknexttest.biz/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://clicknexttest.biz/api/v1/images/generations \
  -H "Authorization: Bearer cnx-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"prompt":"โลโก้ร้านกาแฟ โทนเขียว มินิมอล"}'

• ได้ {"created":…,"data":[{"b64_json":"…"}],"via":"…"} — ใส่ "response_format":"url" ถ้าอยากได้เป็น data URL แทน
• สร้างครั้งละ 1 รูป · prompt ยาวได้ถึง 1,000 ตัวอักษร (ไทยได้) · เกตเวย์เลือกเอนจินให้ตามที่แอดมินตั้ง (Seedream / GPT image / Freepik)
• ต้องมีสิทธิ์สร้างรูปของทีม (ไม่มีสิทธิ์ = 403) และมีโควตารายวัน (เกิน = 429 daily image quota exceeded)
• ในเครื่องมือที่ต่อ MCP ใช้เครื่องมือ generate_image แทนได้ · สร้างวิดีโอและโมเดล 3D ยังไม่เปิดให้คีย์ cnx- เรียกตรง — ใช้ในแอปเดสก์ท็อปหรือ /chat

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

ยิงคำขอเดียวเพื่อเช็กว่า key + endpoint ใช้ได้

curl https://clicknexttest.biz/api/v1/chat/completions \
  -H "Authorization: Bearer cnx-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-5.6-luna","messages":[{"role":"user","content":"ping"}]}'

ได้ JSON ที่มี choices[0].message.content = เชื่อมต่อสำเร็จ · ได้ 401 = คีย์ผิด · ได้ 403 = โมเดลนอกสิทธิ์ (ลองเปลี่ยนเป็น auto) · เช็กโควตาที่เหลือด้วย /api/v1/limits

แก้ปัญหาที่พบบ่อย

ขั้นถัดไป: ClickNext MCP

นอกจาก endpoint โมเดล ยังต่อ ClickNext MCP เพื่อให้เครื่องมือภายนอกเรียกเครื่องมือของ ClickNext เองได้ — คลังสกิล (รวมสกิลผู้เชี่ยวชาญ), สมององค์กร (Org Brain), ความต่อเนื่องของโปรเจกต์, สร้างรูป และ Hub ที่เรียกทะลุไประบบปลายทาง ด้วยคีย์เดียวกัน ดูวิธีที่ หน้า MCP