Get the Proxy List under the AceDataCloud Platform Service

Obtain the list of Proxy forwarding endpoints mounted under the service by service ID. Proxy is the carrier of "compatible proxy" type services, such as the openai-proxy that fully forwards the OpenAI official API and the claude-proxy that fully forwards Anthropic.

ℹ️ This interface belongs to the AceDataCloud Platform Management API, with a unified prefix of https://platform.acedata.cloud/api/v1/.

¶ Proxy vs Api Services

Service Type	Typical Scenario	Calling Method
Api	Self-developed interfaces, such as `/face/analyze`, `/midjourney/imagine`	`POST https://api.acedata.cloud/<path>` + JSON request body
Proxy	Fully compatible upstream official SDKs, such as OpenAI, Anthropic, Google	`POST https://api.acedata.cloud/<proxy_path>/<upstream_path>` passthrough

If the service type=Api, this interface returns an empty list.

¶ Interface Overview

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

¶ Authentication Description

This interface is completely public, no account token or login state is required.

¶ Path Parameters

Parameter	Type	Required	Description
`service_id`	UUID	✅	Service ID. Must be in UUID format, alias is not supported—this is a historical legacy

¶ Query Parameters

Parameter	Type	Required	Default	Description
`limit`	integer	No	10	Number of items per page
`offset`	integer	No	0	Offset

¶ Request Example

¶ cURL

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

¶ Python

import requests

service_id = "8efa1d83-9b75-4562-b44a-af95ce563d05"
resp = requests.get(
    f"https://platform.acedata.cloud/api/v1/services/{service_id}/proxies/",
    headers={"accept": "application/json"},
    timeout=10,
)
data = resp.json()
print(f"There are {data['count']} Proxies under this service")
for px in data["items"]:
    print(f"  {px.get('name')}  ->  {px.get('path')}")

¶ Node.js

const r = await fetch(
  'https://platform.acedata.cloud/api/v1/services/8efa1d83-9b75-4562-b44a-af95ce563d05/proxies/'
)
console.log(await r.json())

¶ Response Example

¶ No Proxy for this Service (Most Common)

{
  "count": 0,
  "items": []
}

¶ Proxy Available for this Service (e.g., OpenAI, Claude Compatible Services)

{
  "count": 1,
  "items": [
    {
      "id": "9c4e3f2b-...",
      "service_id": "8efa1d83-...",
      "name": "OpenAI Proxy",
      "path": "/openai",
      "cost": [
        { "conditions": { "==": [{ "var": "model" }, "gpt-4.1"] }, "consumption": 0.01 }
      ],
      "stage": "Stable",
      "rank": 0,
      "tags": ["llm", "openai"],
      "metadata": null,
      "created_at": "...",
      "updated_at": "..."
    }
  ]
}

¶ Response Field Description

The field structure is similar to the API List, key fields:

Field	Type	Description
`id`	UUID	Unique identifier for the Proxy
`service_id`	UUID	Service ID to which it belongs
`name`	string	Proxy name
`path`	string	Forwarding prefix. For example, when `path=/openai`, `POST /openai/v1/chat/completions` will be passed to OpenAI official
`cost`	array	Pricing rules
`stage`	string	Lifecycle stage
`created_at`	string	Creation time

¶ Error Handling

HTTP	Code	Meaning
400	`invalid`	`service_id` is not a valid UUID
404	`not_found`	Service does not exist

¶ Practical Tips

Most services have count=0—because most are Api services rather than Proxy services.
Determine if compatible with upstream SDK: If a service has non-empty proxies, you can directly switch the base_url in official SDKs like openai-python, anthropic-python without changing business code.