API Dokümantasyonu

Ayrıntılı entegrasyon rehberi ve API referansı ile TokenWorks AI API hizmetine hızlıca entegre olun

1Hızlı Başlangıç

TokenWorks API'yi kullanmak yalnızca üç basit adım gerektirir:

TokenWorks hesabı oluşturun ve konsola giriş yapın
Konsolda bir API Key oluşturun
API Key'inizi kullanarak uç noktalarımızı çağırın

Tip: Yeni kullanıcılar kayıt olduktan sonra ücretsiz deneme kotası alır, kredi kartı bağlamadan kullanmaya başlayabilirsiniz.

2API Adresi

API temel adresi aşağıdadır, tüm istekler HTTPS protokolünü kullanır:

text

https://www.token8341.com/v1

Sohbet tamamlama uç noktası:

text

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

Note: Bu uç nokta, OpenAI'nin Chat Completions uç nokta formatıyla tamamen uyumludur; doğrudan OpenAI SDK'sını kullanarak çağırabilirsiniz.

3Kimlik Doğrulama Yöntemi

TokenWorks, API kimlik doğrulaması için Bearer Token kullanır. Lütfen istek başlığınıza API Key'inizi ekleyin:

text

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

Anahtarlarınızı konsolun 'API Keys' sayfasından oluşturabilir ve yönetebilirsiniz. API Key'inizi güvenli bir şekilde saklayın, herkese açık kod depolarında veya istemci kodlarında ifşa etmeyin.

4Desteklenen Model Listesi

Model Kimliği	Model Adı	Sağlayıcı
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

Daha fazla model sürekli olarak eklenmektedir, güncelleme duyurularımızı takip edin.

5Örnek Kod

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

6Hata Kodları Açıklaması

API isteği başarısız olduğunda ilgili HTTP durum kodu ve hata mesajı döndürülür, format aşağıdaki gibidir:

json

{
  "error": {
    "message": "Insufficient balance",
    "type": "insufficient_balance",
    "code": 402
  }
}

Durum Kodu	Ad	Açıklama
400	Bad Request	请求参数错误，请检查请求体格式
401	Unauthorized	API Key 无效或缺失，请检查 Authorization 请求头
402	Insufficient Balance	账户余额不足，请充值后重试
404	Not Found	请求的模型或接口不存在
429	Rate Limit	请求频率过高，请稍后重试
500	Internal Server Error	服务内部错误，请联系技术支持
503	Service Unavailable	模型服务暂时不可用，请稍后重试