Gommo Developer

ไทย

English
Tiếng Việt

ไทย

English
Tiếng Việt

ธีม

เข้าสู่ระบบสมัครสมาชิก

คำถามที่พบบ่อย ​

คำถามทั่วไปเกี่ยวกับ Gommo Developer และ Gommo upstream

สถานะ upstream

Catalog งาน และ login เรียก Gommo public API หาก v2.api.gommo.net หรือ api.gommo.net ล่ม /th/models/ และ Playground Send จะล้มเหลว — docs และ UI ยังโหลดได้ ลองใหม่เมื่อ upstream กลับมา

Coming to Gommo platform

BYOK, SDK, webhooks, billing portal… เป็น preview ของแพลตฟอร์ม Gommo — ไม่ใช่ API self-host ถาวร ดู Roadmap แพลตฟอร์ม Gommo

เริ่มต้น ​

Gommo Developer ต่างจากเรียก Gommo ตรงอย่างไร?

Gommo public API (แนะนำ): เรียก https://v2.api.gommo.net และ https://api.gommo.net โดยตรง — ดู Gommo public API
Gommo Developer (ทางเลือก): self-host สำหรับ portal/billing/BYOK — ดู Deploy → Self-host ขั้นสูง

ต้องมีอะไรเพื่อเริ่มต้น?
API playground อยู่ที่ไหน?

/th/app/playground/ — แท็บ Endpoints แสดง URL public ของ Gommo

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

ได้ user token อย่างไร?

POST /api/apps/go-mmo/auth/login ด้วย email, password, domain (โดเมนลงทะเบียน) Response: access_token ดู การยืนยันตัวตน

เปลี่ยนรหัส login ของ user อย่างไร?

POST https://api.gommo.net/api/apps/go-mmo/auth/change-password — form access_token, domain, current_password, new_password ไม่ใช่ set_password ของ AI project Self-host: POST {gateway}/gateway/auth/change-password (Bearer + JSON) ดู การตั้งค่าบัญชี — เปลี่ยนรหัสผ่าน

โอน credit ไป username อื่นอย่างไร?

POST https://api.gommo.net/api/apps/go-mmo/users/sendBalances — form access_token, domain, type=credit_ai, username, value, message ไม่ใช่ merchant /admin/credits/send ขั้นต่ำ 10,000 / สูงสุด 20,000,000 ต่อครั้ง หลังโอนต้องเหลือ > 500,000 credits Upstream อาจ HTTP 200 + error: 1 — อ่าน message Self-host: POST {gateway}/gateway/credits/transfer (Bearer + JSON) ดู โอน credit

ประวัติธุรกรรมกระเป๋า (ไม่ใช่ usage-history) อยู่ที่ไหน?

Dealer Transaction History ใช้ POST https://api.gommo.net/api/apps/go-mmo/users/paymentsHistory — form access_token, domain, limit (UI มัก 500), time_start / time_end (0 = ตลอดเวลา), ไม่บังคับ currency_name, source, language Response มัก { data, runtime } — รวม IN/OUT/NET ฝั่ง client จาก fluctuation_type และ value_change ไม่ใช่ POST /api/v2/usage-history Self-host: POST {gateway}/gateway/credits/transactions (Bearer + JSON) ดู ประวัติธุรกรรม

อุปกรณ์เซสชัน (Devices) อยู่ที่ไหน?

Dealer Account → Devices ใช้ POST https://api.gommo.net/api/v2/devices — form access_token, domain, action (register, list, rename, disable) List/register มักส่ง current_device_id และ device_* — rename / disable ใช้ device_id (UUID จาก data.items[]) ไม่ใช่ id_base Response มัก { success, data: { items, current_device_id } } หรือแถวเดียวเมื่อ mutation Self-host: POST {gateway}/gateway/devices (Bearer + JSON) ดู อุปกรณ์เซสชัน

API Support Center อยู่ที่ไหน?

Dealer Support ใช้ POST https://api.gommo.net/api/apps/go-mmo/support/* — myTickets, create, detail, reply ด้วย ticket_id_base (SUP-… ตรง ticket_id_hash จาก create) Self-host: /gateway/support/tickets (+ /create, /detail, /reply) Bearer + JSON ดู ตั๋วซัพพอร์ต

API โปรแกรมพาร์ทเนอร์อยู่ที่ไหน?

โปรแกรมพาร์ทเนอร์ (affiliate): POST https://api.gommo.net/api/apps/go-mmo/users/partner_program ด้วย action_type=status หรือ apply. Self-host: POST /gateway/partner-program Bearer + JSON. ดู โปรแกรมพาร์ทเนอร์.

Creator Rewards: POST https://api.gommo.net/api/apps/go-mmo/users/creator_rewards ด้วย action_type=status, pool, หรือ apply. Self-host: POST /gateway/creator-rewards. ดู Creator Rewards.

ต้องส่ง domain ทุก call ไหม?

Gommo public API (แนะนำ): ส่ง domain ใน form body ตรงกับโดเมนลงทะเบียนผู้ใช้

Operator self-host: ดู Deploy → Self-host ขั้นสูง

Merchant token คืออะไร?

GOMMO_ACCESS_TOKEN ใน .env เซิร์ฟเวอร์ — สำหรับ /th/admin/* และ fulfillment PayOS legacy ไม่บังคับสำหรับเติม Gommo เติมเครดิต ค่าเริ่มต้น ห้ามใส่ใน browser

โมเดล & งาน ​

งานล้มเพราะ ratio/mode ไม่ถูกต้อง?

คุณเดาพารามิเตอร์ ลิสต์โมเดลก่อนเสมอและใช้ค่าจากแคตตาล็อก ดู โมเดล

Poll ใช้เวลานานแค่ไหน?

Poll ฝั่ง client ทุก 3.5s สูงสุด 80 ครั้ง (~5 นาที) วิดีโอมัก 1–5 นาที

Gommo มี webhook เมื่องานเสร็จไหม?

ไม่บน public integrator API — poll ฝั่ง client webhook ชำระเงิน / observability gateway คนละเรื่อง — Webhooks (แนวคิด)

Self-host (operator) ​

เมื่อไหร่ต้องใช้ API self-host?

เมื่อ deploy repo สำหรับ portal billing, BYOK หรือ dev proxy เท่านั้น — ไม่จำเป็นสำหรับการเชื่อมต่อ Gommo ทั่วไป ดู Deploy → Self-host ขั้นสูง

Billing ​

Integrator ต้องเชื่อม billing Gommo หรือแนะนำ user เติมเครดิต Gommo ไหม?

ไม่ — การเชื่อมต่อ Gommo public API มาตรฐานต้องการแค่ access_token Gommo และ เครดิต เพียงพอบนบัญชี Gommo (ดู การยืนยันตัวตน)

  • ราคา/การชำระของแอปคุณ (Stripe, ช่องทางชำระเงินของคุณ, subscription ฯลฯ) เป็น ผลิตภัณฑ์ของคุณ — ไซต์นี้ไม่สอนวิธีเก็บเงินจากลูกค้าของคุณ
  • เติมเครดิต Gommo (user จ่ายเพื่อได้เครดิต AI บน โดเมนลงทะเบียน / dealer) เป็นเรื่องแยก Docs Tier A ไม่ กำหนด flow production เติมเครดิต
  • Preview วันนี้: portal /th/app/credits/ และ self-host /th/billing/* เป็น Coming to Gommo platform — สำหรับ operator ทดสอบ checkout ไม่ใช่ contract เริ่มต้นของ integrator เมื่อ Gommo ship billing developer อย่างเป็นทางการ ใช้ โดเมนและ docs ของ Gommo — ไม่ใช่ localhost:3001

→ Roadmap แพลตฟอร์ม Gommo · Billing & credits (operator)

เติมเครดิตอย่างไร?

Operator / preview portal (ไม่บังคับสำหรับ integrator Tier A):

ค่าเริ่มต้น: Gommo เติมเครดิต — POST /billing/payment/create (Bearer user) แล้ว poll POST /billing/payment/sync จน paid: true Portal: /th/app/credits/ คู่มือ: Gommo เติมเครดิต

Legacy (ทางเลือก): PayOS ผ่าน POST /billing/topup/create เมื่อตั้ง PAYOS_* และ merchant ดู PayOS เติมเครดิต (legacy)

Billing ผิดพลาด — ตรวจอะไร?

เรียก GET /billing/status — flow ค่าเริ่มต้นต้อง billingMode: "gommo" และ gommoPayment: true

ข้อผิดพลาดที่พบบ่อย:

  • Bearer ไม่ตรง username ใน body
  • packageId ไม่ถูกต้อง
  • PayOS legacy: payosConfigured หรือ merchantReady เป็น false
/billing/topup/create คืน 503?

Path นี้สำหรับ PayOS legacy เท่านั้น PayOS หรือ merchant env ยังไม่ตั้ง การเชื่อมต่อใหม่ใช้ POST /billing/payment/create ตรวจ GET /billing/status

ต้องมี billing เพื่อใช้ Gommo API ไหม?

ไม่ — billing เป็นการเติมทางเลือก ผู้ใช้ต้องมีเครดิต Gommo (บัญชี upstream หรือเติมเงิน)

MCP & Cursor ​

ควรใช้ MCP ไหนใน Cursor?

แนะนำ: Gommo remote MCP — 10 tools token /th/app/token/ JSON สำหรับ Cursor Claude ChatGPT และ โฮสต์อื่น

แอป production: HTTP ไปยัง Gommo public API — ดู Gommo public API ไม่ใช่ MCP

ทางเลือก: Gommo Developer MCP server เมื่อ IDE ต้องเรียก GATEWAY_URL แยก npm alias: @ai-gateway/mcp-server

Gommo MCP ทำอะไรได้?

10 tools: บัญชี/เครดิต แคตตาล็อก สร้างรูป/วิดีโอ poll status/stream ประวัติงาน แจ้งเตือน ดู tools และ กรณีใช้งาน

ใช้ Gommo MCP นอก Cursor ได้ไหม?

ได้ — client MCP ที่รองรับ remote url + headers โฮสต์อื่น ChatGPT/Gemini web ไม่ใช้ MCP — ใช้ HTTP

Token /app/token/ ใช้กับ Gommo MCP ได้ไหม?

ได้ การเข้าสู่ระบบ/สมัครคืน access_token ผู้ใช้ Gommo ใช้ใน header Gommo MCP (Gommo-Token + Authorization: Bearer …) และ Authorization: Bearer … สำหรับ HTTP ไปยัง v2.api.gommo.net และ api.gommo.net

ต้องรัน gateway เพื่อใช้ MCP ไหม?

ไม่ กับ Gommo MCP — tool เรียก MCP host ของ Gommo

ใช่ เฉพาะ Gommo Developer MCP server (GATEWAY_URL) npm alias: @ai-gateway/mcp-server

Self-hosted MCP server คืออะไร?

Gommo Developer MCP server — แพ็กเกจทางเลือกสำหรับ merchant ที่ต้องการ tool Cursor เรียก gateway URL ของตัวเอง แทน Gommo remote MCP ดู Self-hosted บน npm: @ai-gateway/mcp-server ผู้ใช้ส่วนใหญ่ใช้ Gommo MCP

Deploy & ปฏิบัติการ ​

ต้องใช้ CORS เมื่อไหร่?

เมื่อ browser app origin ต่าง เรียก API (เช่น localhost:5175) ไม่ต้องสำหรับ /th/portal หรือ client ฝั่งเซิร์ฟเวอร์

ตั้ง GATEWAY_CORS_ORIGIN หลาย origin คั่นด้วย comma

ดู Deploy และ แนวปฏิบัติที่ดี

/portal มีบน production ไหม?

ปิดค่าเริ่มต้น (NODE_ENV=production) เปิด GATEWAY_PORTAL=true หากยอมรับความเสี่ยง

ยังติดขัด? ​

→ ส่ง feedback · ชุมชน