api.acedata.cloud 上のチャット完了、画像、動画、音楽、検索、x402 などの機能を強い型のメソッドにラップし、HTTP、SSE、タスクポーリング、エラーハンドリング、リトライバックオフの手作業を省きます。
本章は実際の接続順に整理されています:まずコンソールで API トークンを取得し、次に言語を選んで対応する章を見て、最後にタスクポーリング、ストリーミングレスポンス、X402 のオンチェーン支払いの高度な使い方を見ます。
リポジトリとパッケージ
- SDK ソースコード(モノレポ):https://github.com/AceDataCloud/SDK
- TypeScript:
@acedatacloud/sdk - Python:
acedatacloud - Go:
github.com/AceDataCloud/SDK/go - X402 クライアント(TypeScript):
@acedatacloud/x402-client - X402 クライアント(Python):
acedatacloud-x402
三言語能力マトリックス
Go SDK のマルチメディアリソースとタスクポーリングは現在 alpha 段階(擬似バージョンv0.0.0-20260505072132-4a3d921f9bb4)であり、安定した機能はchat.completionsです。マルチメディアシーンでは TypeScript または Python を優先してください。
SDK / MCP / ネイティブ HTTP / X402 の使用時期
SDK と X402 は相互排他的ではありません:SDK は「トークンパス」と「
paymentHandler パス」の両方をサポートしています。詳細は SDK + X402 支払いフック を参照してください。
API トークンの申請
SDK を使用するには、まず Ace Data Cloud コンソール - アプリケーションリスト で API トークンを申請してください:
まだログインまたは登録していない場合は、自動的にログインページにリダイレクトされ、登録とログインを促されます。ログインまたは登録後、現在のページに自動的に戻ります。
初回申請時には無料のクレジットが付与され、Ace Data Cloud が提供するさまざまな AI サービスを無料で体験できます。
取得したトークンをコピーし、以下では統一して {token} と記載します。
統一環境変数
三つの言語の SDK は同じ環境変数ACEDATACLOUD_API_TOKEN を自動的に読み取ります。シェルで export することをお勧めし、SDK が自動的に取得できるようにします:
- TypeScript:
new AceDataCloud({ apiToken: '{token}' }) - Python:
AceDataCloud(api_token="{token}") - Go:
adc.NewClient(adc.WithAPIToken("{token}"))
注意:AceDataCloud プロジェクトリポジトリでは慣習的にACEDATACLOUD_API_KEY(.env/ CI で)とされていますが、これらの三つの SDK はACEDATACLOUD_API_TOKENのみを認識します。環境にACEDATACLOUD_API_KEYしかない場合は、構築時に明示的に渡してください。
30 秒で始める三例
以下の三つのコードは同じことを行います:gpt-4o-mini を呼び出し、正確に ADC_*_OK と返信させます。各セクションには実際の実行結果が付いており、自分のトークンを使って再現できます。
TypeScript
SDK は現在、レスポンスをプログラムの実行結果:Record<string, unknown>として宣言しており、実行時には通常の JSON オブジェクトで、フィールドに直接アクセスできます。厳密な TS プロジェクトで型エラーが発生した場合は、一時的にas anyを使用するか、SDK タスクポーリングとストリーミングレスポンス を参照して型付きラッパーをカスタマイズしてください。
Python
Python SDK 現在返すのはプログラムの実行結果:dictなので、res["id"]を使います。これはopenai-pythonとは異なり、移行時に注意が必要です。
Go
Go SDK の応答はすべてプログラムの実行結果:map[string]anyで、強い型の struct はなく、型アサーションを自分で行う必要があります。すべてのリソースアクセスはメソッドチェーンです:client.OpenAI().Chat().Completions().Create(...)。
id、elapsed_ms、usage の出所は一致しています:PlatformGateway 認証 → 対象 OpenAI 互換 API → 課金記録の書き込み。content フィールドはモデルの実際の出力で、固定識別子 ADC_*_OK を使用して、応答が SDK によって改ざんされていないことを証明しています。
推奨読書順
- TypeScript SDK 接続ガイド ——
npm install後に最初のセクションで実行できるコード。 - Python SDK 接続ガイド —— 同期、非同期、ストリーミングの三つの使用法。
- Go SDK 接続ガイド —— Go スタイルの
context.Contextとチャネルストリーミング。 - SDK タスクポーリングとストリーミング応答 —— TaskHandle 単位の違い、SSE 実装の詳細、リトライバックオフ。
- SDK + X402 支払いフック —— トークンなしで、呼び出しに基づいてブロックチェーン決済。
残高を確認する方法
Ace Data Cloud コンソール - アプリケーションリスト を通じて、現在のアカウントの残高を確認できます。 Ace Data Cloud コンソール - 使用履歴 を通じて、すべての使用履歴と請求の詳細を確認できます。さらに詳しく
- 📦 SDK monorepo ソースコード
- 🔌 X402 統合ガイド
- 🛠 MCP サーバーのチュートリアル
- 📊 サービスリストと価格

