Acedatacloud Api

Guide for using AceDataCloud APIs. Use when authenticating, making API calls, managing credentials, understanding billing, or integrating AceDataCloud servic...

Security Scan

This is an instruction-only usage guide for AceDataCloud APIs; its requirements and instructions are consistent with that purpose and it does not request or install anything unexpected.

Purpose & Capability

The name/description state this is an API usage guide and the SKILL.md contains curl examples, authentication patterns, SDK usage, and billing notes that match that purpose. There are no unrelated required binaries, config paths, or credentials declared.

Instruction Scope

Runtime instructions are limited to example API calls, token-based auth, async task polling patterns, SDK configuration, and error/billing guidance. The guide does not instruct the agent to read arbitrary local files, access unrelated environment variables, or transmit data to endpoints outside api.acedata.cloud / platform.acedata.cloud.

Install Mechanism

No install spec or code files are present (instruction-only). Nothing is downloaded or written to disk by the skill itself, which is low-risk and appropriate for a documentation/guide skill.

Credentials

The SKILL.md shows use of API tokens (Bearer tokens) as expected for an API guide but the skill declares no required environment variables or credentials. There are no requests for unrelated secrets or multiple unrelated credentials.

Persistence & Privilege

Skill is not marked always:true, has no install behavior, and does not request persistent system-level presence. It does not modify other skills or system configs.

Assessment

This skill is just a textual API guide and does not install software or request credentials automatically. Before using it: (1) verify the domain names (platform.acedata.cloud, api.acedata.cloud) are the official service you expect; (2) never paste your API tokens into untrusted places—only provide them to code you control or through secure config mechanisms; (3) when following SDK examples, install libraries from trusted package registries; and (4) if you allow an autonomous agent to use this skill, be mindful that the agent could be prompted to include real tokens in API calls—avoid storing long-lived tokens in the agent or skill configuration unless you trust the agent and organization policies. Overall this guide appears coherent and proportionate to its stated purpose.

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

Type	Format	Scope
Service Token	UUID string	Access to subscribed service only
Global Token	UUID string	Access to all subscribed services

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

HTTP Code	Meaning	Action
400	Bad request	Check request parameters
401	Unauthorized	Check API token
403	Forbidden	Content filtered or insufficient permissions
429	Rate limited	Wait and retry with backoff
500	Server error	Retry or contact support

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

Category	Services	Base Path
AI Chat	GPT, Claude, Gemini, DeepSeek, Grok	/v1/chat/completions
Image Gen	Midjourney, Flux, Seedream, NanoBanana	/midjourney/*, /flux/*, etc.
Video Gen	Luma, Sora, Veo, Kling, Hailuo, Seedance	/luma/*, /sora/*, etc.
Music Gen	Suno, Producer, Fish Audio	/suno/*, /producer/*, /fish/*
Search	Google Search (web/images/news/maps)	/serp/*
Face	Analyze, beautify, swap, cartoon, age	/face/*
Utility	Short URL, QR Art, Headshots	/short-url, /qrart/*, /headshots/*

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