GPU 实例 · API 文档
用同一个平台 API Key 调用 GPU 算力:查型号、开机器、拿 Jupyter/SSH、关机销毁,全程按小时计费。
接入信息
| 项目 | 值 |
|---|---|
| 接口根地址 | https://api.a7w.cn/api/v1/gpu |
| 鉴权 | Authorization: Bearer <你的 API Key>(与平台其他接口同一把 Key) |
| 计费单位 | 1 元 = 100 点 |
| 计费方式 | 按小时预扣,销毁时按实际时长退款 |
接口一览
| 接口 | 方法 | 说明 |
|---|---|---|
/api/v1/gpu/models | GET | GPU 型号与售价 |
/api/v1/gpu/images | GET | 算力市场镜像 |
/api/v1/gpu/pods | GET | 应用商店 Pod(ComfyUI 等) |
/api/v1/gpu/instances | POST | 创建实例(镜像或 Pod) |
/api/v1/gpu/instances | GET | 我的实例列表 |
/api/v1/gpu/instances/{id} | GET | 实例详情(含连接地址) |
/api/v1/gpu/instances/{id}/ssh | GET | SSH 连接信息 |
/api/v1/gpu/instances/{id}/start | POST | 开机 |
/api/v1/gpu/instances/{id}/stop | POST | 关机 |
/api/v1/gpu/instances/{id}/reboot | POST | 重启 |
/api/v1/gpu/instances/{id}/destroy | POST | 销毁(退未用时长) |
/api/v1/gpu/pool/acquire | POST | 申请可用节点(无则自动开机) |
/api/v1/gpu/pool/touch | POST | 上报活跃(重置空闲计时) |
/api/v1/gpu/workflows | GET | 工作流市场 |
/api/v1/gpu/workflows/info | GET | 工作流参数清单 |
/api/v1/gpu/workflows/run | POST | 提交工作流 |
/api/v1/gpu/workflows/execution | GET | 查询进度与产物 |
1. 查型号与价格
curl https://api.a7w.cn/api/v1/gpu/models \
-H "Authorization: Bearer $API_KEY"
{
"code": 0,
"data": {
"models": [
{ "gpu_uuid": "32ce...", "gpu_name": "RTX 4090 D",
"hour_points": 261.8, "hour_yuan": 2.62,
"day_points": 6283, "day_yuan": 62.83 }
]
}
}
2. 创建实例
需要额外磁盘时加
extra_gb参数,详见「云存储计费」。
curl -X POST https://api.a7w.cn/api/v1/gpu/instances \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"gpu_uuid": "32ceabe6c96e44bdb1e4d80358a3b8ae",
"gpu_nums": 1,
"image_uuid": "ceb70da2df074c9e99905b6a4f4db032",
"hours": 1
}'
用应用商店 Pod(如 ComfyUI)时,把 image_uuid 换成 pod_uuid:
{ "gpu_uuid": "...", "gpu_nums": 1, "pod_uuid": "aaf60b6a65a14a9bac09e5b44daf246d", "hours": 2 }
返回:
{ "code": 0, "data": { "instance": { "id": "gpu_mw7ai...", "status": "starting", "prepaid": 261.8 + 存储 } } }
创建时按
小时点价 × 卡数 × hours预扣点数;失败自动退回。
3. 等就绪并取连接地址
curl https://api.a7w.cn/api/v1/gpu/instances/gpu_mw7ai... \
-H "Authorization: Bearer $API_KEY"
{ "data": { "instance": {
"status": "running",
"server_url": ["https://xxxx.gz14.chenyu.cn/lab?token=Zeyun1234"],
"has_ssh": false
} } }
server_url是 Jupyter / WebUI 地址,浏览器直接打开- 部分镜像支持 SSH:
GET /instances/{id}/ssh返回host/port/username/password
4. 关机 / 开机 / 销毁
curl -X POST https://api.a7w.cn/api/v1/gpu/instances/gpu_xxx/stop -H "Authorization: Bearer $API_KEY"
curl -X POST https://api.a7w.cn/api/v1/gpu/instances/gpu_xxx/start -H "Authorization: Bearer $API_KEY"
curl -X POST https://api.a7w.cn/api/v1/gpu/instances/gpu_xxx/destroy -H "Authorization: Bearer $API_KEY"
销毁时按实际使用时长结算,未用部分退回点数:
{ "data": { "destroyed": true, "refunded": 232.77 } }
5. 节点池(自动开关机)
适合「开多台、闲时全关、有人调用自动开机」的场景。
申请可用节点(没有就绪节点时自动触发开机,最长等 90 秒):
curl -X POST https://api.a7w.cn/api/v1/gpu/pool/acquire \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"waitMs": 90000}'
{ "data": { "node": { "id": "gpu_mw7ai...", "state": "ready",
"serviceUrl": ["https://xxx/lab?token=..."] }, "waited_ms": 0 } }
上报活跃(每次调用后上报,用于空闲判定):
curl -X POST https://api.a7w.cn/api/v1/gpu/pool/touch \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"node_id": "gpu_mw7ai..."}'
规则:
| 场景 | 平台行为 |
|---|---|
| 无请求超过设定时间 | 自动关机 |
| 有请求但节点全关 | 自动开机并排队等待 |
| 运行中节点超出需要 | 关掉最久未用的一台 |
6. 工作流(直接跑视频/图片)
# 1) 查工作流
curl "https://api.a7w.cn/api/v1/gpu/workflows?page_size=20" -H "Authorization: Bearer $API_KEY"
# 2) 看参数清单
curl "https://api.a7w.cn/api/v1/gpu/workflows/info?workflow_id=wf_87b1e4..." -H "Authorization: Bearer $API_KEY"
# 3) 提交(inputs 的 key 必须来自参数清单的 name)
curl -X POST https://api.a7w.cn/api/v1/gpu/workflows/run \
-H "Authorization: Bearer $API_KEY" -H "Content-Type: application/json" \
-d '{"workflow_id":"wf_87b1e4094cdf7834addf","inputs":{"node_251_value":1024,"node_250_value":576,"node_242_text":"咖啡馆窗边的写实人像"}}'
# 4) 查进度与产物
curl "https://api.a7w.cn/api/v1/gpu/workflows/execution?run_order_id=wfrun_xxx" -H "Authorization: Bearer $API_KEY"
产物类型由工作流决定:有的输出图片,有的输出 GIF,少数输出 MP4。需要 MP4 时请选视频类工作流,或改用平台的视频模型接口(
/api/v1/videos)。
云存储计费(按量转售)
实例自带磁盘有免费额度,超出部分按小时计费:
| 项目 | 说明 |
|---|---|
| 系统盘 | 40 GB 免费 |
| 数据盘 | 50 GB 免费 |
| 超出部分 | ¥0.0004 / GB / 小时(约 0.5 厘/GB/小时) |
换算参考:
| 超额容量 | 每小时 | 每天(24h) | 每月(30天) |
|---|---|---|---|
| 10 GB | ¥0.0049 | ¥0.1176 | ¥3.53 |
| 100 GB | ¥0.049 | ¥1.176 | ¥35.28 |
| 500 GB | ¥0.245 | ¥5.88 | ¥176.4 |
| 1 TB | ¥0.5018 | ¥12.04 | ¥361.2 |
⚠️ 关机只停计算费,存储费照常计。不用时请清理大文件或销毁实例释放磁盘。
实例价格(点 / 小时)
| GPU 型号 | 每小时 | 每天 |
|---|---|---|
| RTX 3090 | 151.8 点 | 3097 点 |
| RTX 4080 | 239.8 点 | 4892 点 |
| RTX 4090 D | 261.8 点 | 6283 点 |
| nGPU-32GB | 240.9 点 | 4915 点 |
| nGPU-48GB | 327.8 点 | 6923 点 |
| RTX 5090 | 344.3 点 | 8263 点 |
| 6000D-84G | 624.8 点 | 13495 点 |
1 元 = 100 点。关机后不再收取计算费;存储按 GB 小时计。
计费规则(按运行时长,关机即结算)
| 阶段 | 计费行为 |
|---|---|
| 创建实例 | 预扣:时长 × 每小时点数 + 首小时存储费 |
| 运行中 | 按秒累计运行时长计费 |
| 关机 | 立即结算:按实际运行时长扣费,未用预扣点数当场退回 |
| 关机后 | 只收存储费(基础 90GB ≈ 4.41 点/小时),不收计算费 |
| 再开机 | 重新开始累计运行时长,按小时扣计算费 |
| 销毁 | 停止全部计费,退还首小时未用存储费 |
示例(RTX 4090 D,2 小时,90GB 盘):
创建预扣:642.6(计算 2h)+ 4.41(存储 1h)= 647.01 点
运行 33 秒后关机 → 实际计算费 2.91 点 → 当场退回 639.69 点
销毁 → 再退未用存储 4.32 点
最终只花了 3.0 点(约 ¥0.03)
查消费明细
curl "https://api.a7w.cn/api/v1/gpu/billing?limit=100" \
-H "Authorization: Bearer $API_KEY"
{
"entries": [
{ "at": 1794120000000, "type": "charge", "amount": 2.91, "kind": "instance",
"balanceAfter": 21749.25, "reference": "gpu:settle:compute_refund:gpu_xxx" }
],
"summary": { "points": 3622.86, "refund": 2802.23, "net": 820.63,
"instance": 3553.41, "workflow": 69.45, "storage": 0 }
}
网页版:https://api.a7w.cn/gpu.html → 「消费明细」Tab(含累计消费/退款/实付与逐笔记录)。
计费
| 项目 | 规则 |
|---|---|
| 实例 | 按型号固定点数计费(见下表),1 元 = 100 点 |
| 工作流 | 每次 11 点起 |
| 失败 | 全额退回 |
| 销毁 | 按实际使用时长结算,未用部分退回 |
示例:RTX 4090 D 单卡 1 小时 = 261.8 点(¥2.62)。
产物格式说明(重要)
工作流的产物类型由工作流本身决定,不一定是 MP4:
| 产物 | 说明 |
|---|---|
| 图片 | 直接可看 |
| GIF 动图 | 部分视频工作流输出 GIF,文件能播但体积大、没有音轨 |
| MP4 | 少数工作流直接输出 MP4 |
如果拿到的是 GIF 但需要 MP4,三种做法:
- 换一个输出 MP4 的工作流(查
workflows/execution返回的outputs字段,看是*_gifs_*还是*_videos_*); - 用平台视频接口
POST /api/v1/videos(Seedance / muse-video 等,原生 MP4); - 自己用 ffmpeg 转:
ffmpeg -i in.gif -pix_fmt yuv420p -movflags +faststart out.mp4。
常见问题
| 问题 | 说明 |
|---|---|
| 实例没有 SSH | 该镜像只开放 Jupyter/WebUI;换带 SSH 的镜像即可 |
| 开机多久 | 首次创建约 20–30 秒;关机后再开约 20 秒 |
server_url 打不开 | 实例已关机,先 start |
| 想长期保留环境 | 在 Jupyter 里装好后「保存为镜像」 |
| 计费从什么时候开始 | 从创建成功开始按小时计,关机后不再计计算费 |
错误码与排查
| code | 含义 | 处理建议 |
|---|---|---|
insufficient_points | 点数不足 | 充值后重试 |
unauthorized | Key 无效或未实名 | 检查 Key、完成实名 |
instance_not_found | 实例不存在 | 可能已销毁,重新创建 |
create_failed | 创建失败(缺货/上游) | 预扣已自动退回,换机型重试 |
rate_limited | 请求过于频繁 | 按 Retry-After 等待后重试 |
upstream_error | 上游异常 | 1–3 秒后指数退避重试 |
hidden_workflow | 工作流暂未开放 | 关注公告 |
限流
| 维度 | 限制 |
|---|---|
| 单 Key 请求 | 60 次/分钟 |
| 并发任务 | 10 个 |
| 创建实例 | 10 次/分钟 |
超限返回 429,响应头带 Retry-After(秒)。
重试建议
- 4xx(除 429):不要重试,先修参数
- 429:按
Retry-After等待 - 5xx / 超时:指数退避重试,最多 3 次
- 创建类接口:先查实例列表再重试,避免重复开机扣费
版本策略
| 项目 | 规则 |
|---|---|
| 当前版本 | v1(路径 /api/v1) |
| 兼容承诺 | v1 内不删除字段、不改变已有字段语义 |
| 新增字段 | 可能随时新增,客户端应忽略未知字段 |
| 废弃流程 | 先标记 deprecated 并公告,至少保留 90 天 |
| 破坏性变更 | 通过新版本路径(如 /api/v2)发布 |
| 变更通知 | 文档中心「更新日志」+ 页面公告 |