{"id":"0baa7af2-6333-4c58-bc3b-670ab0f36ef0","entityType":"agent","slug":"clawhub-acedatacloud-api-guide","name":"api-guide","canonicalUrl":"https://www.xpersona.co/agent/clawhub-acedatacloud-api-guide","canonicalPath":"/agent/clawhub-acedatacloud-api-guide","generatedAt":"2026-10-15T04:19:11.901Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-11T20:50:59.394Z","emptyReason":null},"description":"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. Skill: api-guide Owner: acedatacloud 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. Tags: latest:1.0.1 Version history: v1.0.1 | 2026-10-11T16:21:46.137Z | user Explain API key setup and first run, with safe task follow-up. v1.0.0 | 2026-03-22T03:37:05.655Z | auto In","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 994 downloads reported by the source. Last updated 10/11/2026.","installCommand":"clawhub skill install s1758andz1z9wjk475tkwr34mx8g3b4k:api-guide","sourceUrl":"https://clawhub.ai/acedatacloud/api-guide","homepage":"https://clawhub.ai/acedatacloud/skills/api-guide","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/acedatacloud/api-guide","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/acedatacloud/skills/api-guide","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":60,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"Set up an AceDataCloud API key, make a first request, and troubleshoot authentication, access, billing, and asynchronous tasks. Use before calling an AceDataClo"},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-11T20:50:59.394Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T20:50:59.394Z","emptyReason":null},"stars":null,"forks":null,"downloads":994,"likes":null,"task":null,"library":null,"packageName":null,"latestVersion":"1.0.1","tractionLabel":"994 downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T20:50:59.258Z","emptyReason":null},"lastUpdatedAt":"2026-10-11T20:50:59.394Z","lastCrawledAt":"2026-10-11T20:50:59.258Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-12T20:50:59.258Z","lastVerifiedAt":null,"highlights":[{"version":"1.0.1","createdAt":"2026-10-11T16:21:46.137Z","changelog":"Explain API key setup and first run, with safe task follow-up.","fileCount":3,"zipByteSize":3696},{"version":"1.0.0","createdAt":"2026-03-22T03:37:05.655Z","changelog":"Initial release of the AceDataCloud API usage guide. - Provides comprehensive instructions on account setup, API authentication, and credential management. - Details request patterns for both synchronous and asynchronous APIs. - Explains error handling, billing mechanics, and service category endpoints. - Includes OpenAI-compatible SDK integration examples for Python and JavaScript. - Highlights common issues and important usage notes for effective integration.","fileCount":3,"zipByteSize":3867}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s1758andz1z9wjk475tkwr34mx8g3b4k:api-guide","setupComplexity":"medium","setupSteps":["Setup complexity is MEDIUM. Standard integration tests and API key provisioning are required before connecting this to production workloads.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-acedatacloud-api-guide/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-acedatacloud-api-guide/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-acedatacloud-api-guide/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-acedatacloud-api-guide/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-acedatacloud-api-guide/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-acedatacloud-api-guide/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-15T04:19:11.900Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-acedatacloud-api-guide/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-acedatacloud-api-guide/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-acedatacloud-api-guide/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-acedatacloud-api-guide/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"high","updatedAt":"2026-10-11T20:50:59.394Z","emptyReason":null},"readme":"Skill: api-guide\n\nOwner: acedatacloud\n\nSummary: 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.\n\nTags: latest:1.0.1\n\nVersion history:\n\nv1.0.1 | 2026-10-11T16:21:46.137Z | user\n\nExplain API key setup and first run, with safe task follow-up.\n\nv1.0.0 | 2026-03-22T03:37:05.655Z | auto\n\nInitial release of the AceDataCloud API usage guide.\n\n- Provides comprehensive instructions on account setup, API authentication, and credential management.\n- Details request patterns for both synchronous and asynchronous APIs.\n- Explains error handling, billing mechanics, and service category endpoints.\n- Includes OpenAI-compatible SDK integration examples for Python and JavaScript.\n- Highlights common issues and important usage notes for effective integration.\n\nArchive index:\n\nArchive v1.0.1: 3 files, 3696 bytes\n\nFiles: skill-card.md (1904b), SKILL.md (4996b), _meta.json (128b)\n\nFile v1.0.1:SKILL.md\n\n---\nname: 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:\n  author: acedatacloud\n  version: \"1.1\"\ncompatibility: Requires an AceDataCloud account; get a service API key at https://platform.acedata.cloud/console/applications.\n---\n\n# AceDataCloud API: from account to first result\n\nThis guide is the source for the existing\n[@acedatacloud/api-guide](https://clawhub.ai/acedatacloud/skills/api-guide)\nClawHub listing. A ClawHub login installs Skills; an AceDataCloud API key\nauthorizes calls to `api.acedata.cloud`. They are different credentials.\n\n## 1. Install the right Skill\n\nInstall the [ClawHub CLI](https://github.com/openclaw/clawhub/blob/main/docs/cli.md)\nif needed, then install the service Skill you intend to use:\n\n```bash\nnpm install -g clawhub\nclawhub install @acedatacloud/suno\nclawhub list\n```\n\nFor a different first workflow, choose its Skill, such as\n`clawhub install @acedatacloud/google-search`. Verify that the publisher is\n**@acedatacloud**. The general API guide explains setup; the service Skill\ncontains its exact request fields, models, and task endpoint.\n\n## 2. Find or create your API key\n\n1. Sign in at [AceDataCloud → Applications](https://platform.acedata.cloud/console/applications).\n   Create an account if needed.\n2. Open **General application**; initialize it if prompted. Its API key can\n   access multiple services enabled for your account. A service-specific\n   application key is limited to that service. Check access, balance, and the\n   current price of the service you want to call.\n3. Copy an existing key, or select **Manage Keys → Create**. Name a new key\n   (for example, `OpenClaw`), set expiration and restrictions if needed, and\n   copy the key value from the application card or key list. If **Allowed APIs**\n   is restricted, include every route needed for your first workflow. An\n   asynchronous generation needs both the submit and task-query routes.\n\nThe [illustrated repository guide](https://github.com/AceDataCloud/Skills#first-run-with-clawhub-and-openclaw)\nshows where to copy a key and how to create a separate one. Copy only the key\nvalue. Do not include `Bearer ` in the value, put it in a prompt, or commit it.\nA `platform-...` management token is for the separate account-management API,\nnot for service generation, chat, or search.\n\n## 3. Configure the key\n\nOn the OpenClaw Gateway host, add this line to `~/.openclaw/.env`:\n\n```dotenv\nACEDATACLOUD_API_TOKEN=your_api_key_here\n```\n\nKeep the file private with `chmod 600 ~/.openclaw/.env`, restart the Gateway,\nand start a new session. [OpenClaw loads this global file](https://docs.openclaw.ai/help/faq/env-vars#how-does-openclaw-load-environment-variables)\neven when the Gateway runs as a service. For a direct terminal test instead:\n\n```bash\nexport ACEDATACLOUD_API_TOKEN=\"your_api_key_here\"\n```\n\n## 4. Make one first request\n\nThis 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 `/serp/google`:\n\n```bash\ncurl -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```\n\nFor image, video, or music generation, follow that service Skill's Quick Start.\nIf a submission returns a `task_id`, save it and query the matching `/tasks`\nendpoint until the task is terminal. Use `async: true` where the service\nsupports it; set `callback_url` 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[task-polling guide](https://github.com/AceDataCloud/Skills/blob/main/skills/_shared/async-tasks.md).\n\n## 5. Troubleshoot the first run\n\n| Symptom | Check |\n|---|---|\n| 401 | Key copied completely, not expired, and available to the running Gateway. `Bearer ` belongs in the HTTP header, not the key value. |\n| 403 | Service entitlement, key restrictions, and **Allowed APIs**. A content-moderation rejection may also be 403; read the response. |\n| 400 | Exact endpoint, model, and JSON shape from the service Skill. |\n| 429 | Reduce request rate or concurrency. Do not automatically retry a billable submit. |\n| Pending, timeout, or 5xx | Query the original task or request history before submitting again. |\n\nThe [AceDataCloud account console](https://platform.acedata.cloud) shows\nbalance and usage. Share a task or trace ID with [support](mailto:dev@acedata.cloud),\nnever your API key. For service-specific examples, see\n[@acedatacloud/suno](https://clawhub.ai/acedatacloud/skills/suno),\n[@acedatacloud/nano-banana](https://clawhub.ai/acedatacloud/skills/nano-banana),\nand [@acedatacloud/ai-chat](https://clawhub.ai/acedatacloud/skills/ai-chat).\n\nFile v1.0.1:_meta.json\n\n{\n  \"ownerId\": \"kn7bzh6acmdm9bs461ed824qhd83dqrj\",\n  \"slug\": \"api-guide\",\n  \"version\": \"1.0.1\",\n  \"publishedAt\": 1791735706137\n}\n\nFile v1.0.1:skill-card.md\n\n## Description:\n\nSet up an AceDataCloud API key, make a first request, and troubleshoot authentication, access, billing, and asynchronous tasks.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[acedatacloud](https://clawhub.ai/user/acedatacloud)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nDevelopers and other AceDataCloud users use this guide to configure a service API key, try a first request, and troubleshoot common errors and asynchronous tasks.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: An exposed service API key could allow unauthorized requests.\n\nMitigation: Keep the key out of prompts and repositories, protect its configuration file, and restrict allowed APIs where possible.\n\nRisk: Sample requests and duplicate submissions may incur charges.\n\nMitigation: Check pricing before testing and query an existing task rather than resubmitting a pending request.\n\n## Reference(s):\n\n- [ClawHub api-guide listing](https://clawhub.ai/acedatacloud/skills/api-guide)\n- [AceDataCloud applications console](https://platform.acedata.cloud/console/applications)\n- [OpenClaw environment variable guide](https://docs.openclaw.ai/help/faq/env-vars#how-does-openclaw-load-environment-variables)\n\n## Skill Output:\n\n**Output Type(s):** [Guidance, Shell commands, Configuration instructions]\n\n**Output Format:** [Markdown with shell and configuration examples]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Requires an AceDataCloud account and service API key; sample requests may be billable.]\n\n## Skill Version(s):\n\n1.0.1 (source: ClawHub release)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nArchive v1.0.0: 3 files, 3867 bytes\n\nFiles: skill-card.md (2647b), SKILL.md (4566b), _meta.json (128b)\n\nFile v1.0.0:SKILL.md\n\n---\nname: acedatacloud-api\ndescription: 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.\nlicense: Apache-2.0\nmetadata:\n  author: acedatacloud\n  version: \"1.0\"\ncompatibility: Requires an AceDataCloud account at platform.acedata.cloud.\n---\n\n# 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## Authentication\n\nAll APIs use Bearer token authentication:\n\n```bash\ncurl -X POST https://api.acedata.cloud/<endpoint> \\\n  -H \"Authorization: Bearer YOUR_API_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{ ... }'\n```\n\n### Token Types\n\n| Type | Format | Scope |\n|------|--------|-------|\n| **Service Token** | UUID string | Access to subscribed service only |\n| **Global Token** | UUID string | Access to all subscribed services |\n\n## Base URL\n\n```\nhttps://api.acedata.cloud\n```\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## Common 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**Step 1:** Submit request\n\n```json\nPOST /suno/audios\n{\"prompt\": \"a jazz song\", \"wait\": false}\n→ {\"task_id\": \"abc123\"}\n```\n\n**Step 2:** Poll for results\n\n```json\nPOST /suno/tasks\n{\"task_id\": \"abc123\"}\n→ {\"state\": \"succeeded\", \"data\": [...]}\n```\n\n**Shortcut:** Pass `\"wait\": true` to block until completion (simpler but longer timeout).\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, DeepSeek, Grok | `/v1/chat/completions` |\n| **Image Gen** | Midjourney, Flux, Seedream, NanoBanana | `/midjourney/*`, `/flux/*`, etc. |\n| **Video Gen** | Luma, Sora, Veo, Kling, Hailuo, Seedance | `/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` — you must poll to get the result\n- `wait: true` is convenient but has a timeout limit (typically 60–120s)\n- Rate limits vary by service tier — upgrade your plan if hitting limits\n- All timestamps are in UTC\n\nFile v1.0.0:_meta.json\n\n{\n  \"ownerId\": \"kn7bzh6acmdm9bs461ed824qhd83dqrj\",\n  \"slug\": \"api-guide\",\n  \"version\": \"1.0.0\",\n  \"publishedAt\": 1774150625655\n}\n\nFile v1.0.0:skill-card.md\n\n## Description:\n\nGuide 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.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[germey](https://clawhub.ai/user/germey)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nDevelopers and engineers use this skill to integrate AceDataCloud services into applications, including account setup, API authentication, credential handling, synchronous and asynchronous request patterns, error handling, billing awareness, and SDK usage.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Real AceDataCloud API tokens could be exposed if pasted into chats, committed to source control, or stored in plain text.\n\nMitigation: Use environment variables or a secret manager, avoid sharing tokens, and rotate credentials if exposure is suspected.\n\nRisk: Global tokens can grant broader access than needed for a single integration.\n\nMitigation: Prefer service-scoped tokens unless the workflow genuinely needs access across subscribed services.\n\nRisk: API calls may consume paid quota or trigger rate limits.\n\nMitigation: Check subscription balance and service limits before running generated requests, and use retry with backoff for rate-limited calls.\n\nRisk: Generated examples call external AceDataCloud endpoints.\n\nMitigation: Review endpoint paths, request payloads, and billing implications before executing any proposed command or SDK snippet.\n\n## Reference(s):\n\n- [AceDataCloud Platform](https://platform.acedata.cloud)\n- [AceDataCloud API Base URL](https://api.acedata.cloud)\n- [AceDataCloud OpenAI-compatible API Base URL](https://api.acedata.cloud/v1)\n\n## Skill Output:\n\n**Output Type(s):** [Text, Markdown, Code, Shell commands, Configuration, Guidance]\n\n**Output Format:** [Markdown guidance with code blocks, shell commands, API request examples, SDK snippets, and configuration notes]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [May include AceDataCloud endpoint paths, token handling guidance, polling patterns for asynchronous tasks, billing notes, and HTTP error handling guidance.]\n\n## Skill Version(s):\n\n1.0.0 (source: ClawHub release evidence)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.","readmeExcerpt":"Skill: api-guide Owner: acedatacloud 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. Tags: latest:1.0.1 Version history: v1.0.1 | 2026-10-11T16:21:46.137Z | user Explain API key setup and first run, with safe task follow-up. v1.0.0 | 2026-03-22T03:37:05.655Z | auto In","codeSnippets":[],"executableExamples":[{"language":"bash","snippet":"npm install -g clawhub\nclawhub install @acedatacloud/suno\nclawhub list"},{"language":"dotenv","snippet":"ACEDATACLOUD_API_TOKEN=your_api_key_here"},{"language":"bash","snippet":"export ACEDATACLOUD_API_TOKEN=\"your_api_key_here\""},{"language":"bash","snippet":"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\"}'"},{"language":"bash","snippet":"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\"}'"},{"language":"bash","snippet":"curl -X POST https://api.acedata.cloud/<endpoint> \\\n  -H \"Authorization: Bearer YOUR_API_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{ ... }'"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: 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:\n  author: acedatacloud\n  version: \"1.1\"\ncompatibility: Requires an AceDataCloud account; get a service API key at https://platform.acedata.cloud/console/applications.\n---\n\n# AceDataCloud API: from account to first result\n\nThis guide is the source for the existing\n[@acedatacloud/api-guide](https://clawhub.ai/acedatacloud/skills/api-guide)\nClawHub listing. A ClawHub login installs Skills; an AceDataCloud API key\nauthorizes calls to `api.acedata.cloud`. They are different credentials.\n\n## 1. Install the right Skill\n\nInstall the [ClawHub CLI](https://github.com/openclaw/clawhub/blob/main/docs/cli.md)\nif needed, then install the service Skill you intend to use:\n\n```bash\nnpm install -g clawhub\nclawhub install @acedatacloud/suno\nclawhub list\n```\n\nFor a different first workflow, choose its Skill, such as\n`clawhub install @acedatacloud/google-search`. Verify that the publisher is\n**@acedatacloud**. The general API guide explains setup; the service Skill\ncontains its exact request fields, models, and task endpoint.\n\n## 2. Find or create your API key\n\n1. Sign in at [AceDataCloud → Applications](https://platform.acedata.cloud/console/applications).\n   Create an account if needed.\n2. Open **General application**; initialize it if prompted. Its API key can\n   access multiple services enabled for your account. A service-specific\n   application key is limited to that service. Check access, balance, and the\n   current price of the service you want to call.\n3. Copy an existing key, or select **Manage Keys → Create**. Name a new key\n   (for example, `OpenClaw`), set expiration and restrictions if needed, and\n   copy the key value from the application card or key list. If **Allowed APIs**\n   is restricted, include every route needed for your first workflow. An\n   asynchronous generation needs both the submit and task-query routes.\n\nThe [illustrated repository guide](https://github.com/AceDataCloud/Skills#first-run-with-clawhub-and-openclaw)\nshows where to copy a key and how to create a separate one. Copy only the key\nvalue. Do not include `Bearer ` in the value, put it in a prompt, or commit it.\nA `platform-...` management token is for the separate account-management API,\nnot for service generation, chat, or search.\n\n## 3. Configure the key\n\nOn the OpenClaw Gateway host, add this line to `~/.openclaw/.env`:\n\n```dotenv\nACEDATACLOUD_API_TOKEN=your_api_key_here\n```\n\nKeep the file private with `chmod 600 ~/.openclaw/.env`, restart the Gateway,\nand start a new session. [OpenClaw loads this global file](https://docs.openclaw.ai/help/faq/env-vars#how-does-openclaw-load-environment-variables)\neven when the Gateway runs as a service. For a direct terminal test instead:\n\n```bash\nexport ACEDATACLOUD_API_TOKEN=\"your_api_key_here"},{"path":"_meta.json","content":"{\n  \"ownerId\": \"kn7bzh6acmdm9bs461ed824qhd83dqrj\",\n  \"slug\": \"api-guide\",\n  \"version\": \"1.0.1\",\n  \"publishedAt\": 1791735706137\n}"},{"path":"skill-card.md","content":"## Description:\n\nSet up an AceDataCloud API key, make a first request, and troubleshoot authentication, access, billing, and asynchronous tasks.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[acedatacloud](https://clawhub.ai/user/acedatacloud)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nDevelopers and other AceDataCloud users use this guide to configure a service API key, try a first request, and troubleshoot common errors and asynchronous tasks.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: An exposed service API key could allow unauthorized requests.\n\nMitigation: Keep the key out of prompts and repositories, protect its configuration file, and restrict allowed APIs where possible.\n\nRisk: Sample requests and duplicate submissions may incur charges.\n\nMitigation: Check pricing before testing and query an existing task rather than resubmitting a pending request.\n\n## Reference(s):\n\n- [ClawHub api-guide listing](https://clawhub.ai/acedatacloud/skills/api-guide)\n- [AceDataCloud applications console](https://platform.acedata.cloud/console/applications)\n- [OpenClaw environment variable guide](https://docs.openclaw.ai/help/faq/env-vars#how-does-openclaw-load-environment-variables)\n\n## Skill Output:\n\n**Output Type(s):** [Guidance, Shell commands, Configuration instructions]\n\n**Output Format:** [Markdown with shell and configuration examples]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Requires an AceDataCloud account and service API key; sample requests may be billable.]\n\n## Skill Version(s):\n\n1.0.1 (source: ClawHub release)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment."}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"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. Skill: api-guide Owner: acedatacloud 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. Tags: latest:1.0.1 Version history: v1.0.1 | 2026-10-11T16:21:46.137Z | user Explain API key setup and first run, with safe task follow-up. v1.0.0 | 2026-03-22T03:37:05.655Z | auto In","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":1055,"uniquenessScore":49,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-11T20:50:59.394Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-11T20:50:59.394Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-15T04:19:11.901Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}