算力集市开放平台 · 开发文档

一个 Key，调用全部 AI 算力。本文档介绍如何接入算力集市开放平台：鉴权、模型/应用调用、异步任务、回调、计费与常见错误。

概述

算力集市把文本、图像、视频、语音（TTS）、数字人、音乐等主流 AI 模型与应用统一接入，开发者用同一个 API Key 即可调用，按实际用量计费（先冻结、完成后多退少补）。

• 统一接口：兼容主流 AI 接口规范，传模型/应用名即可切换。
• 按量计费：点数/百万 tokens、点数/秒、点数/次，成本透明。
• 异步任务：提交返回 task_id，可轮询或使用 callback_url 接收完成回调。

Base URL

开放接口的 Base URL：

https://api.a7w.cn/api/v1

鉴权

除注册/登录/公开接口外，所有调用都需在请求头携带你的 API Key：

Authorization: Bearer <你的API Key>

API Key 在 用户中心 → API 密钥 创建与查看（需完成实名认证）。每个 Key 可设置消费上限（quota），超过后无法继续调用。

快速开始

1. 注册并在「API 密钥」创建 Key → 2. 调用模型 → 3. 按量扣点。示例（文本生成）：

curl -X POST https://api.a7w.cn/api/v1/... \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"model":"deepseek-chat","messages":[{"role":"user","content":"你好"}]}'

模型

模型列表

获取当前可调用的全部模型（含类型、厂商、计费）：

GET /api/user_center/modelList?page_no=1

返回模型名称、类型、厂商、是否热门、计费方式（点数/百万 tokens 或点数/次）等。

在模型市场页选择模型，复制「去调用」地址即可开始。

应用

应用列表

应用（如音乐生成、数字人、人物替换、水印消除等）通过插件目录加载：

GET /api/plugins

每个应用提供「查看接口」（跳转到对应 API 文档）与「去调用」（进入控制台）。应用目录也开放在 https://agent.a7w.cn/ai/app/<appCode>。

异步任务

提交任务

大模型/视频/音频等生成类接口为异步：提交后返回 task_id。示例：

POST /api/v1/apps/{app}/{api}
{ "input_text": "你好", "callback_url": "https://your-domain.com/hook" }

响应：

{ "task_id": "tsk_xxx", "status": "pending", "created_at": 1740000000 }

查询结果

GET /api/v1/tasks/{task_id}

返回 status（completed / processing / failed）与 result、usage.points。

回调通知

提交任务时传 callback_url（选填），任务完成后系统向该地址 POST JSON：

{ "task_id": "tsk_xxx", "status": "completed", "result": {...} }

计费

计价

定价以「点数」计，用户实付 = 上游成本 × (1 + 加成%)。不同模型/场景单位不同：

场景	计费单位	说明
文本生成	点数 / 百万 tokens	输出 tokens 分档计价
图像生成	点数 / 张	按张计价
音视频媒体	点数 / 秒	按输入时长
API 调用	按任务结算	先冻结，完成后多退少补

计费策略可在 用户中心 → 点数管理 查看。异步任务采用「先冻结、完成后按实际用量多退少补」，消费优先扣会员点数，不足再扣充值额度。

余额

GET /api/v1/user/balance

返回 available_points 等。点数不足会返回 402 insufficient_points。

错误码

HTTP	code	含义
400	invalid_request	参数缺失或格式错误
401	auth_failed	API Key 缺失或无效
402	insufficient_points	点数余额不足
402	key_quota_exceeded	当前 API Key 点数额度不足
403	permission_denied	当前 Key 无权调用该模型/应用
404	not_found	模型 / 应用 / 任务不存在
429	queue_limit_exceeded	排队任务已达上限
5xx	server_error	服务异常，请稍后重试

结果转存

任务产出的媒体（图片/视频/音频）可转存到你的对象存储（七牛 / 阿里云 OSS / 腾讯云 COS）。在 用户中心 → 结果转存 配置 provider / bucket / accessKey / secretKey / region / domain，调用时传 storage 对象即可。