Dokumentasi API

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

1Mulai Cepat

Menggunakan API TokenWorks hanya perlu tiga langkah sederhana:

Daftar akun TokenWorks dan masuk ke konsol
Buat API Key di konsol
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

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 Model	Nama Model	Penyedia
gpt-4o	GPT-4o	OpenAI
gpt-4o-mini	GPT-4o Mini	OpenAI
claude-3-5-sonnet	Claude 3.5 Sonnet	Anthropic
claude-4-sonnet	Claude 4 Sonnet	Anthropic
gemini-2-0-pro	Gemini 2.0 Pro	Google
deepseek-v4-pro	DeepSeek-V4-Pro	DeepSeek
qwen-max	Qwen-Max	Alibaba 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 Status	Nama	Deskripsi
400	Bad Request	请求参数错误，请检查请求体格式
401	Unauthorized	API Key 无效或缺失，请检查 Authorization 请求头
402	Insufficient Balance	账户余额不足，请充值后重试
404	Not Found	请求的模型或接口不存在
429	Rate Limit	请求频率过高，请稍后重试
500	Internal Server Error	服务内部错误，请联系技术支持
503	Service Unavailable	模型服务暂时不可用，请稍后重试