api.acedata.cloud

1. Create one at platform.acedata.cloud/console/platform-tokens (or

   POST /api/v1/platform-tokens/

   ). It starts with

   platform-

   and never expires.
2. Provide it one of two ways:
   • Connector (recommended in studio / chat): install the AceDataCloud connector at auth.acedata.cloud/user/connections and paste the token once — the runtime injects

     ACEDATACLOUD_PLATFORM_TOKEN

     into the sandbox automatically (this skill declares

     connections: [acedatacloud]

     ).
   • Local

     .env

     :

ACEDATACLOUD_PLATFORM_TOKEN=platform-v1-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

curl -H "authorization: Bearer $ACEDATACLOUD_PLATFORM_TOKEN" \
  https://platform.acedata.cloud/api/v1/applications/

A normal token only ever sees its own account data. A superuser token sees every user's data and is required for admin operations (announcements).

api_id

application_id

status_code

created_at_from

created_at_to

user_id

{
  "count": 128,
  "items": [
    {
      "id": "c124684b-7188-4c3e-ad53-3fba5150b944",
      "api": { "title": "Suno Audios Generation API" },
      "status_code": 200,
      "original_amount": 0.55,
      "deducted_amount": 0.55,
      "trace_id": "…",
      "elapsed": 12.3,
      "created_at": "2026-06-28T09:15:44Z"
    }
  ]
}

• Spend aggregate —

  GET /usage/apis/aggregate/?created_at_from=&created_at_to=

  →

  { "items": [{ "date", "api_id", "amount" }], "total": <credits>, "apis": { "<id>": { "title" } } }

• Status-code filter values —

  GET /usage/apis/status-codes/

  →

  { "items": [200, 400, 502] }

• CSV export —

  GET /usage/apis/export/?created_at_from=&created_at_to=

  (downloads

  usages.csv

  )

{ "count": 2, "items": [ { "id": "dae4899f-…", "name": "ci", "type": "Token",
  "token": "<secret>", "limited_amount": null, "used_amount": 1.1,
  "host": null, "created_at": "2026-06-28T09:15:44Z" } ] }

• Create —

  POST /credentials/

  { "application_id": "<app>", "name": "ci", "limited_amount": 100, "expired_at": "2026-12-31T00:00:00Z" }

  → returns the credential incl. the new

  token

  . Save it; it is shown in full only at creation.
• Delete —

  DELETE /credentials/{id}

  →

  204 No Content

• Filters:

  application_id

  ,

  host

  ,

  granted

  (

  true

  /

  false

  ),

  user_id

  (superuser).
• To "rotate" a key, delete it and create a new one.

{ "count": 12, "items": [ { "id": "17c10c9d-…", "application_id": "…",
  "package_id": "…", "description": "100 Credits", "price": 13.0,
  "state": "Finished", "pay_way": "Stripe", "pay_url": "<url>",
  "created_at": "2026-06-28T09:17:25Z" } ] }

• state

  ∈

  Pending

  Paid

  Finished

  Expired

  Failed

  Refunded

• pay_way

  ∈

  WechatPay

  AliPay

  Stripe

  X402

  PayPal

  Reward

• Create —

  POST /orders/

  { "application_id": "<app>", "package_id": "<package>" }

• Pay —

  POST /orders/{id}/pay/

  { "pay_way": "Stripe" }

  → returns the order with a

  pay_url

  to open
• Refresh status —

  POST /orders/{id}/refresh/

  (re-checks the PSP and updates

  state

  )
• Filters:

  state

  ,

  pay_way

  ,

  created_at_from

  ,

  created_at_to

  ,

  user_id

  (superuser).

{ "count": 2, "items": [ { "id": "efdccba4-…", "token": "<secret>",
  "expiration": null, "used_at": null, "created_at": "2026-06-28T06:29:02Z" } ] }

• Create —

  POST /platform-tokens/

  → returns the new token (starts with

  platform-

  )
• Delete —

  DELETE /platform-tokens/{id}/

  →

  204 No Content

• Service detail / pricing —

  GET /services/?id=<uuid>

  →

  items[0]

  (full:

  cost

  ,

  unit

  ,

  free_amount

  ,

  title

  ). The

  services/?alias=

  filter is ignored server-side, so resolve an alias by paging

  services/

  and matching

  alias

  client-side. The

  services/{id}/

  detail route is broken (500).
• APIs —

  GET /apis/?path=<path>

  → exactly one item with its OpenAPI

  definition

  +

  cost

  .

  apis/?service_id=

  is ignored server-side; filter by

  service_id

  client-side.

  apis/{id}/

  is broken (500).
• Datasets / integrations —

  GET /datasets/

  ,

  GET /integrations/

  .
• Doc search —

  GET /search/?query=<text>&lang=<code>

  →

  { results: [ { id, alias, title, type, snippet, url } ] }

  . The param is

  query

  (not

  keyword

  ).
• Doc content —

  GET /documents/?id=<uuid>

  →

  items[0].content

  .

  documents/{id}/

  (id or slug) is broken (404).
• Model catalog —

  GET /models/catalog/

  →

  { rates, modalities, count, items:[{ id, name, provider, modality, unit, capabilities, pricing:{ input_credits, output_credits, official_* } }] }

  . Filter client-side.

{ "count": 20, "items": [ { "id", "title", "content", "translation_key", "published", "publish_at", "rank", "tags", "is_read" } ] }

• Publish —

  POST /announcements/admin/

  { "title": "...", "content": "...", "rank": 5, "tags": ["product"], "published": true }

  (

  content

  is Markdown; a zh-cn Translation row is created and other locales are auto-translated by a CronJob)
• Edit / delete —

  PUT

  /

  DELETE /announcements/admin/{id}

• AI polish —

  POST /announcements/admin/polish/

  { "title", "content" }

• AI translate —

  POST /announcements/admin/translate/

  { "translation_key" }

1. Confirm the exact target (

   application_id

   ,

   order_id

   ,

   credential_id

   ) with the user before executing.
2. With the CLI, writes are dry-run unless

   --yes

   is passed.
3. Never print a full

   token

   value into shared logs — it grants account access.

• Use the platform token (

  ACEDATACLOUD_PLATFORM_TOKEN

  ), not the

  api.acedata.cloud

  service token — the latter returns 401 here.

• remaining_amount

  /

  used_amount

  /

  amount

  are in Credits, not USD. Convert with a service's package:

  USD = Credits × (package.price / package.amount)

  .
• Newly created credential/platform tokens are returned in full only once — store them immediately.
• Credential "rotate" is delete + recreate; there is no in-place rotate endpoint.
• Announcement endpoints under

  /admin/

  require a superuser token; a normal token gets

  403

  .

MCP:

pip install mcp-acedatacloud

| Hosted:

https://mcp.acedata.cloud/mcp

| See all MCP servers. The MCP exposes these as tools (

acedatacloud_get_balance

,

acedatacloud_list_usage

,

acedatacloud_get_pricing

,

acedatacloud_search_docs

,

acedatacloud_get_api_spec

,

acedatacloud_create_credential

, …) with the same write-confirmation guard.