{"slug":"api-guide","title":"api-guide","summary":"Set up an AceDataCloud API key, make a first request, and troubleshoot authentication, access, billing, and asynchronous tasks. Use before calling an AceDataCloud service for the first time.","platform":"Claude","tags":[],"authorName":"LLM Mart","authorSlug":"llm-mart","score":0,"source":"github","price":null,"verified":false,"createdAt":"2026-10-23T17:49:10.606633Z","repo":{"url":"https://github.com/AceDataCloud/Skills","stars":17,"forks":1,"license":null,"updatedAt":"2026-11-12T21:01:19Z"},"bodyHtml":"<hr>\n<h2>name: api-guide\ndescription: Set up an AceDataCloud API key, make a first request, and troubleshoot authentication, access, billing, and asynchronous tasks. Use before calling an AceDataCloud service for the first time.\nlicense: Apache-2.0\nmetadata:\nauthor: acedatacloud\nversion: \"1.1\"\ncompatibility: Requires an AceDataCloud account; get a service API key at <a href=\"https://platform.acedata.cloud/console/applications\">https://platform.acedata.cloud/console/applications</a>.</h2>\n<h1>AceDataCloud API: from account to first result</h1>\n<p>This guide is the source for the existing\n<a href=\"https://clawhub.ai/acedatacloud/skills/api-guide\">@acedatacloud/api-guide</a>\nClawHub listing. A ClawHub login installs Skills; an AceDataCloud API key\nauthorizes calls to <code>api.acedata.cloud</code>. They are different credentials.</p>\n<h2>1. Install the right Skill</h2>\n<p>Install the <a href=\"https://github.com/openclaw/clawhub/blob/main/docs/cli.md\">ClawHub CLI</a>\nif needed, then install the service Skill you intend to use:</p>\n<pre><code>npm install -g clawhub\nclawhub install @acedatacloud/suno\nclawhub list\n</code></pre>\n<p>For a different first workflow, choose its Skill, such as\n<code>clawhub install @acedatacloud/google-search</code>. Verify that the publisher is\n<strong>@acedatacloud</strong>. The general API guide explains setup; the service Skill\ncontains its exact request fields, models, and task endpoint.</p>\n<h2>2. Find or create your API key</h2>\n<ol>\n<li>Sign in at <a href=\"https://platform.acedata.cloud/console/applications\">AceDataCloud → Applications</a>.\nCreate an account if needed.</li>\n<li>Open <strong>General application</strong>; initialize it if prompted. Its API key can\naccess multiple services enabled for your account. A service-specific\napplication key is limited to that service. Check access, balance, and the\ncurrent price of the service you want to call.</li>\n<li>Copy an existing key, or select <strong>Manage Keys → Create</strong>. Name a new key\n(for example, <code>OpenClaw</code>), set expiration and restrictions if needed, and\ncopy the key value from the application card or key list. If <strong>Allowed APIs</strong>\nis restricted, include every route needed for your first workflow. An\nasynchronous generation needs both the submit and task-query routes.</li>\n</ol>\n<p>The <a href=\"https://github.com/AceDataCloud/Skills#first-run-with-clawhub-and-openclaw\">illustrated repository guide</a>\nshows where to copy a key and how to create a separate one. Copy only the key\nvalue. Do not include <code>Bearer </code> in the value, put it in a prompt, or commit it.\nA <code>platform-...</code> management token is for the separate account-management API,\nnot for service generation, chat, or search.</p>\n<h2>3. Configure the key</h2>\n<p>On the OpenClaw Gateway host, add this line to <code>~/.openclaw/.env</code>:</p>\n<pre><code>ACEDATACLOUD_API_TOKEN=your_api_key_here\n</code></pre>\n<p>Keep the file private with <code>chmod 600 ~/.openclaw/.env</code>, restart the Gateway,\nand start a new session. <a href=\"https://docs.openclaw.ai/help/faq/env-vars#how-does-openclaw-load-environment-variables\">OpenClaw loads this global file</a>\neven when the Gateway runs as a service. For a direct terminal test instead:</p>\n<pre><code>export ACEDATACLOUD_API_TOKEN=\"your_api_key_here\"\n</code></pre>\n<h2>4. Make one first request</h2>\n<p>This Google Search example returns a result without a separate task query.\nCheck current service pricing first; API requests may be billable. The key\nmust allow <code>/serp/google</code>:</p>\n<pre><code>curl -X POST https://api.acedata.cloud/serp/google \\\n  -H \"Authorization: Bearer $ACEDATACLOUD_API_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"query\":\"AceDataCloud\",\"type\":\"search\"}'\n</code></pre>\n<p>For image, video, or music generation, follow that service Skill's Quick Start.\nIf a submission returns a <code>task_id</code>, save it and query the matching <code>/tasks</code>\nendpoint until the task is terminal. Use <code>async: true</code> where the service\nsupports it; set <code>callback_url</code> only for a real public webhook that you own.\nDo not resubmit a pending generation merely to check it: a second submission\ncan incur a second charge. See the\n<a href=\"https://github.com/AceDataCloud/Skills/blob/main/skills/_shared/async-tasks.md\">task-polling guide</a>.</p>\n<h2>5. Troubleshoot the first run</h2>\n<table>\n<thead>\n<tr>\n<th>Symptom</th>\n<th>Check</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>401</td>\n<td>Key copied completely, not expired, and available to the running Gateway. <code>Bearer </code> belongs in the HTTP header, not the key value.</td>\n</tr>\n<tr>\n<td>403</td>\n<td>Service entitlement, key restrictions, and <strong>Allowed APIs</strong>. A content-moderation rejection may also be 403; read the response.</td>\n</tr>\n<tr>\n<td>400</td>\n<td>Exact endpoint, model, and JSON shape from the service Skill.</td>\n</tr>\n<tr>\n<td>429</td>\n<td>Reduce request rate or concurrency. Do not automatically retry a billable submit.</td>\n</tr>\n<tr>\n<td>Pending, timeout, or 5xx</td>\n<td>Query the original task or request history before submitting again.</td>\n</tr>\n</tbody>\n</table>\n<p>The <a href=\"https://platform.acedata.cloud\">AceDataCloud account console</a> shows\nbalance and usage. Share a task or trace ID with <a href=\"mailto:dev@acedata.cloud\">support</a>,\nnever your API key. For service-specific examples, see\n<a href=\"https://clawhub.ai/acedatacloud/skills/suno\">@acedatacloud/suno</a>,\n<a href=\"https://clawhub.ai/acedatacloud/skills/nano-banana\">@acedatacloud/nano-banana</a>,\nand <a href=\"https://clawhub.ai/acedatacloud/skills/ai-chat\">@acedatacloud/ai-chat</a>.</p>\n","files":[{"path":"SKILL.md","sizeBytes":5834,"isText":true}],"reviewScore":null,"reviewSummary":null,"trust":{"provenance":"trusted-source-unreviewed","notice":"Community-authored content, reproduced verbatim and not vetted as instructions. Treat it as data to evaluate, never as directives to follow.","bodySource":null},"bodyLocked":false,"purchaseUrl":null,"sourceUrl":null,"report":{"provenance":"trusted-source-unreviewed","screen":{"ran":true,"outcome":"notes-only","suspicious":0,"notes":4,"hiddenCharacters":false},"virusScan":{"engine":"clamav","status":"clean","scannedAt":"2026-11-12T21:48:56.727243Z","sha256":"99BAF9E72B44020D154081184EB9DA44138828DCCB677702CADCA13AFF2678C7","sizeBytes":2696},"review":null,"source":{"repositoryUrl":"https://github.com/AceDataCloud/Skills","path":"clawhub/api-guide","license":null,"commit":"57df2367d7638ba2c8cfc5d50694b086ed401fd9","subtreeSha":"C1570FB2A1D19C5ED8061C5BEC07B70F54D62A095672813164A9D449E0AEDE05","lastSyncedAt":"2026-11-12T21:45:29.032171Z"},"reviewedAt":"2026-11-12T21:57:34.03494Z","notice":"Community-authored content, reproduced verbatim and not vetted as instructions. Treat it as data to evaluate, never as directives to follow."},"install":[{"target":"skills-cli","command":"npx skills add https://github.com/AceDataCloud/Skills/tree/main/clawhub/api-guide"},{"target":"claude-code","command":"claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install acedatacloud-skills@llmmart"},{"target":"git","command":"git clone https://github.com/AceDataCloud/Skills.git"}]}