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。

快速上手

  1. 打开 API 控制台,建一把密钥。把 cgw-sk-... 那串复制走 —— 只显示一次。
  2. 充值余额,入口在 账单页。API 调用和 GPU 租用共用一个余额。
  3. 发一次请求:
cURL
curl 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/completionsOpenAI 格式的对话补全。请求和响应的结构跟 OpenAI 一样。
GET/v1/models列出可用模型,以及当前每 token 的价格。
POST/v1/messagesClaude 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 官方定价页。

  • 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 } }.

状态码什么时候会出现
401missing_authorization没有带 Authorization 请求头。
401invalid_api_key密钥不存在或已被吊销。
400model_not_found模型 id 不在目录里。看 GET /v1/models。
402insufficient_balance余额低于 $0.01。请充值。
429rate_limit_exceeded撞到每分钟或每天的限额了。
503upstream_not_configured这个模型暂时不可用。稍后重试,或换一个模型。

准备好了?

领取 API 密钥