AceDataCloud API Usage Guide

Complete guide for using AceDataCloud's AI-powered data services API.

Getting Started

1. Create an Account

Register at platform.acedata.cloud.

2. Subscribe to a Service

Browse available services and click Get to subscribe. Most services include free quota.

3. Create API Credentials

Go to your service's Credentials page and create an API Token.

Authentication

All APIs use Bearer token authentication:

curl -X POST https://api.acedata.cloud/<endpoint> \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ ... }'

Token Types

Base URL

https://api.acedata.cloud

SDK Integration (OpenAI-Compatible)

For chat completion services, use the standard 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!" }]
});

Common Request Patterns

Synchronous APIs

Some APIs return results immediately (e.g., face transform, search):

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"}'

Async Task APIs

Most generation APIs (images, video, music) are asynchronous:

Step 1: Submit request

POST /suno/audios
{"prompt": "a jazz song", "wait": false}
→ {"task_id": "abc123"}

Step 2: Poll for results

POST /suno/tasks
{"task_id": "abc123"}
→ {"state": "succeeded", "data": [...]}

Shortcut: Pass "wait": true to block until completion (simpler but longer timeout).

Error Handling

Error response format:

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

Billing

• Each API call deducts from your subscription balance (remaining_amount)
• Cost varies by service, model, and usage (tokens, requests, data size)
• Check balance at platform.acedata.cloud
• Most services offer free trial quota

Service Categories

Gotchas

• Tokens are service-scoped by default — create a global token if you need cross-service access
• Async APIs return a task_id — you must poll to get the result
• wait: true is convenient but has a timeout limit (typically 60–120s)
• Rate limits vary by service tier — upgrade your plan if hitting limits
• All timestamps are in UTC