静觅 崔庆才的个人站点 - Python爬虫教程

0%

获取 AceDataCloud 平台服务列表

作者 发表于 分类于 阅读次数： 本文字数： 4.9k 阅读时长 ≈ 4 分钟

AceDataCloud 平台把所有可调用的功能模块抽象为「服务（Service）」——例如 Midjourney 出图、OpenAI 对话、Suno 出歌、Veo 出片、Web 抓取、SERP 搜索等。本接口返回平台上全部可申请的服务清单，每条记录包含名称、定价规则、免费额度、可选套餐、关联的 API/Proxy 端点等完整信息。

通过本接口你可以：

  • 在你自己的产品里嵌一个”服务市场”页面，让用户从中挑选。
  • 给 LLM Agent 喂一份能力清单，由它决定调哪个服务。
  • 写定时脚本监控价格 / 套餐变化。

ℹ️ 本接口属于 AceDataCloud 平台管理 API，统一前缀 https://platform.acedata.cloud/api/v1/。完整接口索引见获取 AceDataCloud 平台文档列表。

接口概览

项 内容
方法 GET
URL https://platform.acedata.cloud/api/v1/services/
鉴权 ❌ 公开
缓存 服务端有 60 秒短缓存，可放心高频调用

鉴权说明

本接口完全公开，任何人都可以调用，无需账户令牌或登录态。

💡 但是：如果带上账户令牌，响应里的 applied 字段会变成 true/false（表示你是否已申请该服务），而不是恒为 false。这对前端”已申请 / 立即申请”按钮的二态切换非常方便。

1
 
Authorization: Bearer platform-v1-92eb****629c   # 可选

账户令牌的获取方式见管理 AceDataCloud 平台账户令牌。

查询参数

参数 类型 必填 默认 说明
id UUID 否 — 服务 ID。支持多值：?id=xxx&id=yyy
alias string 否 — 服务别名（英文短代号），如 midjourney、openai、webextrator
type string 否 — 服务类型，取值：Api、Proxy、Integration、Dataset、Introduction、Agent
private bool 否 — true 只返回私有服务（仅自己可见）；false 只返回公开服务；不传则全部
tag string 否 — 按标签过滤，如 image、video、llm
limit integer 否 10 每页条数，最大 100
offset integer 否 0 偏移量
ordering string 否 rank 排序，前缀 - 表示倒序。常用 -rank、-applied_count、-updated_at

请求示例

cURL

1
2
3
4
5
6
7
8
9
10
11
12
 
# 不带鉴权，获取前 2 个 Api 类型服务
curl 'https://platform.acedata.cloud/api/v1/services/?type=Api&limit=2' \
  -H 'accept: application/json'

# 带鉴权，看 applied 状态
curl 'https://platform.acedata.cloud/api/v1/services/?type=Api&limit=5' \
  -H 'accept: application/json' \
  -H 'authorization: Bearer platform-v1-92eb****629c'

# 按 alias 精准查询
curl 'https://platform.acedata.cloud/api/v1/services/?alias=midjourney' \
  -H 'accept: application/json'

Python

1
2
3
4
5
6
7
8
9
10
11
12
 
import requests

resp = requests.get(
    "https://platform.acedata.cloud/api/v1/services/",
    headers={"accept": "application/json"},
    params={"type": "Api", "limit": 20, "ordering": "-applied_count"},
    timeout=10,
)
data = resp.json()
print(f"共 {data['count']} 个 Api 服务，按热度倒序")
for svc in data["items"]:
    print(f"  {svc['title']:30s}  {svc['applied_count']:>6} 人申请  {svc['free_amount']} {svc['unit']} 免费")

Node.js

1
2
3
4
5
 
const params = new URLSearchParams({ type: 'Api', limit: '20', ordering: '-applied_count' })
const r = await fetch(`https://platform.acedata.cloud/api/v1/services/?${params}`)
const { count, items } = await r.json()
console.log(`共 ${count} 个服务`)
items.forEach((s) => console.log(`${s.title} (${s.alias})  免费 ${s.free_amount} ${s.unit}`))

响应示例（HTTP 200）

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
 
{
  "count": 42,
  "items": [
    {
      "id": "8efa1d83-9b75-4562-b44a-af95ce563d05",
      "alias": "face-transform",
      "title": "人脸变换",
      "description": "人脸识别、替换和风格转换等操作服务。",
      "introduction": "",
      "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 }
      ],
      "packages": [
        {
          "id": "4add61f2-61db-4d1c-85b6-d4876ac122f0",
          "type": "Usage",
          "price": 63.2,
          "amount": 530.0,
          "duration": null,
          "private": false,
          "tags": [],
          "metadata": null,
          "created_at": "2024-12-19T13:57:46.525377Z",
          "updated_at": "2024-12-19T13:57:46.525394Z"
        }
      ],
      "created_at": "2024-06-11T00:41:29.255614Z",
      "updated_at": "2026-04-26T16:12:40.481154Z"
    }
  ]
}

响应字段说明

字段 类型 说明
count integer 符合条件的总数
items array 服务列表（单页）
id UUID 服务唯一标识
alias string 服务别名（英文短代号），可能为 null
title string 服务标题（已按 Accept-Language 自动本地化）
description string 一句话描述
introduction string 长文 Markdown 详情，可能为空
type string Api / Proxy / Integration / Dataset / Introduction / Agent
applied boolean 仅带鉴权时有意义：当前账户是否已申请该服务
applied_count integer 已申请该服务的累计用户数
free_amount number 申请后自动赠送的免费额度
unit string 计量单位：Credit（积分）、Count（次）、Token、MB、GB
private boolean 是否私有服务（私有服务一般不会出现在公开列表里，需登录后才能看到）
need_verify boolean 是否需要人工审核后才允许申请
rank integer 排序权重（数字越大越靠前）
tags array 标签，如 ["image","ai"]
metadata object 扩展元数据
thumbnail string 缩略图 URL
doc_url string 外部文档链接（如开发者中心），可能为 null
demo_url string 演示页面链接
api_ids array 关联的 API ID 列表
proxy_ids array 关联的 Proxy ID 列表
cost array 定价规则，JsonLogic 格式，conditions 表达式匹配请求参数后用 consumption 计费
packages array 可购买的套餐列表，详见创建 AceDataCloud 平台充值订单
created_at string 服务上线时间
updated_at string 服务信息上次更新时间（套餐 / 定价变动）

错误处理

公开接口几乎不会出错。常见非 200 情况：

HTTP 含义
400 ?limit= 或 ?type= 等参数值非法
502 / 503 / 504 网关或后端短暂不可用，建议指数退避重试 1–3 次

错误响应格式：

1
2
3
4
5
 
{
  "detail": "Invalid value for parameter 'type'.",
  "code": "invalid",
  "trace_id": "5b0f15d6e9c34c9c93d6d0f4f3a8c8d7"
}

实用提示

  • 筛选服务最高效的方式是 alias，不是 id：服务 ID 是 UUID，不便于硬编码到代码里。
  • type=Api 是最常用的过滤：90% 用户只关心 Api 类型；Integration 是组合工作流，Dataset 是只读数据集，Proxy 是 OpenAI 兼容转发。
  • packages 字段返回价格但不含折扣：实际下单时如果使用 X402 加密货币支付或持有 $ACE 代币，会在创建订单时再次计算最终金额。详见创建 AceDataCloud 平台充值订单 与 查询 AceDataCloud 平台 $ACE 代币持仓与折扣。
  • 本接口数据量较大（每条记录可能含数 KB 的 introduction Markdown）：在客户端做长列表时建议传 limit=20 分页加载，而不是一次拉完整。

相关接口

相关文章