{"id":"f0d04bf4-845f-4ca2-ae69-c0fa51cc2198","shortId":"YeEcBs","kind":"skill","title":"acedatacloud-api","tagline":"Guide for using AceDataCloud APIs. Use when authenticating, making API calls, managing credentials, understanding billing, or integrating AceDataCloud services into applications. Covers setup, authentication, request patterns, error handling, and SDK integration.","description":"# AceDataCloud API Usage Guide\n\nComplete guide for using AceDataCloud's AI-powered data services API.\n\n## Getting Started\n\n### 1. Create an Account\n\nRegister at [platform.acedata.cloud](https://platform.acedata.cloud).\n\n### 2. Subscribe to a Service\n\nBrowse available services and click **Get** to subscribe. Most services include free quota.\n\n### 3. Create API Credentials\n\nGo to your service's **Credentials** page and create an API Token.\n\n> **Full details:** See [authentication](../_shared/authentication.md) for token types and usage.\n\n## SDK Integration (OpenAI-Compatible)\n\nFor chat completion services, use the standard OpenAI SDK:\n\n```python\nfrom openai import OpenAI\n\nclient = OpenAI(\n    api_key=\"YOUR_API_TOKEN\",\n    base_url=\"https://api.acedata.cloud/v1\"\n)\n\nresponse = client.chat.completions.create(\n    model=\"claude-sonnet-4-20250514\",\n    messages=[{\"role\": \"user\", \"content\": \"Hello!\"}]\n)\n```\n\n```javascript\nimport OpenAI from \"openai\";\n\nconst client = new OpenAI({\n  apiKey: \"YOUR_API_TOKEN\",\n  baseURL: \"https://api.acedata.cloud/v1\"\n});\n\nconst response = await client.chat.completions.create({\n  model: \"gpt-4.1\",\n  messages: [{ role: \"user\", content: \"Hello!\" }]\n});\n```\n\n## Request Patterns\n\n### Synchronous APIs\n\nSome APIs return results immediately (e.g., face transform, search):\n\n```bash\ncurl -X POST https://api.acedata.cloud/face/analyze \\\n  -H \"Authorization: Bearer $TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"image_url\": \"https://example.com/photo.jpg\"}'\n```\n\n### Async Task APIs\n\nMost generation APIs (images, video, music) are asynchronous.\n\n> **Full details:** See [async task polling](../_shared/async-tasks.md) for the submit-and-poll pattern.\n\n## Error Handling\n\n| HTTP Code | Meaning | Action |\n|-----------|---------|--------|\n| 400 | Bad request | Check request parameters |\n| 401 | Unauthorized | Check API token |\n| 403 | Forbidden | Content filtered or insufficient permissions |\n| 429 | Rate limited | Wait and retry with backoff |\n| 500 | Server error | Retry or contact support |\n\nError response format:\n\n```json\n{\n  \"error\": {\n    \"code\": \"token_mismatched\",\n    \"message\": \"Invalid or expired token\"\n  }\n}\n```\n\n## Billing\n\n- Each API call deducts from your **subscription balance** (remaining_amount)\n- Cost varies by service, model, and usage (tokens, requests, data size)\n- Check balance at [platform.acedata.cloud](https://platform.acedata.cloud)\n- Most services offer free trial quota\n\n## Service Categories\n\n| Category | Services | Base Path |\n|----------|----------|-----------|\n| **AI Chat** | GPT, Claude, Gemini, Kimi, Grok | `/v1/chat/completions` |\n| **Image Gen** | Midjourney, Flux, Seedream, NanoBanana | `/midjourney/*`, `/flux/*`, etc. |\n| **Video Gen** | Luma, Sora, Veo, Kling, Hailuo, Seedance, Wan | `/luma/*`, `/sora/*`, etc. |\n| **Music Gen** | Suno, Producer, Fish Audio | `/suno/*`, `/producer/*`, `/fish/*` |\n| **Search** | Google Search (web/images/news/maps) | `/serp/*` |\n| **Face** | Analyze, beautify, swap, cartoon, age | `/face/*` |\n| **Utility** | Short URL, QR Art, Headshots | `/short-url`, `/qrart/*`, `/headshots/*` |\n\n## Gotchas\n\n- Tokens are **service-scoped** by default — create a global token if you need cross-service access\n- Async APIs return a `task_id` — always use `callback_url` to get the task_id immediately, then poll for results\n- Avoid `wait: true` — it blocks for the full generation duration and will time out for video/music tasks\n- Rate limits vary by service tier — upgrade your plan if hitting limits\n- All timestamps are in UTC\n\n> **MCP:** See [MCP servers](../_shared/mcp-servers.md) for tool-use integration with AI agents.","tags":["acedatacloud","api","skills","acedata-cloud","agent-skills","agentskills","ai-image","ai-music","ai-tools","ai-video","claude-code","cursor"],"capabilities":["skill","source-acedatacloud","skill-acedatacloud-api","topic-acedata-cloud","topic-agent-skills","topic-agentskills","topic-ai-image","topic-ai-music","topic-ai-tools","topic-ai-video","topic-claude-code","topic-cursor","topic-gemini-cli","topic-github-copilot","topic-mcp"],"categories":["Skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/AceDataCloud/Skills/acedatacloud-api","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add AceDataCloud/Skills","source_repo":"https://github.com/AceDataCloud/Skills","install_from":"skills.sh"}},"qualityScore":"0.453","qualityRationale":"deterministic score 0.45 from registry signals: · indexed on github topic:agent-skills · 7 github stars · SKILL.md body (3,651 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-18T19:14:01.444Z","embedding":null,"createdAt":"2026-05-18T13:21:31.669Z","updatedAt":"2026-05-18T19:14:01.444Z","lastSeenAt":"2026-05-18T19:14:01.444Z","tsv":"'-20250514':143 '-4.1':172 '/_shared/async-tasks.md':230 '/_shared/authentication.md':99 '/_shared/mcp-servers.md':465 '/face':378 '/face/analyze':197 '/fish':366 '/flux':344 '/headshots':387 '/luma':355 '/midjourney':343 '/photo.jpg':212 '/producer':365 '/qrart':386 '/serp':371 '/short-url':385 '/sora':356 '/suno':364 '/v1':135,165 '/v1/chat/completions':336 '1':53 '2':61 '3':79 '4':142 '400':244 '401':250 '403':255 '429':262 '500':270 'access':406 'account':56 'acedatacloud':2,7,21,35,43 'acedatacloud-api':1 'action':243 'age':377 'agent':473 'ai':46,329,472 'ai-pow':45 'alway':413 'amount':300 'analyz':373 'api':3,8,13,36,50,81,93,126,129,160,181,183,215,218,253,292,408 'api.acedata.cloud':134,164,196 'api.acedata.cloud/face/analyze':195 'api.acedata.cloud/v1':133,163 'apikey':158 'applic':24 'application/json':206 'art':383 'async':213,227,407 'asynchron':223 'audio':363 'authent':11,27,98 'author':199 'avail':67 'avoid':427 'await':168 'backoff':269 'bad':245 'balanc':298,313 'base':131,327 'baseurl':162 'bash':191 'bearer':200 'beautifi':374 'bill':18,290 'block':431 'brows':66 'call':14,293 'callback':415 'cartoon':376 'categori':324,325 'chat':111,330 'check':247,252,312 'claud':140,332 'claude-sonnet':139 'click':70 'client':124,155 'client.chat.completions.create':137,169 'code':241,282 'compat':109 'complet':39,112 'const':154,166 'contact':275 'content':147,176,204,257 'content-typ':203 'cost':301 'cover':25 'creat':54,80,91,396 'credenti':16,82,88 'cross':404 'cross-servic':403 'curl':192 'd':207 'data':48,310 'deduct':294 'default':395 'detail':96,225 'durat':436 'e.g':187 'error':30,238,272,277,281 'etc':345,357 'example.com':211 'example.com/photo.jpg':210 'expir':288 'face':188,372 'filter':258 'fish':362 'flux':340 'forbidden':256 'format':279 'free':77,320 'full':95,224,434 'gemini':333 'gen':338,347,359 'generat':217,435 'get':51,71,418 'global':398 'go':83 'googl':368 'gotcha':388 'gpt':171,331 'grok':335 'guid':4,38,40 'h':198,202 'hailuo':352 'handl':31,239 'headshot':384 'hello':148,177 'hit':454 'http':240 'id':412,421 'imag':208,219,337 'immedi':186,422 'import':122,150 'includ':76 'insuffici':260 'integr':20,34,106,470 'invalid':286 'javascript':149 'json':280 'key':127 'kimi':334 'kling':351 'limit':264,445,455 'luma':348 'make':12 'manag':15 'mcp':461,463 'mean':242 'messag':144,173,285 'midjourney':339 'mismatch':284 'model':138,170,305 'music':221,358 'nanobanana':342 'need':402 'new':156 'offer':319 'openai':108,117,121,123,125,151,153,157 'openai-compat':107 'page':89 'paramet':249 'path':328 'pattern':29,179,237 'permiss':261 'plan':452 'platform.acedata.cloud':59,60,315,316 'poll':229,236,424 'post':194 'power':47 'produc':361 'python':119 'qr':382 'quota':78,322 'rate':263,444 'regist':57 'remain':299 'request':28,178,246,248,309 'respons':136,167,278 'result':185,426 'retri':267,273 'return':184,409 'role':145,174 'scope':393 'sdk':33,105,118 'search':190,367,369 'see':97,226,462 'seedanc':353 'seedream':341 'server':271,464 'servic':22,49,65,68,75,86,113,304,318,323,326,392,405,448 'service-scop':391 'setup':26 'short':380 'size':311 'skill' 'skill-acedatacloud-api' 'sonnet':141 'sora':349 'source-acedatacloud' 'standard':116 'start':52 'submit':234 'submit-and-pol':233 'subscrib':62,73 'subscript':297 'suno':360 'support':276 'swap':375 'synchron':180 'task':214,228,411,420,443 'tier':449 'time':439 'timestamp':457 'token':94,101,130,161,201,254,283,289,308,389,399 'tool':468 'tool-us':467 'topic-acedata-cloud' 'topic-agent-skills' 'topic-agentskills' 'topic-ai-image' 'topic-ai-music' 'topic-ai-tools' 'topic-ai-video' 'topic-claude-code' 'topic-cursor' 'topic-gemini-cli' 'topic-github-copilot' 'topic-mcp' 'transform':189 'trial':321 'true':429 'type':102,205 'unauthor':251 'understand':17 'upgrad':450 'url':132,209,381,416 'usag':37,104,307 'use':6,9,42,114,414,469 'user':146,175 'utc':460 'util':379 'vari':302,446 'veo':350 'video':220,346 'video/music':442 'wait':265,428 'wan':354 'web/images/news/maps':370 'x':193","prices":[{"id":"62c7846a-fd94-43aa-8022-f486ff6b81db","listingId":"f0d04bf4-845f-4ca2-ae69-c0fa51cc2198","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"AceDataCloud","category":"Skills","install_from":"skills.sh"},"createdAt":"2026-05-18T13:21:31.669Z"}],"sources":[{"listingId":"f0d04bf4-845f-4ca2-ae69-c0fa51cc2198","source":"github","sourceId":"AceDataCloud/Skills/acedatacloud-api","sourceUrl":"https://github.com/AceDataCloud/Skills/tree/main/skills/acedatacloud-api","isPrimary":false,"firstSeenAt":"2026-05-18T13:21:31.669Z","lastSeenAt":"2026-05-18T19:14:01.444Z"}],"details":{"listingId":"f0d04bf4-845f-4ca2-ae69-c0fa51cc2198","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"AceDataCloud","slug":"acedatacloud-api","github":{"repo":"AceDataCloud/Skills","stars":7,"topics":["acedata-cloud","agent-skills","agentskills","ai-image","ai-music","ai-tools","ai-video","claude-code","cursor","gemini-cli","github-copilot","mcp","npm","openai-codex","roo-code"],"license":"other","html_url":"https://github.com/AceDataCloud/Skills","pushed_at":"2026-05-18T07:35:03Z","description":"Agent Skills for AceDataCloud AI services — music, image, video generation, web search, and more. Compatible with Claude Code, GitHub Copilot, Gemini CLI, and all agentskills.io-compatible agents.","skill_md_sha":"2dcab0a8e3a1636b42c5ddf373661d979bd96d27","skill_md_path":"skills/acedatacloud-api/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/AceDataCloud/Skills/tree/main/skills/acedatacloud-api"},"layout":"multi","source":"github","category":"Skills","frontmatter":{"name":"acedatacloud-api","license":"Apache-2.0","description":"Guide for using AceDataCloud APIs. Use when authenticating, making API calls, managing credentials, understanding billing, or integrating AceDataCloud services into applications. Covers setup, authentication, request patterns, error handling, and SDK integration.","compatibility":"Requires an AceDataCloud account at platform.acedata.cloud."},"skills_sh_url":"https://skills.sh/AceDataCloud/Skills/acedatacloud-api"},"updatedAt":"2026-05-18T19:14:01.444Z"}}