SiCore TokenWorks

Dokumentacja API

Szczegółowy przewodnik integracji i odniesienie do API, które pomogą Ci szybko zintegrować usługę API SiCore TokenWorks AI

1Szybki start

Korzystanie z API SiCore TokenWorks wymaga tylko trzech prostych kroków:

  1. Zarejestruj konto SiCore TokenWorks i zaloguj się do konsoli
  2. Utwórz klucz API w konsoli
  3. Użyj swojego klucza API, aby wywoływać nasze interfejsy

Tip: Nowi użytkownicy otrzymają darmowy limit po rejestracji, bez konieczności podawania karty kredytowej.

2Adres bazowy

Podstawowy adres API znajduje się poniżej, wszystkie żądania używają protokołu HTTPS:

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

Interfejs uzupełniania czatu:

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

Note: Ten interfejs jest w pełni kompatybilny z formatem interfejsu Chat Completions OpenAI, możesz bezpośrednio używać SDK OpenAI do wywołań.

3Metoda uwierzytelniania

SiCore TokenWorks używa tokena Bearer do uwierzytelniania API. Proszę dołączyć swój klucz API w nagłówku żądania:

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

Możesz tworzyć i zarządzać swoimi kluczami na stronie „API Keys” w konsoli. Proszę bezpiecznie przechowywać swój klucz API i nie ujawniać go w publicznych repozytoriach kodu ani w kodzie klienta.

4Lista obsługiwanych modeli

ID modeluNazwa modeluDostawca
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

Więcej modeli jest stale dodawanych, śledź nasze aktualizacje.

5Przykładowy 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);

6Opis kodów błędów

W przypadku niepowodzenia żądania API zwracany jest odpowiedni kod statusu HTTP i komunikat o błędzie, w następującym formacie:

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

Najczęstsze pytania dotyczące integracji

Najczęstsze pytania o API Key, przełączanie modeli i języki integracji

Czy jeden API Key pozwala wywołać wszystkie modele?

Tak. To kluczowa cecha SiCore TokenWorks — wystarczy jedna integracja, aby wywoływać wszystkie modele na platformie, bez konieczności osobnego zakładania kont i zarządzania Key dla każdego dostawcy.

Czy przełączenie modelu wymaga zmiany kodu?

Nie trzeba zmieniać kodu logiki — wystarczy zmienić jeden parametr, model ID, aby przełączać się między modelami krajowymi i zagranicznymi.

Jakie języki programowania są obsługiwane?

Dostępne są przykłady integracji m.in. w cURL, Python i Node.js, kompatybilne z dowolnym językiem obsługującym żądania HTTP oraz oficjalnym SDK OpenAI.

Jak przebiega uwierzytelnianie API?

Uwierzytelnianie odbywa się za pomocą Bearer Token – wystarczy umieścić API Key w nagłówku żądania; interfejs jest w pełni zgodny z formatem Chat Completions OpenAI, więc można go wywoływać bezpośrednio za pomocą oficjalnego SDK OpenAI, bez dodatkowej adaptacji.

Czy są dostępne gotowe SDK lub przykłady kodu?

Tak. Platforma udostępnia przykłady integracji dla popularnych języków, takich jak cURL, Python i Node.js – deweloperzy mogą wybrać swój język i szybko przeprowadzić integrację.

Czy modele będą stale dodawane? Czy nowe modele wymagają zmian w kodzie?

Tak. Platforma stale integruje nowe krajowe i międzynarodowe modele głównego nurtu, a sposób integracji i system rozliczeń pozostają spójne – po premierze nowego modelu można go wybrać bezpośrednio bez zmian w kodzie.

Jak korzystać z mechanizmu buforowania w API dużych modeli? W jakich scenariuszach następuje trafienie w pamięć podręczną?

Platforma stosuje współdzieloną pamięć podręczną dla tego samego promptu między użytkownikami; po trafieniu cena spada o ponad 90%, a minimalna cena trafienia w pamięć podręczną wynosi ¥0.010 / milion Tokenów, przy czym trafiona część jest rozliczana według ceny pamięci podręcznej. Rozwiązanie sprawdza się w scenariuszach, w których wielu użytkowników wielokrotnie używa tego samego prefiksu promptu, na przykład stałych promptów systemowych, prefiksów wspólnej wiedzy itp. — niezmienną część należy umieścić na początku, co zwiększa współczynnik trafień.

Jak wykonać automatyczne ponawianie i degradację, gdy wywołanie API zakończy się niepowodzeniem lub przekroczy limit czasu?

Typowe podejście jest następujące: dla przekroczeń limitu czasu i błędów podlegających ponowieniu stosuje się ponawianie z wykładniczym opóźnieniem oraz ustawia maksymalną liczbę ponowień; jeśli nadal się nie powiedzie, następuje degradacja do modelu zapasowego. Przełączenie modelu na platformie wymaga jedynie zmiany ID modelu, bez zmian w kodzie — wystarczy zapisać cel degradacji jako inne ID modelu. Po stronie platformy dostępna jest również redundancja wielu węzłów i inteligentne trasowanie międzyregionowe; awaria pojedynczego węzła powoduje automatyczne przełączenie.

Jak porównać skuteczność i koszty różnych modeli?

Jeden API Key pozwala wywołać wszystkie modele; przełączenie modelu wymaga jedynie zmiany ID modelu, bez zmian w kodzie, więc przy porównaniach horyzontalnych nie trzeba osobnej integracji dla każdego modelu. Zaleca się wywołanie na tym samym zestawie próbek biznesowych, zapisanie jakości wyników i zużycia, a następnie porównanie pozycja po pozycji ceny oficjalnej z ceną tej witryny na podstawie „Tabeli porównania cen wszystkich modeli” na stronie oficjalnej.

Jak bezpiecznie przechowywać API Key po stronie serwera?

Zaleca się przechowywanie API Key wyłącznie po stronie serwera i przekazywanie go w nagłówku żądania jako Bearer Token; nie należy umieszczać go w kodzie frontendu ani klienta. Żądania i odpowiedzi platformy są w całości przesyłane z szyfrowaniem HTTPS, a platforma zapewnia korporacyjne zarządzanie uprawnieniami i dziennik audytu, dzięki czemu zapisy wywołań są możliwe do prześledzenia.

Jak zapewnić stabilność wywołań i niskie opóźnienia w scenariuszach wysokiej współbieżności?

Platforma opiera się na centrach obliczeniowych w takich lokalizacjach jak Helinger w Mongolii Wewnętrznej, Hami w Sinciangu i Zhongwei w Ningxia, wykorzystując autorski algorytm harmonogramowania do inteligentnego trasowania międzyregionowego i dynamicznego równoważenia obciążenia; awaria pojedynczego węzła powoduje automatyczne przełączenie. Użytkownicy w kluczowych miastach mogą uzyskać opóźnienia rzędu milisekund, a deklarowana dostępność usługi wynosi 99.9%. Zaleca się dodatkowo po stronie klienta zastosowanie ponowień z opóźnieniem i degradacji wielu modeli.

Jak monitorować liczbę wywołań, koszty i anomalie?

Platforma oferuje jednolite konto i jeden system rozliczeń, przejrzyste zużycie, saldo księgowane w czasie rzeczywistym oraz możliwość sprawdzenia szczegółów zużycia w dowolnym momencie; zapewnia również funkcję dziennika audytu wywołań API, dzięki czemu zapisy wywołań są możliwe do prześledzenia. Użytkownicy korporacyjni, którzy potrzebują bardziej rygorystycznych wymagań zgodności (zarządzanie uprawnieniami, dziennik audytu itp.), mogą skontaktować się z obsługą klienta w celu ustalenia współpracy biznesowej.