acedatacloud-api

AceDataCloud API 利用ガイド

AceDataCloud の AI 搭載データサービス API の完全ガイドです。

はじめに

1. アカウントを作成する

platform.acedata.cloud で登録します。

2. サービスを申し込む

利用可能なサービスを確認し、Get をクリックして申し込みます。ほとんどのサービスには無料枠があります。

3. API 認証情報を作成する

サービスの Credentials ページに移動し、API トークンを作成します。

詳細情報： トークンの種類と使い方については、認証をご覧ください。

SDK との連携（OpenAI 互換）

チャット補完サービスには、標準の OpenAI SDK を使用します。

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_TOKEN",
    base_url="https://api.acedata.cloud/v1"
)

response = client.chat.completions.create(
    model="claude-sonnet-4-20250514",
    messages=[{"role": "user", "content": "Hello!"}]
)

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "YOUR_API_TOKEN",
  baseURL: "https://api.acedata.cloud/v1"
});

const response = await client.chat.completions.create({
  model: "gpt-4.1",
  messages: [{ role: "user", content: "Hello!" }]
});

リクエストのパターン

同期 API

一部の API は結果をすぐに返します（顔の変換、検索など）。

curl -X POST https://api.acedata.cloud/face/analyze \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"image_url": "https://example.com/photo.jpg"}'

非同期タスク API

ほとんどの生成 API（画像、動画、音楽）は非同期です。

詳細情報： 送信してポーリングするパターンについては、非同期タスクのポーリングをご覧ください。

エラー処理

HTTP コード	意味	対応
400	不正なリクエスト	リクエストパラメーターを確認してください
401	認証されていません	API トークンを確認してください
403	アクセスが禁止されています	コンテンツがフィルタリングされたか、権限が不足しています
429	レート制限に達しました	待機してから、バックオフを入れて再試行してください
500	サーバーエラー	再試行するか、サポートにお問い合わせください

エラーレスポンスの形式：

{
  "error": {
    "code": "token_mismatched",
    "message": "Invalid or expired token"
  }
}

料金

• API 呼び出しごとに、サブスクリプション残高（remaining_amount）から差し引かれます
• 料金はサービス、モデル、使用量（トークン、リクエスト、データサイズ）によって異なります
• platform.acedata.cloud で残高を確認できます
• ほとんどのサービスには無料トライアル枠があります

サービスカテゴリ

カテゴリ	サービス	ベースパス
AI チャット	GPT, Claude, Gemini, Kimi, Grok	/v1/chat/completions
画像生成	Flux, Seedream, NanoBanana	/flux/*, /seedream/*, など
動画生成	Luma, Sora, Veo, Kling, Hailuo, Seedance, Wan	/luma/*, /sora/*, など
音楽生成	Suno, Producer, Fish Audio	/suno/*, /producer/*, /fish/*
検索	Google Search（ウェブ／画像／ニュース／地図）	/serp/*
顔	分析、美化、入れ替え、漫画化、年齢変更	/face/*
ユーティリティ	短縮 URL、QR アート、ヘッドショット	/short-url, /qrart/*, /headshots/*

注意事項

• トークンはデフォルトでサービス単位です。複数のサービスでアクセスする必要がある場合は、グローバルトークンを作成してください
• 非同期 API は task_id を返します。すぐに task_id を取得するには、必ず callback_url を使用し、その後、結果をポーリングしてください
• wait: true は避けてください。生成が完了するまで処理をブロックし、動画や音楽のタスクではタイムアウトします
• レート制限はサービスのプランによって異なります。制限に達した場合は、プランをアップグレードしてください
• すべてのタイムスタンプは UTC です

MCP： AI エージェントと連携してツールを使用する方法については、MCP サーバーをご覧ください。