SiCore TokenWorks

API ドキュメント

詳細な導入ガイドと API リファレンスで、SiCore TokenWorks AI API サービスを迅速に統合できます

1クイックスタート

SiCore TokenWorks API の利用はわずか3ステップです：

  1. SiCore TokenWorks アカウントを登録し、コンソールにログインします
  2. コンソールで API Key を作成します
  3. API Key を使用して当社のインターフェースを呼び出します

Tip: 新規ユーザーは登録後、無料体験枠が付与され、クレジットカードの登録なしですぐに利用を開始できます。

2インターフェースアドレス

API のベースアドレスは以下の通りです。すべてのリクエストは HTTPS プロトコルを使用します：

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

チャット補完インターフェース：

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

Note: このインターフェースは OpenAI の Chat Completions インターフェース形式と完全に互換性があり、OpenAI の SDK を直接使用して呼び出すことができます。

3認証方式

SiCore TokenWorks は Bearer Token を使用して API 認証を行います。リクエストヘッダーに API Key を含めてください：

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

コンソールの「API Keys」ページでキーを作成・管理できます。API Key は適切に保管し、公開コードリポジトリやクライアントコードで公開しないでください。

4サポートされているモデルリスト

モデル IDモデル名プロバイダー
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

さらに多くのモデルを継続的に追加しています。更新のお知らせにご注目ください。

5サンプルコード

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

6エラーコードの説明

API リクエストが失敗した場合、対応する HTTP ステータスコードとエラー情報が返されます。形式は以下の通りです：

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

接続に関するよくある質問

API Key、モデル切り替え、接続言語に関するよくある質問

1つのAPI Keyで全てのモデルを呼び出せますか？

はい。これがSiCore TokenWorksの核心的な特長です——開発者は一度接続するだけで、プラットフォーム上の全てのモデルを呼び出せ、各プロバイダーごとに個別にアカウントを申請したりKeyを管理する必要はありません。

モデルを切り替えるにはコードを変更する必要がありますか？

ロジックコードを変更する必要はなく、モデルIDという1つのパラメータを変更するだけで、国産モデルと海外モデル間を切り替えられます。

どのプログラミング言語に対応していますか？

cURL、Python、Node.jsなどの主要な接続例を提供しており、HTTPリクエストをサポートする任意の言語およびOpenAI公式SDKと互換性があります。

API はどのように認証されますか？

認証方式は Bearer Token で、リクエストヘッダーに API Key を含めるだけです。インターフェースは OpenAI の Chat Completions 形式と完全に互換性があり、OpenAI 公式 SDK をそのまま使用して呼び出せるため、追加の適合は不要です。

既成の SDK やコード例はありますか？

あります。プラットフォームは cURL、Python、Node.js など主要な接続例を提供しており、開発者は自分の言語に合わせて選択するだけで迅速に統合できます。

モデルは継続的に追加されますか？新しいモデルにはコード変更が必要ですか？

追加されます。プラットフォームは新しい国産および国際的な主流モデルを継続的に接続しており、接続方法と課金体系は一貫しているため、新しいモデルがリリースされた後もコードを変更せずに直接選択できます。

大規模モデル API のキャッシュ機構はどう使いますか？どのような場面でヒットしますか？

プラットフォームは同一の prompt をユーザー間で共有キャッシュし、ヒット後は価格がさらに 90% 以上下がり、キャッシュヒット価格は最低 ¥0.010 / 百万 Token で、ヒット部分はキャッシュ価格で課金されます。複数のユーザーが同じプレフィックス prompt を繰り返し使用する場面に適しており、例えば固定のシステムプロンプトや共通知識のプレフィックスなどです——変わらない部分を前に置くほど、ヒット率が高くなります。

API 呼び出しが失敗またはタイムアウトした場合、自動リトライとフォールバックはどう行いますか？

一般的な方法は、タイムアウトやリトライ可能なエラーに対して指数バックオフでリトライし、最大リトライ回数を設定することです。それでも失敗する場合は予備モデルへフォールバックします。プラットフォームではモデル切り替えはモデル ID を変更するだけで、コードの変更は不要で、フォールバック先を別のモデル ID として記述するだけです。プラットフォーム側にはマルチノード冗長化とクロスリージョンのインテリジェントルーティングもあり、単一ノードの異常時は自動で切り替わります。

異なるモデルの効果とコストをどう比較しますか？

1 つの API Key で全モデルを呼び出せ、モデル切り替えはモデル ID を変更するだけでコードの変更は不要なため、横断比較の際にモデルごとに個別接続する必要はありません。同じ業務サンプル群をそれぞれのモデルで呼び出し、出力品質と使用量を記録したうえで、公式サイトの「全モデル価格比較表」と照らし合わせて公式価格と当サイト価格を項目ごとに比較することをおすすめします。

サーバー側の API Key はどう安全に保管しますか？

API Key はサーバー側のみで保存し、リクエストヘッダーで Bearer Token 方式により付与し、フロントエンドやクライアントコードに書き込まないことをおすすめします。プラットフォームのリクエストとレスポンスデータは全行程 HTTPS で暗号化传输され、エンタープライズ級の権限管理と監査ログを提供し、呼び出し記録は追跡可能です。

高並列の場面で呼び出しの安定性と低遅延をどう確保しますか？

プラットフォームは内モンゴル和林格尔、新疆哈密、寧夏中衛などの算力センターを基盤とし、自社開発のスケジューリングアルゴリズムによるクロスリージョンのインテリジェントルーティングと動的負荷分散を行い、単一ノードの異常時は自動で切り替わります。主要都市のユーザーはミリ秒級の遅延を得られ、サービス可用性は 99.9% を約束します。クライアント側ではさらにバックオフリトライとマルチモデルフォールバックを組み合わせることをおすすめします。

呼び出し量、費用、異常をどう監視しますか？

プラットフォームは統一アカウントと一元的な課金体系を提供し、使用量は透明で、残高はリアルタイムに反映され、消費明細をいつでも確認できます。同時に API 呼び出しの監査ログ機能を提供し、呼び出し記録は追跡可能です。エンタープライズユーザーがより厳格なコンプライアンス要件（権限管理、監査ログなど）を必要とする場合は、カスタマーサービスに連絡して商談窓口と接続できます。