获取 AceDataCloud 平台模型列表

返回平台上全部可用的 LLM / 图像 / 视频 / 音频 / 嵌入 / 重排序模型——按 OpenAI /v1/models 风格的扁平视图返回，兼容 OpenAI SDK。一个 Proxy 服务通常对应数十乃至上百个模型。

适用场景：

• 在你产品里渲染「模型选择下拉」。
• 给路由层做模型可用性检查。
• 同步到 LiteLLM / OpenRouter 风格的中间层。

ℹ️ 本接口属于 AceDataCloud 平台管理 API，统一前缀 https://platform.acedata.cloud/api/v1/。

接口概览

项	内容
方法	GET
URL	https://platform.acedata.cloud/api/v1/models/
鉴权	❌ 公开

鉴权说明

本接口完全公开，无需账户令牌或登录态。

💡 但是：如果带上账户令牌，响应会按你已申请的服务过滤，仅返回你能调用的模型。

查询参数

参数	类型	必填	默认	说明
service_id	UUID	否	—	按服务过滤
tag	string	否	—	按标签过滤（如 chat、embedding、image、video、tts）
limit	integer	否	100	每页条数，最大 200
offset	integer	否	0	偏移
ordering	string	否	—	排序字段

请求示例

cURL

# 全部模型
curl 'https://platform.acedata.cloud/api/v1/models/?limit=200' \
  -H 'accept: application/json'

# 只看 chat 类
curl 'https://platform.acedata.cloud/api/v1/models/?tag=chat&limit=200' \
  -H 'accept: application/json'

Python

import requests

resp = requests.get(
    "https://platform.acedata.cloud/api/v1/models/",
    headers={"accept": "application/json"},
    params={"tag": "chat", "limit": 200},
    timeout=10,
)
data = resp.json()
print(f"共 {data['count']} 个 chat 模型")
for m in data["items"][:20]:
    print(f"  {m['id']:50s}  ${m.get('prompt_price') or 0:.6f}/1K in, ${m.get('completion_price') or 0:.6f}/1K out")

Node.js

const r = await fetch('https://platform.acedata.cloud/api/v1/models/?limit=200')
const { count, items } = await r.json()
console.log(`共 ${count} 个模型`)

响应示例（HTTP 200）

{
  "count": 187,
  "items": [
    {
      "id": "gpt-4.1",
      "object": "model",
      "owned_by": "openai",
      "service_id": "38ecf158-36f2-42f2-8e7f-6786cdfc2452",
      "service_alias": "openai",
      "service_title": "OpenAI",
      "context_window": 1048576,
      "max_output_tokens": 32768,
      "prompt_price": 0.000002,
      "completion_price": 0.000008,
      "cached_prompt_price": 0.0000005,
      "tags": ["chat", "vision", "tool_call"],
      "created_at": 1733616000
    }
  ]
}

ℹ️ 字段命名同时兼容 OpenAI 官方 /v1/models 响应（id、object、owned_by），可直接喂给 OpenAI SDK。

响应字段说明

字段	类型	说明
id	string	模型 ID（如 gpt-4.1、claude-sonnet-4、midjourney、veo-3）
object	string	恒为 "model"（OpenAI 兼容字段）
owned_by	string	模型所属方（openai / anthropic / google / meta / xai…）
service_id	UUID	该模型挂载的平台服务 ID
service_alias	string	服务别名
service_title	string	服务标题
context_window	integer	上下文窗口长度（Token 数，LLM 专属）
max_output_tokens	integer	单次最大输出 Token 数
prompt_price	number \	null	输入 Token 单价（单位：USD / Token，即美元每 Token，不是每 1K）
completion_price	number \	null	输出 Token 单价（USD / Token）
cached_prompt_price	number \	null	命中 prompt cache 的输入单价（USD / Token）
tags	array	模型能力标签：chat / vision / tool_call / audio / embedding / rerank / image / video / tts / stt 等
created_at	integer	模型上架时间（Unix 秒级时间戳，OpenAI 兼容字段）

错误处理

HTTP	code	含义
400	invalid	参数非法

实用提示

• OpenAI SDK 兼容：本接口响应可直接用作 OpenAI Python SDK 的 client.models.list() 替代源。
• 价格是按 Token 计：不是按千 Token——这与 OpenAI 官方定价表显示的”per 1M tokens”不同。换算时记得乘 1,000,000。
• null 价格表示按调用次数计费：通常是图像 / 视频 / 音频类模型，每次调用按固定 Credit 数计费，看创建 AceDataCloud 平台充值订单 的套餐表。
• 过滤实际可调用的模型：带上账户令牌，只返回你已申请的服务下的模型。

相关接口

• 获取 AceDataCloud 平台服务列表
• 获取 AceDataCloud 平台服务下的 Proxy 列表
• 获取 AceDataCloud 平台 Proxy 调用记录