Skip to main content
Ace Data Cloud は TypeScript / Python / Go の三つの言語の公式クライアント SDK を提供し、api.acedata.cloud 上のチャット完了、画像、動画、音楽、検索、x402 などの機能を強い型のメソッドにラップし、HTTP、SSE、タスクポーリング、エラーハンドリング、リトライバックオフの手作業を省きます。 本章は実際の接続順に整理されています:まずコンソールで API トークンを取得し、次に言語を選んで対応する章を見て、最後にタスクポーリング、ストリーミングレスポンス、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 によって改ざんされていないことを証明しています。

推奨読書順

  1. TypeScript SDK 接続ガイド —— npm install 後に最初のセクションで実行できるコード。
  2. Python SDK 接続ガイド —— 同期、非同期、ストリーミングの三つの使用法。
  3. Go SDK 接続ガイド —— Go スタイルの context.Context とチャネルストリーミング。
  4. SDK タスクポーリングとストリーミング応答 —— TaskHandle 単位の違い、SSE 実装の詳細、リトライバックオフ。
  5. SDK + X402 支払いフック —— トークンなしで、呼び出しに基づいてブロックチェーン決済。

残高を確認する方法

Ace Data Cloud コンソール - アプリケーションリスト を通じて、現在のアカウントの残高を確認できます。 Ace Data Cloud コンソール - 使用履歴 を通じて、すべての使用履歴と請求の詳細を確認できます。

さらに詳しく