Skip to main content
アカウントトークン(Account Token、旧称 Platform Token) は、開発者がプログラムを通じて AceDataCloud プラットフォームリソース(サービス申請、API 認証情報、注文、呼び出し履歴、残高、ファイルなど)を管理するための「アカウントレベルのキー」です。その役割はフロントエンドでログインした後のユーザー Token に似ており、デフォルトでは有効期限がありません。通常ユーザーは自分のトークンのみ管理でき、スーパー管理者は権限に応じて他のアカウントのトークンを管理できます。 アカウントトークンは、所属アカウントの現在の権限でプラットフォームインターフェースにアクセスします。基本権限、直接付与された権限、および所属ユーザーグループの権限が統合して有効になります。グループへの追加または削除後、次回のリクエストから新しい権限に基づいて判定されます。具体的な申請、注文などのリソースへのアクセスには、引き続き帰属チェックが必要です。アカウントトークンはデフォルトで期限切れになりません。信頼できる環境でのみ使用し、適切に保管してください。
ℹ️ 本インターフェースは AceDataCloud プラットフォーム管理 API に属し、統一プレフィックスは https://platform.acedata.cloud/api/v1/ です。完全なインターフェースインデックスはAceDataCloud プラットフォームドキュメント一覧の取得をご覧ください。

アカウントトークン vs API 認証情報

初心者が最も混同しやすい2種類のキーです。まず明確に区別してください。 GPT-4.1 を少し呼び出したいだけなら、必要なのは API 認証情報 であり、アカウントトークンではありません。 自動化スクリプトでチャージを管理する、毎月の請求書を確認する、チームメンバーに認証情報を一括配布する場合にのみ、アカウントトークンを使用します。

コンソールでワンクリック作成(推奨)

  1. https://platform.acedata.cloud にログインします。
  2. サイドバー →「開発者」→「Account Token」に移動します。
  3. 右上の「作成」ボタンをクリックすると、すぐに platform-v1-... トークンが1つ取得できます。コピーボタンをクリックしてパスワードマネージャーに保存してください。
Account Token コンソール
⚠️ 現在、作成・一覧・詳細のレスポンスはいずれもトークンの平文を返します。レスポンス全体をシークレットとして扱い、ログ、分析プラットフォーム、またはフロントエンドの永続ストレージに書き込まないでください。クライアントも、一覧が長期的に平文を返し続けることに依存すべきではありません。

API によるアカウントトークンの作成

インターフェース概要

認証の説明(鶏が先か卵が先かの問題)

最初のトークンはどう取得するのですか?答えはコンソールを使うことです。ブラウザへのログイン後、コンソールが JWT 認証で POST /platform-tokens/ を呼び出し、最初のトークンを発行します。 その後は、既存の任意の platform-v1-... トークンを使ってさらに作成できます。
リクエストヘッダー形式:

リクエスト例

レスポンス(HTTP 201)

フィールドの説明


アカウントトークン一覧の取得

インターフェース概要

必須クエリパラメータ

⚠️ 必ず ?user_id=<your_user_id> を付けてください。理由:一覧インターフェースはページネーション結果に対してオブジェクトごとに権限チェックを行います。user_id を付けない場合、自分に属さない最初のオブジェクトで拒否され、403 permission_denied が返されます。
user_id の取得方法:
  1. ブラウザで https://auth.acedata.cloud/user/profile を開くと、ページ上部に完全な UUID が表示されます。
  2. または、POST /platform-tokens/ の戻り値にある user_id フィールドを直接使用します。

クエリパラメータ

リクエスト例

レスポンス(HTTP 200)

本インターフェースのページネーションレスポンスは count + items を使用します。その他のプラットフォームインターフェースでは異なる構造が使用される場合があります。対応するドキュメントおよび実際のレスポンスを基準にしてください。

アカウントトークンの詳細を取得

返却構造はリスト要素と同一で、HTTP 200 です。

アカウントトークンを削除

  • 成功時はレスポンスボディなしで HTTP 204 No Content を返します。
  • 削除後、このトークンは即座に無効化され、使用中のすべてのサービスはただちに 401 を受け取ります。
  • 再度この id を照会すると 404 が返されます。
⚠️ 削除は元に戻せません。トークン漏洩の疑いがある場合は、先に新しいものを作成し、業務側を切り替えてから、古いものを削除できます。

サポートされていない操作


エラーコード早見表

エラーレスポンスの統一形式:
トラブルシューティング時に trace_id をカスタマーサービスへ提供するか、チケットに記載すると、ログを迅速に特定できます。

完全なコード例

Python

Node.js


その他のプラットフォーム API で使用

platform-v1-... を直接 Authorization: Bearer ... ヘッダーに入れることで、認証が必要な任意のプラットフォームインターフェースを呼び出せます:
https://api.acedata.cloud/** の業務インターフェース(OpenAI、Midjourney、Suno、Veo など)で使用される 32 桁の16進数 API 認証情報とは完全に異なります。混用しないでください——アカウントトークンを業務インターフェースに記載すると 401 になり、逆も同様です。

関連インターフェース