API 文档
CloudGPU 接口兼容 OpenAI:请求发到 https://cloudgpu.app/v1,Authorization: Bearer 头里带上你的 cgw-sk- 密钥;已有的 OpenAI SDK 代码只需换 base_url 和密钥。Claude Messages 格式的请求发到 https://cloudgpu.app/v1/messages。下面先是快速上手,然后是认证、接口、速率限制和错误。
CloudGPU 官网只有 cloudgpu.app,API 地址只有 https://cloudgpu.app/v1。
快速上手
cURLcurl https://cloudgpu.app/v1/chat/completions \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $CLOUDGPU_API_KEY" \ -d '{ "model": "deepseek-v4-flash", "messages": [ {"role": "system", "content": "You are a helpful assistant."}, {"role": "user", "content": "Say hi in one sentence."} ] }'
鉴权
每一次请求 /v1/* requires an Authorization: Bearer cgw-sk-<your_key> header. Keys are scoped to your CloudGPU account. Revoke any key any time from the console; revocation takes effect immediately.
The raw key is shown exactly once at creation time. We store only a sha256 hash; we cannot recover it if you lose it. Create a new key if that happens.
接口
| 方法 | 路径 | 用途 |
|---|---|---|
| POST | /v1/chat/completions | OpenAI 格式的对话补全。请求和响应的结构跟 OpenAI 一样。 |
| GET | /v1/models | 列出可用模型,以及当前每 token 的价格。 |
| POST | /v1/messages | Claude Messages API 格式,给 Claude Code 和 Anthropic SDK 用(base URL 填 https://cloudgpu.app)。 |
| POST | /v1/messages/count_tokens | 不实际调用,先数一个 Messages 请求的输入 token 数。 |
| POST | /v1/images/generations | 图像生成(FLUX、Qwen-Image、Seedream),OpenAI images 格式。 |
| POST | /v1/audio/speech | 文字转语音,OpenAI audio 格式。 |
| POST | /v1/audio/transcriptions | 语音转文字(multipart 上传),OpenAI audio 格式。 |
| POST | /v1/videos | 创建视频生成任务(海螺、万相)。参数:model、prompt、可选 image、resolution、seconds。建任务时预扣费用,生成失败全额退回。 |
| GET | /v1/videos/{id} | 任务状态:queued、in_progress、completed 或 failed。 |
| GET | /v1/videos/{id}/content | 下载生成好的 MP4(24 小时内有效)。 |
暂不提供 Embeddings。
流式输出
在请求体里带上 "stream": true。响应是 OpenAI 格式的 Server-Sent Events。OpenAI SDK 会自己处理好。
Python (streaming)# Streaming — same client, stream=True for chunk in client.chat.completions.create( model="deepseek-v4-flash", messages=[{"role": "user", "content": "Count to 5."}], stream=True, ): delta = chunk.choices[0].delta.content if delta: print(delta, end="", flush=True)
SDK
我们不做自己的 SDK —— OpenAI SDK 原样就能用,只要改 base_url 覆盖。
Python# pip install openai>=1.0 from openai import OpenAI client = OpenAI( api_key="cgw-sk-...", # from /api/console base_url="https://cloudgpu.app/v1", ) resp = client.chat.completions.create( model="deepseek-v4-flash", messages=[{"role": "user", "content": "Say hi."}], ) print(resp.choices[0].message.content) print(f"Used {resp.usage.total_tokens} tokens")
Node.js// npm install openai import OpenAI from "openai"; const client = new OpenAI({ apiKey: process.env.CLOUDGPU_API_KEY, baseURL: "https://cloudgpu.app/v1", }); const resp = await client.chat.completions.create({ model: "deepseek-v4-flash", messages: [{ role: "user", content: "Say hi." }], }); console.log(resp.choices[0].message.content);
价格与计费
按模型不同,按 token、按张、按字符或按音频秒数计费;每个模型的当前价格见 https://cloudgpu.app/api 上的价目表。不按时长计量,也没有月度消费门槛。
Each request deducts from your prepaid balance. Successful calls show in your 控制台 within ~1 second with full token counts and dollar cost.
完整的分模型价目表在介绍页.
Claude 模型价格
CloudGPU 上 Claude 模型的每 1M tokens 价格,旁边列出官方标价。官方标价核对日期:2026-10-24,来源:Claude 官方定价页。
| 模型 | CloudGPU 输入 / 输出(每 1M tokens) | 官方标价 输入 / 输出(每 1M tokens) | CloudGPU 缓存命中输入(每 1M tokens) | 官方缓存命中标价(每 1M tokens) |
|---|---|---|---|---|
Claude Opus 5.5 claude-opus-5-5 | $2.00 / $10.00 | $4.00 / $20.00 | $0.10 | $0.20 |
Claude Opus 5 claude-opus-5 | $2.50 / $12.50 | $5.00 / $25.00 | $0.25 | $0.50 |
Claude Opus 4.8 claude-opus-4-8 | $2.50 / $12.50 | $5.00 / $25.00 | $0.25 | $0.50 |
Claude Opus 4.7 claude-opus-4-7 | $2.50 / $12.50 | $5.00 / $25.00 | $0.25 | $0.50 |
Claude Opus 4.6 claude-opus-4-6 | $2.50 / $12.50 | $5.00 / $25.00 | $0.25 | $0.50 |
Claude Sonnet 5.5 claude-sonnet-5-5 | $1.00 / $5.00 | $2.00 / $10.00 | $0.05 | $0.10 |
Claude Sonnet 5 claude-sonnet-5 | $1.00 / $5.00 | $2.00 / $10.00 | $0.10 | $0.20 |
Claude Sonnet 4.6 claude-sonnet-4-6 | $1.50 / $7.50 | $3.00 / $15.00 | $0.15 | $0.30 |
Claude Fable 5.1 claude-fable-5-1 | $5.00 / $25.00 | $10.00 / $50.00 | $0.125 | $0.25 |
Claude Fable 5 claude-fable-5 | $5.00 / $25.00 | $10.00 / $50.00 | $0.50 | $1.00 |
Claude Opus 5.5 claude-opus-5-5
CloudGPU(每 1M tokens)
输入 $2.00 / 输出 $10.00 / 缓存命中输入 $0.10
官方标价(每 1M tokens)
输入 $4.00 / 输出 $20.00 / 缓存命中 $0.20
Claude Opus 5 claude-opus-5
CloudGPU(每 1M tokens)
输入 $2.50 / 输出 $12.50 / 缓存命中输入 $0.25
官方标价(每 1M tokens)
输入 $5.00 / 输出 $25.00 / 缓存命中 $0.50
Claude Opus 4.8 claude-opus-4-8
CloudGPU(每 1M tokens)
输入 $2.50 / 输出 $12.50 / 缓存命中输入 $0.25
官方标价(每 1M tokens)
输入 $5.00 / 输出 $25.00 / 缓存命中 $0.50
Claude Opus 4.7 claude-opus-4-7
CloudGPU(每 1M tokens)
输入 $2.50 / 输出 $12.50 / 缓存命中输入 $0.25
官方标价(每 1M tokens)
输入 $5.00 / 输出 $25.00 / 缓存命中 $0.50
Claude Opus 4.6 claude-opus-4-6
CloudGPU(每 1M tokens)
输入 $2.50 / 输出 $12.50 / 缓存命中输入 $0.25
官方标价(每 1M tokens)
输入 $5.00 / 输出 $25.00 / 缓存命中 $0.50
Claude Sonnet 5.5 claude-sonnet-5-5
CloudGPU(每 1M tokens)
输入 $1.00 / 输出 $5.00 / 缓存命中输入 $0.05
官方标价(每 1M tokens)
输入 $2.00 / 输出 $10.00 / 缓存命中 $0.10
Claude Sonnet 5 claude-sonnet-5
CloudGPU(每 1M tokens)
输入 $1.00 / 输出 $5.00 / 缓存命中输入 $0.10
官方标价(每 1M tokens)
输入 $2.00 / 输出 $10.00 / 缓存命中 $0.20
Claude Sonnet 4.6 claude-sonnet-4-6
CloudGPU(每 1M tokens)
输入 $1.50 / 输出 $7.50 / 缓存命中输入 $0.15
官方标价(每 1M tokens)
输入 $3.00 / 输出 $15.00 / 缓存命中 $0.30
Claude Fable 5.1 claude-fable-5-1
CloudGPU(每 1M tokens)
输入 $5.00 / 输出 $25.00 / 缓存命中输入 $0.125
官方标价(每 1M tokens)
输入 $10.00 / 输出 $50.00 / 缓存命中 $0.25
Claude Fable 5 claude-fable-5
CloudGPU(每 1M tokens)
输入 $5.00 / 输出 $25.00 / 缓存命中输入 $0.50
官方标价(每 1M tokens)
输入 $10.00 / 输出 $50.00 / 缓存命中 $1.00
官方标价在核对日期之后可能调整,以官方定价页为准。我们的价格取自 /zh/api 价目表的实时数据。CloudGPU 是独立服务,不是 Claude 官方接口。
GPU 实例
同一把 API key 也能租 GPU:看货架、按模板开机、轮询到运行中、读 SSH 信息和公网 API 地址、销毁。计费和网页完全一样:按分钟、扣同一个余额。
这一节讲 REST 接口。所有账号都能用,同一把 API key。一个账号同时能开几台看充值记录:从没充值过的账号 1 台,充过值的 3 台,累计充值满 $100 的 10 台。
在用 Cursor、Cline、opencode、Claude Code 等 AI 编程助手?CloudGPU MCP 服务器把这套接口包好了,助手可以直接租卡、跑任务、取回结果并关机。
| 方法 | 路径 | 用途 |
|---|---|---|
| GET | /v1/gpu/account | 余额(美元)、这个账号同时能开几台、现在开着几台。 |
| GET | /v1/gpu/offers | 可租的卡:型号、显存、每小时价格、有货情况(none / low / ok)、最少几张。 |
| GET | /v1/gpu/templates | 模板:id、名称、推荐卡型、是否带公网 API 端点。 |
| POST | /v1/gpu/instances | 开机。请求体:gpu_model 和/或 template,可选 gpu_count(1–8)与 model_name。可选自动关机限额,由我们的服务器执行,客户端断开也照样生效:max_minutes(开机后最多跑多少分钟)、max_spend_usd(这一台最多花多少美元)、idle_minutes(GPU 闲置这么久就销毁;10–1440,0 = 关闭)。返回 202,状态 creating。 可选 setup_script(bash,最长 16 KB):机器交付后以 root 在后台执行一次,输出在 /root/cloudgpu-setup.log。 gpu_model 可以填「auto」:由我们从现在能开、能跑这个模板的卡里按价格挑一张;指定的卡跑不了这个模板时,报错里会列出能跑的卡和当前价格。 可选 disk_gb(100、200 或 500):更大的系统盘,用来放模型权重,在 GPU 单价之外按小时另收;不传或 0 为标准盘。 |
| GET | /v1/gpu/instances | 你在跑、在开和最近停掉的实例。 |
| GET | /v1/gpu/instances/{id} | 单个实例:状态、SSH 主机/端口/用户/密码、api_url、已运行分钟数、目前费用,以及 limits(自动关机设置、expires_at,被限额关掉时的 stopped_by)。 |
| DELETE | /v1/gpu/instances/{id} | 销毁实例并结算。POST /v1/gpu/instances/{id}/destroy 等价。 |
curl -X POST https://cloudgpu.app/v1/gpu/instances \
-H "Authorization: Bearer $CLOUDGPU_API_KEY" \
-H "Content-Type: application/json" \
-d '{"gpu_model": "RTX 4090", "template": "ollama",
"max_minutes": 120, "max_spend_usd": 2, "idle_minutes": 30}'
# 202 Accepted
{"id":"2096…","object":"gpu.instance","gpu_model":"RTX 4090","gpu_count":1,"template":"ollama",
"status":"creating","ssh":null,"api_url":null,
"limits":{"max_minutes":120,"max_spend_usd":2,"idle_minutes":30,"expires_at":null,"stopped_by":null}, …}
# poll GET /v1/gpu/instances/{id} until status is "running";
# then ssh.host / ssh.port / ssh.password and api_url (for API templates) are filled in.其他限制:每小时最多开 20 台,每把 key 每分钟最多 60 次 GPU API 请求。真实业务需要提高请发邮件到 support@cloudgpu.app。
限流
| 每把密钥每分钟 | 100 次请求 |
| 每个账号每天 | 10000 次请求 |
这些默认值是公测期防滥用用的。需要提额就找我们 —— 只要是真实业务都可以提,说一下用途就行。
错误码
报错的结构和 OpenAI 一样:HTTP 状态码加上 JSON 正文 { error: { type, code, message } }.
| 状态 | 码 | 什么时候会出现 |
|---|---|---|
| 401 | missing_authorization | 没有带 Authorization 请求头。 |
| 401 | invalid_api_key | 密钥不存在或已被吊销。 |
| 400 | model_not_found | 模型 id 不在目录里。看 GET /v1/models。 |
| 402 | insufficient_balance | 余额低于 $0.01。请充值。 |
| 429 | rate_limit_exceeded | 撞到每分钟或每天的限额了。 |
| 503 | upstream_not_configured | 这个模型暂时不可用。稍后重试,或换一个模型。 |
准备好了?
领取 API 密钥