SiCore TokenWorks

เอกสาร API

คำแนะนำการเชื่อมต่อโดยละเอียดและเอกสารอ้างอิง API เพื่อช่วยให้คุณรวมบริการ SiCore TokenWorks AI API ได้อย่างรวดเร็ว

1เริ่มต้นใช้งาน

ใช้ SiCore TokenWorks API เพียง 3 ขั้นตอนง่ายๆ:

  1. ลงทะเบียนบัญชี SiCore TokenWorks และเข้าสู่ระบบคอนโซล
  2. สร้าง API Key ในคอนโซล
  3. ใช้ API Key ของคุณเพื่อเรียกใช้ API ของเรา

Tip: ผู้ใช้ใหม่จะได้รับเครดิตทดลองใช้ฟรีหลังลงทะเบียน โดยไม่ต้องผูกบัตรเครดิตเพื่อเริ่มใช้งาน

2ที่อยู่ API

ที่อยู่พื้นฐานของ API มีดังนี้ ทุกคำขอใช้โปรโตคอล HTTPS:

text
https://www.token8341.com/v1

อินเทอร์เฟซ Chat Completion:

text
POST https://www.token8341.com/v1/chat/completions

Note: อินเทอร์เฟซนี้เข้ากันได้อย่างสมบูรณ์กับรูปแบบอินเทอร์เฟซ Chat Completions ของ OpenAI คุณสามารถใช้ OpenAI SDK เพื่อเรียกใช้ได้โดยตรง

3วิธีการยืนยันตัวตน

SiCore TokenWorks ใช้ Bearer Token สำหรับการยืนยันตัวตน API โปรดนำ API Key ของคุณในส่วนหัวของคำขอ:

text
Authorization: Bearer sk-your-api-key-here

คุณสามารถสร้างและจัดการคีย์ของคุณได้ที่หน้า «API Keys» ในคอนโซล โปรดเก็บ API Key ของคุณอย่างปลอดภัย อย่าเปิดเผยในที่เก็บโค้ดสาธารณะหรือโค้ดฝั่งไคลเอนต์

4รายการโมเดลที่รองรับ

รหัสโมเดลชื่อโมเดลผู้ให้บริการ
gpt-4oGPT-4oOpenAI
gpt-4o-miniGPT-4o MiniOpenAI
claude-3-5-sonnetClaude 3.5 SonnetAnthropic
claude-4-sonnetClaude 4 SonnetAnthropic
gemini-2-0-proGemini 2.0 ProGoogle
deepseek-v4-proDeepSeek-V4-ProDeepSeek
qwen-maxQwen-MaxAlibaba Cloud

กำลังเพิ่มโมเดลเพิ่มเติมอย่างต่อเนื่อง โปรดติดตามประกาศอัปเดตของเรา

5โค้ดตัวอย่าง

curl

bash
curl https://www.token8341.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-api-key-here" \
  -d '{
    "model": "gpt-4o",
    "messages": [
      {"role": "user", "content": "Hello!"}
    ]
  }'

Python (openai SDK)

python
from openai import OpenAI

client = OpenAI(
    base_url="https://www.token8341.com/v1",
    api_key="sk-your-api-key-here"
)

response = client.chat.completions.create(
    model="gpt-4o",
    messages=[
        {"role": "user", "content": "Hello!"}
    ]
)

print(response.choices[0].message.content)

Node.js (openai SDK)

javascript
import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://www.token8341.com/v1",
  apiKey: "sk-your-api-key-here",
});

const response = await client.chat.completions.create({
  model: "gpt-4o",
  messages: [
    { role: "user", content: "Hello!" },
  ],
});

console.log(response.choices[0].message.content);

6คำอธิบายรหัสข้อผิดพลาด

เมื่อคำขอ API ล้มเหลว จะส่งคืนรหัสสถานะ HTTP และข้อความข้อผิดพลาดที่เกี่ยวข้อง รูปแบบดังนี้:

json
{
  "error": {
    "message": "Insufficient balance",
    "type": "insufficient_balance",
    "code": 402
  }
}
รหัสสถานะชื่อคำอธิบาย
400Bad Request请求参数错误,请检查请求体格式
401UnauthorizedAPI Key 无效或缺失,请检查 Authorization 请求头
402Insufficient Balance账户余额不足,请充值后重试
404Not Found请求的模型或接口不存在
429Rate Limit请求频率过高,请稍后重试
500Internal Server Error服务内部错误,请联系技术支持
503Service Unavailable模型服务暂时不可用,请稍后重试

คำถามที่พบบ่อยเกี่ยวกับการเชื่อมต่อ

คำถามที่พบบ่อยเกี่ยวกับ API Key การสลับโมเดล และภาษาที่ใช้เชื่อมต่อ

API Key หนึ่งตัวสามารถเรียกใช้ทุกโมเดลได้หรือไม่?

ได้ นี่คือคุณสมบัติหลักของ SiCore TokenWorks — นักพัฒนาต้องเชื่อมต่อเพียงครั้งเดียวก็สามารถเรียกใช้ทุกโมเดลบนแพลตฟอร์มได้ โดยไม่ต้องสมัครบัญชีและจัดการ Key แยกสำหรับแต่ละผู้ให้บริการ

การสลับโมเดลต้องแก้ไขโค้ดหรือไม่?

ไม่ต้องแก้ไขโค้ดลอจิก เพียงเปลี่ยนพารามิเตอร์ model ID เพียงตัวเดียวก็สามารถสลับระหว่างโมเดลในประเทศและต่างประเทศได้

รองรับภาษาโปรแกรมใดบ้าง?

มีตัวอย่างการเชื่อมต่อยอดนิยม เช่น cURL, Python, Node.js และรองรับภาษาที่สามารถส่ง HTTP request ได้ทุกภาษา รวมถึง OpenAI SDK อย่างเป็นทางการ

API รับรองความถูกต้องอย่างไร?

วิธีการรับรองความถูกต้องคือ Bearer Token โดยเพียงแนบ API Key ไว้ใน header ของคำขอ; อินเทอร์เฟซเข้ากันได้เต็มรูปแบบกับรูปแบบ Chat Completions ของ OpenAI สามารถเรียกใช้ได้โดยตรงด้วย SDK อย่างเป็นทางการของ OpenAI โดยไม่ต้องปรับแต่งเพิ่มเติม

มี SDK หรือตัวอย่างโค้ดสำเร็จรูปหรือไม่?

มี แพลตฟอร์มมีตัวอย่างการเชื่อมต่อยอดนิยม เช่น cURL, Python, Node.js เป็นต้น นักพัฒนาสามารถเลือกตามภาษาของตนเองเพื่อผสานรวมได้อย่างรวดเร็ว

โมเดลจะเพิ่มขึ้นอย่างต่อเนื่องหรือไม่? โมเดลใหม่ต้องแก้โค้ดหรือไม่?

จะเพิ่มขึ้น แพลตฟอร์มเชื่อมต่อโมเดลชั้นนำทั้งในประเทศและต่างประเทศอย่างต่อเนื่อง วิธีการเชื่อมต่อและระบบคิดค่าบริการให้สอดคล้องกัน เมื่อโมเดลใหม่เปิดให้บริการสามารถเลือกใช้ได้โดยตรงโดยไม่ต้องแก้โค้ด

กลไกแคชของ API โมเดลขนาดใหญ่ใช้อย่างไร? 命中ได้ในสถานการณ์แบบไหน?

แพลตฟอร์มใช้แคชร่วมข้ามผู้ใช้สำหรับ prompt เดียวกัน เมื่อ命中ราคาจะลดลงอีกกว่า 90% ราคาแคชที่命中ต่ำสุด ¥0.010 / ล้าน Token ส่วนที่命中คิดค่าบริการตามราคาแคช เหมาะกับสถานการณ์ที่ผู้ใช้หลายรายใช้ prompt prefix เดียวกันซ้ำ เช่น system prompt แบบคงที่, prefix ความรู้สาธารณะ เป็นต้น — วางส่วนที่ไม่เปลี่ยนแปลงไว้ข้างหน้า อัตราการ命中จะสูงขึ้น

เมื่อเรียก API ล้มเหลวหรือ timeout จะทำ auto retry และ fallback อย่างไร?

วิธีที่ใช้ทั่วไปคือ: สำหรับ timeout และข้อผิดพลาดที่ retry ได้ ใช้ exponential backoff retry พร้อมกำหนดจำนวน retry สูงสุด; หากยังล้มเหลวก็ fallback ไปยังโมเดลสำรอง การสลับโมเดลบนแพลตฟอร์มเพียงแก้ไข model ID โค้ดไม่ต้องแก้ไขเลย เพียงเขียนเป้าหมาย fallback เป็น model ID อีกตัว ฝั่งแพลตฟอร์มยังมี multi-node redundancy และ cross-region intelligent routing เมื่อโหนดใดโหนดหนึ่งผิดปกติจะสลับให้อัตโนมัติ

จะเปรียบเทียบประสิทธิภาพและต้นทุนของโมเดลต่างๆ อย่างไร?

API Key เดียวสามารถเรียกใช้โมเดลทั้งหมดได้ การสลับโมเดลเพียงแก้ไข model ID โค้ดไม่ต้องแก้ไขเลย เมื่อทำการเปรียบเทียบแนวนอนไม่จำเป็นต้องเชื่อมต่อแยกสำหรับแต่ละโมเดล แนะนำให้ใช้ตัวอย่างธุรกิจชุดเดียวกันเรียกใช้แยกกัน บันทึกคุณภาพผลลัพธ์และปริมาณการใช้งาน แล้วเปรียบเทียบราคาอย่างเป็นทางการกับราคาของเว็บไซต์นี้ทีละรายการโดยอ้างอิง «ตารางเปรียบเทียบราคาโมเดลทั้งหมด» บนเว็บไซต์

API Key ฝั่งเซิร์ฟเวอร์ควรจัดเก็บอย่างปลอดภัยอย่างไร?

แนะนำให้เก็บ API Key ไว้ฝั่งเซิร์ฟเวอร์เท่านั้น ส่งผ่าน request header ในรูปแบบ Bearer Token อย่าเขียนลงในโค้ด frontend หรือ client ข้อมูลคำขอและการตอบกลับของแพลตฟอร์มเข้ารหัสด้วย HTTPS ตลอดเส้นทาง และมีระบบจัดการสิทธิ์ระดับองค์กรพร้อม audit log บันทึกการเรียกใช้สามารถตรวจสอบย้อนหลังได้

ในสถานการณ์ที่มี concurrency สูง จะรับประกันความเสถียรและ latency ต่ำได้อย่างไร?

แพลตฟอร์มอาศัยศูนย์ประมวลผลในเขต Inner Mongolia Helingeer, Xinjiang Hami, Ningxia Zhongwei และอื่นๆ ผ่านอัลกอริทึมจัดตารางที่พัฒนาขึ้นเองเพื่อทำ cross-region intelligent routing และ dynamic load balancing เมื่อโหนดใดโหนดหนึ่งผิดปกติจะสลับให้อัตโนมัติ; ผู้ใช้ในเมืองหลักจะได้ latency ระดับมิลลิวินาที โดยรับประกัน service availability 99.9% แนะนำให้ฝั่ง client ใช้ร่วมกับ backoff retry และ multi-model fallback ด้วย

จะติดตามปริมาณการเรียกใช้ ค่าใช้จ่าย และความผิดปกติได้อย่างไร?

แพลตฟอร์มมีบัญชีแบบรวมและระบบคิดค่าบริการชุดเดียว ปริมาณการใช้งานโปร่งใส ยอดคงเหลือเข้าบัญชีแบบเรียลไทม์ สามารถดูรายละเอียดการใช้จ่ายได้ตลอดเวลา; พร้อมกันนี้ยังมีฟังก์ชัน audit log สำหรับการเรียก API บันทึกการเรียกใช้สามารถตรวจสอบย้อนหลังได้ หากผู้ใช้ระดับองค์กรต้องการข้อกำหนดด้าน compliance ที่เข้มงวดยิ่งขึ้น (การจัดการสิทธิ์, audit log เป็นต้น) สามารถติดต่อฝ่ายบริการลูกค้าเพื่อประสานงานฝ่ายธุรกิจ