SiCore TokenWorks

API Dokümantasyonu

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

1Hızlı Başlangıç

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

  1. SiCore TokenWorks hesabı oluşturun ve konsola giriş yapın
  2. Konsolda bir API Key oluşturun
  3. 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

SiCore 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ğiModel AdıSağlayıcı
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

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

Entegrasyon SSS

API Key, model değiştirme ve entegrasyon dilleri hakkında sık sorulan sorular

Bir API Key tüm modelleri çağırabilir mi?

Evet. Bu, SiCore TokenWorks'ün temel özelliğidir — geliştiriciler yalnızca bir kez entegre olarak platformdaki tüm modelleri çağırabilir; her sağlayıcı için ayrı hesap açması ve Key yönetmesi gerekmez.

Model değiştirmek için kod değiştirmek gerekir mi?

Mantık kodunu değiştirmeye gerek yoktur; yalnızca model ID parametresini değiştirerek yerli ve yurt dışı modeller arasında geçiş yapılabilir.

Hangi programlama dilleri destekleniyor?

cURL, Python, Node.js gibi popüler entegrasyon örnekleri sunulur; HTTP isteklerini destekleyen tüm diller ve OpenAI resmi SDK ile uyumludur.

API kimlik doğrulaması nasıl yapılır?

Kimlik doğrulama yöntemi Bearer Token'dır; istek başlığında API Key taşımak yeterlidir. Arayüz, OpenAI'nin Chat Completions formatıyla tamamen uyumludur ve OpenAI resmi SDK'sı ile doğrudan çağrılabilir; ek uyarlama gerekmez.

Hazır SDK veya kod örneği var mı?

Evet. Platform, cURL, Python, Node.js gibi popüler entegrasyon örnekleri sunar; geliştiriciler kendi dillerine göre seçerek hızlıca entegre edebilir.

Modeller sürekli eklenecek mi? Yeni modeller için kod değiştirmek gerekir mi?

Evet. Platform, yeni yerli ve uluslararası popüler modelleri sürekli olarak entegre eder; entegrasyon yöntemi ve faturalandırma sistemi tutarlı kalır, yeni modeller yayına girdiğinde kod değiştirmeden doğrudan seçilebilir.

Büyük model API'sinin önbellek mekanizması nasıl kullanılır? Hangi senaryolarda isabet eder?

Platform, aynı prompt için kullanıcılar arası paylaşımlı önbellek kullanır; isabet sağlandığında fiyat %90'dan fazla düşer, önbellek isabet fiyatı en düşük ¥0.010 / milyon Token olup isabet eden kısım önbellek fiyatından faturalandırılır. Birden fazla kullanıcının aynı önek prompt'u tekrar kullandığı senaryolar için uygundur; örneğin sabit sistem prompt'ları, ortak bilgi önekleri vb. — değişmeyen kısmı başa koyarsanız isabet oranı daha yüksek olur.

API çağrısı başarısız olursa veya zaman aşımına uğrarsa otomatik yeniden deneme ve düşürme nasıl yapılır?

Genellikle şu yöntem izlenir: zaman aşımı ve yeniden denenebilir hatalar için üstel geri çekilmeli yeniden deneme uygulanır ve maksimum yeniden deneme sayısı belirlenir; yine başarısız olursa yedek modele düşürülür. Platformda model değiştirmek için yalnızca model ID'sini değiştirmek yeterlidir, kodda sıfır değişiklik gerekir; düşürme hedefini başka bir model ID'si olarak yazmanız yeterlidir. Platform tarafında ayrıca çok düğümlü yedeklilik ve bölgeler arası akıllı yönlendirme vardır; tek düğüm arızasında otomatik geçiş yapılır.

Farklı modellerin etkisi ve maliyeti nasıl karşılaştırılır?

Tek bir API Key ile tüm modeller çağrılabilir; model değiştirmek için yalnızca model ID'si değiştirilir, kodda sıfır değişiklik gerekir, yatay karşılaştırma yaparken her model için ayrı entegrasyon gerekmez. Aynı iş örnekleri kümesiyle ayrı ayrı çağrı yapmanız, çıktı kalitesini ve kullanımı kaydetmeniz, ardından resmi web sitesindeki "Tüm Modeller Fiyat Karşılaştırma Tablosu" ile resmi fiyatı ve bu sitenin fiyatını kalem kalem karşılaştırmanız önerilir.

Sunucu tarafındaki API Key güvenli şekilde nasıl saklanır?

API Key yalnızca sunucu tarafında saklanmalı, istek başlığı aracılığıyla Bearer Token olarak taşınmalı, ön uca veya istemci koduna yazılmamalıdır. Platform istek ve yanıt verileri baştan sona HTTPS ile şifreli olarak iletilir; kurumsal düzeyde yetki yönetimi ve denetim günlükleri sunulur, çağrı kayıtları izlenebilir.

Yüksek eşzamanlılık senaryolarında çağrı kararlılığı ve düşük gecikme nasıl sağlanır?

Platform, İç Moğolistan Helingeer, Sincan Hami, Ningxia Zhongwei gibi yerlerdeki hesaplama merkezlerine dayanarak kendi geliştirdiği zamanlama algoritmasıyla bölgeler arası akıllı yönlendirme ve dinamik yük dengeleme yapar; tek düğüm arızasında otomatik geçiş yapılır; kilit şehirlerdeki kullanıcılar milisaniye düzeyinde gecikme elde edebilir, hizmet kullanılabilirliği taahhüdü %99.9'dur. İstemci tarafında ayrıca geri çekilmeli yeniden deneme ve çok modelli düşürme uygulamanız önerilir.

Çağrı hacmi, maliyet ve anormallikler nasıl izlenir?

Platform, tek tip hesap ve tek bir faturalandırma sistemi sunar; kullanım şeffaftır, bakiye gerçek zamanlı olarak hesaba geçer ve tüketim ayrıntıları istenildiği zaman görüntülenebilir; ayrıca API çağrıları için denetim günlüğü işlevi sunulur, çağrı kayıtları izlenebilir. Kurumsal kullanıcılar daha katı uyumluluk gereksinimleri (yetki yönetimi, denetim günlükleri vb.) için müşteri hizmetleriyle iletişime geçerek ticari görüşme yapabilir.