GPU 实例 · API 文档

用同一个平台 API Key 调用 GPU 算力:查型号、开机器、拿 Jupyter/SSH、关机销毁,全程按小时计费。

接入信息

项目值
接口根地址https://api.a7w.cn/api/v1/gpu
鉴权Authorization: Bearer <你的 API Key>(与平台其他接口同一把 Key)
计费单位1 元 = 100 点
计费方式按小时预扣,销毁时按实际时长退款

接口一览

接口方法说明
/api/v1/gpu/modelsGETGPU 型号与售价
/api/v1/gpu/imagesGET算力市场镜像
/api/v1/gpu/podsGET应用商店 Pod(ComfyUI 等)
/api/v1/gpu/instancesPOST创建实例(镜像或 Pod)
/api/v1/gpu/instancesGET我的实例列表
/api/v1/gpu/instances/{id}GET实例详情(含连接地址)
/api/v1/gpu/instances/{id}/sshGETSSH 连接信息
/api/v1/gpu/instances/{id}/startPOST开机
/api/v1/gpu/instances/{id}/stopPOST关机
/api/v1/gpu/instances/{id}/rebootPOST重启
/api/v1/gpu/instances/{id}/destroyPOST销毁(退未用时长)
/api/v1/gpu/pool/acquirePOST申请可用节点(无则自动开机)
/api/v1/gpu/pool/touchPOST上报活跃(重置空闲计时)
/api/v1/gpu/workflowsGET工作流市场
/api/v1/gpu/workflows/infoGET工作流参数清单
/api/v1/gpu/workflows/runPOST提交工作流
/api/v1/gpu/workflows/executionGET查询进度与产物

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 3090151.8 点3097 点
RTX 4080239.8 点4892 点
RTX 4090 D261.8 点6283 点
nGPU-32GB240.9 点4915 点
nGPU-48GB327.8 点6923 点
RTX 5090344.3 点8263 点
6000D-84G624.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,三种做法:

  1. 换一个输出 MP4 的工作流(查 workflows/execution 返回的 outputs 字段,看是 *_gifs_* 还是 *_videos_*);
  2. 用平台视频接口 POST /api/v1/videos(Seedance / muse-video 等,原生 MP4);
  3. 自己用 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点数不足充值后重试
unauthorizedKey 无效或未实名检查 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)发布
变更通知文档中心「更新日志」+ 页面公告

同类文章