メインコンテンツへスキップ
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(...)。
プログラムの実行結果:
3 言語のレスポンスにはいずれも id、elapsed_ms、usage が含まれており、リクエストの識別、所要時間および使用量の確認に利用できます。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 コンソール - 使用履歴 を通じて、すべての使用履歴と請求の詳細を確認できます。

さらに詳しく