SiCore TokenWorks

Dokumentasi API

Panduan integrasi terperinci dan referensi API, membantu Anda mengintegrasikan layanan API AI SiCore TokenWorks dengan cepat

1Mulai Cepat

Menggunakan API SiCore TokenWorks hanya perlu tiga langkah sederhana:

  1. Daftar akun SiCore TokenWorks dan masuk ke konsol
  2. Buat API Key di konsol
  3. Gunakan API Key Anda untuk memanggil antarmuka kami

Tip: Pengguna baru akan mendapatkan kuota uji coba gratis setelah mendaftar, tanpa perlu mengikat kartu kredit untuk mulai menggunakan.

2URL Dasar

Alamat dasar API adalah sebagai berikut, semua permintaan menggunakan protokol HTTPS:

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

Antarmuka pelengkap chat:

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

Note: Antarmuka ini sepenuhnya kompatibel dengan format antarmuka Chat Completions OpenAI, Anda dapat langsung menggunakan SDK OpenAI untuk melakukan panggilan.

3Metode Autentikasi

SiCore TokenWorks menggunakan Bearer Token untuk autentikasi API. Harap bawa API Key Anda di header permintaan:

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

Anda dapat membuat dan mengelola kunci Anda di halaman «API Keys» di konsol. Harap simpan API Key Anda dengan aman, jangan diekspos di repositori kode publik atau kode klien.

4Daftar Model yang Didukung

ID ModelNama ModelPenyedia
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

Lebih banyak model sedang terus diintegrasikan, harap perhatikan pengumuman pembaruan kami.

5Kode Contoh

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);

6Penjelasan Kode Kesalahan

Saat permintaan API gagal, akan mengembalikan kode status HTTP dan informasi kesalahan yang sesuai, formatnya sebagai berikut:

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

Pertanyaan Umum Integrasi

Pertanyaan umum tentang API Key, pergantian model, dan bahasa integrasi

Apakah satu API Key dapat memanggil semua model?

Bisa. Ini adalah fitur inti SiCore TokenWorks—developer hanya perlu melakukan integrasi sekali untuk memanggil semua model di platform, tanpa perlu mendaftar akun dan mengelola Key secara terpisah untuk setiap penyedia.

Apakah pergantian model memerlukan perubahan kode?

Tidak perlu mengubah kode logika, cukup mengubah satu parameter yaitu model ID untuk beralih antara model domestik dan luar negeri.

Bahasa pemrograman apa saja yang didukung?

Tersedia contoh integrasi utama seperti cURL, Python, Node.js, dan kompatibel dengan bahasa apa pun yang mendukung HTTP request serta OpenAI SDK resmi.

Bagaimana cara autentikasi API?

Metode autentikasinya adalah Bearer Token, cukup sertakan API Key di header permintaan; antarmuka sepenuhnya kompatibel dengan format Chat Completions OpenAI, dapat langsung dipanggil menggunakan SDK resmi OpenAI, tanpa perlu penyesuaian tambahan.

Apakah ada SDK atau contoh kode yang tersedia?

Ada. Platform menyediakan contoh integrasi populer seperti cURL, Python, Node.js, pengembang dapat memilih sesuai bahasa yang digunakan untuk integrasi cepat.

Apakah model akan terus bertambah? Apakah model baru memerlukan perubahan kode?

Ya. Platform terus mengintegrasikan model-model baru dari dalam negeri maupun internasional, metode integrasi dan sistem penagihan tetap konsisten, setelah model baru diluncurkan tidak perlu mengubah kode dan dapat langsung digunakan.

Bagaimana cara menggunakan mekanisme cache pada API model besar? Dalam skenario apa cache bisa terpicu?

Platform menggunakan cache bersama lintas pengguna untuk prompt yang sama; setelah cache terpicu, harga turun lebih dari 90% lagi, dengan harga terpicu cache serendah ¥0.010 / juta Token, dan bagian yang terpicu ditagih dengan harga cache. Cocok untuk skenario di mana banyak pengguna berulang kali menggunakan prompt dengan prefiks yang sama, misalnya system prompt tetap, prefiks pengetahuan umum, dan sebagainya—letakkan bagian yang tidak berubah di depan agar tingkat cache hit lebih tinggi.

Jika panggilan API gagal atau timeout, bagaimana cara melakukan retry otomatis dan degradasi?

Praktik umumnya adalah: untuk timeout dan error yang dapat di-retry, gunakan exponential backoff retry dan tetapkan jumlah retry maksimum; jika masih gagal, degradasi ke model cadangan. Di platform ini, mengganti model hanya perlu mengubah ID model, tanpa perubahan kode sama sekali—cukup tulis target degradasi sebagai ID model lain. Di sisi platform juga tersedia redundansi multi-node dan routing cerdas lintas wilayah, sehingga anomali pada satu node akan dialihkan secara otomatis.

Bagaimana cara membandingkan efektivitas dan biaya berbagai model?

Satu API Key dapat digunakan untuk memanggil semua model; mengganti model hanya perlu mengubah ID model tanpa perubahan kode, sehingga untuk perbandingan horizontal tidak perlu integrasi terpisah untuk setiap model. Disarankan menggunakan sekumpulan sampel bisnis yang sama untuk memanggil masing-masing model, catat kualitas output dan penggunaan, lalu bandingkan item per item antara harga resmi dan harga situs ini dengan mengacu pada "Tabel Perbandingan Harga Semua Model" di situs resmi.

Bagaimana cara menyimpan API Key sisi server dengan aman?

Disarankan hanya menyimpan API Key di sisi server, dibawa melalui header permintaan dengan metode Bearer Token, dan jangan menuliskannya ke dalam kode frontend atau klien. Data permintaan dan respons platform dienkripsi dengan HTTPS sepanjang proses, serta menyediakan manajemen izin tingkat perusahaan dan log audit, sehingga catatan panggilan dapat dilacak.

Dalam skenario konkurensi tinggi, bagaimana menjamin stabilitas panggilan dan latensi rendah?

Platform bersandar pada pusat komputasi di Inner Mongolia Helingeer, Xinjiang Hami, Ningxia Zhongwei, dan lainnya, melakukan routing cerdas lintas wilayah serta penyeimbangan beban dinamis melalui algoritma penjadwalan yang dikembangkan sendiri, dengan pengalihan otomatis saat terjadi anomali pada satu node; pengguna di kota-kota inti dapat memperoleh latensi tingkat milidetik, dengan komitmen ketersediaan layanan 99.9%. Disarankan sisi klien juga dilengkapi dengan retry backoff dan degradasi multi-model.

Bagaimana cara memantau volume panggilan, biaya, dan anomali?

Platform menyediakan akun terpadu dan satu sistem penagihan, penggunaan transparan, saldo masuk secara real-time, dan rincian konsumsi dapat dilihat kapan saja; sekaligus menyediakan fungsi log audit untuk panggilan API, sehingga catatan panggilan dapat dilacak. Pengguna perusahaan yang membutuhkan persyaratan kepatuhan lebih ketat (manajemen izin, log audit, dan sebagainya) dapat menghubungi layanan pelanggan untuk koordinasi bisnis.