Get Service List

The Ace Data Cloud platform offers a rich set of API services, including AI image generation, video generation, music generation, LLM chat, search engine, etc. You can obtain a list of all available services through the platform API.

This interface does not require authentication, anyone can call it.

¶ Interface Description

Request Method: GET
Request URL: https://platform.acedata.cloud/api/v1/services/
Request Headers:
- accept: application/json

¶ Query Parameters

Parameter	Type	Required	Description
`id`	string	No	Service ID (UUID), supports multiple, e.g., `?id=xxx&id=yyy`
`type`	string	No	Service type, optional values: `Api`, `Proxy`, `Integration`, `Dataset`, `Introduction`, `Agent`
`private`	boolean	No	Whether it is a private service
`tag`	string	No	Filter by tag
`limit`	integer	No	Number of items returned per page, default is 10
`offset`	integer	No	Offset, default is 0

¶ CURL Request Example

curl -X GET \
  -H "accept: application/json" \
  "https://platform.acedata.cloud/api/v1/services/"

Filter by type:

curl -X GET \
  -H "accept: application/json" \
  "https://platform.acedata.cloud/api/v1/services/?type=Api"

¶ Response Example

{
  "count": 50,
  "results": [
    {
      "id": "d87e5e99-b797-4ade-9e73-b896896b0461",
      "alias": "midjourney",
      "name": "Midjourney",
      "type": "Api",
      "description": "Midjourney image generation service",
      "cost": [...],
      "unit": "Count",
      "free_amount": 0,
      "api_ids": [
        "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
      ],
      "proxy_ids": [],
      "applied": false,
      "rank": 10,
      "tags": ["image", "ai"],
      "metadata": {},
      "created_at": "2024-01-01T00:00:00.000000Z",
      "updated_at": "2024-08-01T00:00:00.000000Z"
    }
  ]
}

¶ Response Field Description

Field	Type	Description
`id`	string	Unique identifier for the service (UUID)
`alias`	string	Service alias (English identifier)
`name`	string	Service name
`type`	string	Service type
`description`	string	Service description
`cost`	array	Pricing rules (JsonLogic format)
`unit`	string	Measurement unit: Count (times), Token, MB, GB, Credit (points)
`free_amount`	number	Free quota
`api_ids`	array	List of associated API IDs
`proxy_ids`	array	List of associated Proxy IDs
`applied`	boolean	Whether the current user has applied (meaningful only when logged in)
`rank`	integer	Sorting priority
`tags`	array	List of tags
`metadata`	object	Extended metadata

¶ Code Example

Python:

import requests

url = "https://platform.acedata.cloud/api/v1/services/"
headers = {"accept": "application/json"}

response = requests.get(url, headers=headers)
data = response.json()

for service in data["results"]:
    print(f"{service['name']} ({service['alias']}) - Type: {service['type']}")