Get AceDataCloud Platform Service Details

Obtain complete information about a single service through the service ID (UUID) or alias, which includes more fields than those returned by Get AceDataCloud Platform Service List, and additionally expands related objects such as apis, proxies, datasets, packages, etc. This is suitable for scenarios like service detail pages, pricing comparison pages, Agent tool descriptions, etc.

ℹ️ This interface belongs to the AceDataCloud Platform Management API, with a unified prefix of https://platform.acedata.cloud/api/v1/. For a complete index of interfaces, see Get AceDataCloud Platform Document List.

Interface Overview

Item Content
Method GET
URL https://platform.acedata.cloud/api/v1/services/{service_id}
Authentication ❌ Public

⚠️ The URL should not have a trailing slash /services/{id} instead of /services/{id}/. A trailing slash may cause some proxies to redirect to the list interface, resulting in a count/items structure instead of a single object.

Authentication Description

This interface is completely public. However, with the account token included, the applied field in the response will reflect the actual application status of the current account, otherwise it will always be false.

For information on obtaining the account token, see Manage AceDataCloud Platform Account Token.

Path Parameters

Parameter Type Required Description
service_id UUID / string Service ID (UUID) or alias (such as midjourney, openai, webextrator, etc.)

Request Examples

cURL

# Query by UUID
curl 'https://platform.acedata.cloud/api/v1/services/8efa1d83-9b75-4562-b44a-af95ce563d05' \
  -H 'accept: application/json'

# Query by alias
curl 'https://platform.acedata.cloud/api/v1/services/midjourney' \
  -H 'accept: application/json'

# Check applied status with account token
curl 'https://platform.acedata.cloud/api/v1/services/midjourney' \
  -H 'accept: application/json' \
  -H 'authorization: Bearer platform-v1-92eb****629c'

Python

import requests

resp = requests.get(
    "https://platform.acedata.cloud/api/v1/services/midjourney",
    headers={
        "accept": "application/json",
        "authorization": "Bearer platform-v1-92eb****629c",
    },
    timeout=10,
)
svc = resp.json()
print(f"Service: {svc['title']} ({svc['alias']})")
print(f"Applied: {svc['applied']}, Free Quota: {svc['free_amount']} {svc['unit']}")
print(f"Number of APIs: {len(svc['apis'])}, Number of Packages: {len(svc['packages'])}")
for pkg in svc["packages"]:
    print(f"  ¥{pkg['price']:>7.2f}  ->  {pkg['amount']} {svc['unit']}")

Node.js

const r = await fetch('https://platform.acedata.cloud/api/v1/services/midjourney', {
  headers: { accept: 'application/json' },
})
const svc = await r.json()
console.log(`${svc.title} - ${svc.packages.length} packages - ${svc.apis.length} APIs`)

Response Example (HTTP 200)

{
  "id": "8efa1d83-9b75-4562-b44a-af95ce563d05",
  "alias": "face-transform",
  "title": "Face Transformation",
  "description": "Services for face recognition, replacement, and style transformation.",
  "introduction": "...long text Markdown...",
  "type": "Api",
  "applied": false,
  "applied_count": 281,
  "free_amount": 1.0,
  "unit": "Credit",
  "private": false,
  "need_verify": false,
  "rank": 0,
  "tags": [],
  "metadata": null,
  "thumbnail": "https://cdn.acedata.cloud/qrd7gw.png/thumb_600x300",
  "doc_url": null,
  "demo_url": null,
  "api_ids": [
    "e4fbc3b6-4f44-48fb-a049-40f5c27c7cd3",
    "2c7f6468-58d9-4611-885b-1e34664d49e9"
  ],
  "proxy_ids": [],
  "cost": [
    { "conditions": { "==": [1, 1] }, "consumption": 0.0025 }
  ],
  "apis": [
    {
      "id": "e4fbc3b6-4f44-48fb-a049-40f5c27c7cd3",
      "name": "Face Analyze API",
      "title": "Facial Feature Location API",
      "path": "/face/analyze",
      "stage": "Stable",
      "cost": [ { "conditions": { "==": [1, 1] }, "consumption": 0.0025 } ]
    }
  ],
  "proxies": [],
  "datasets": [],
  "packages": [
    {
      "id": "4add61f2-61db-4d1c-85b6-d4876ac122f0",
      "type": "Usage",
      "price": 63.2,
      "amount": 530.0,
      "duration": null,
      "private": false
    }
  ],
  "created_at": "2024-06-11T00:41:29.255614Z",
  "updated_at": "2026-04-26T16:12:40.481154Z"
}

Response Field Description

The detail interface expands on all fields from the list interface and additionally includes:

Field Type Description
apis array Complete list of associated API objects (each containing id, name, title, path, stage, cost)
proxies array Complete list of associated Proxy objects
datasets array Associated datasets (if type=Dataset)
packages array List of packages, including type (Usage/Subscription), price, amount, duration

For the definitions of other fields, see Get AceDataCloud Platform Service List → Response Field Description.

Error Handling

HTTP Code Meaning
404 not_found service_id (UUID or alias) does not exist
500 Generally caused by mistakenly adding a slash at the end of the URL; retry after removing it

Practical Tips

  • alias > UUID: Hardcoding alias (such as midjourney) into the code is more stable; UUID will change when migrating environments.
  • The apis field does not include OpenAPI definitions: The complete OpenAPI 3.0 Schema can be found in the Get AceDataCloud Platform API Details interface.
  • Pulling a service's "full capabilities": Use this interface to obtain api_ids, and then call /apis/{api_id} one by one to pull details.
  • If applied=true, you can directly create API credentials to obtain the 32-bit Token needed for calling business interfaces, without needing to apply again.