API ドキュメント

クイックスタート

1. 移動先： API コンソール でキーを作成します。cgw-sk-... の値をコピーしてください。表示されるのは一度だけです。
2. 残高をチャージ： お支払い。1 つの残高で 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.

エンドポイント

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);

料金と課金

モデルに応じて、トークン単位、画像単位、文字単位、または音声の秒単位でお支払いいただきます。全モデルの現在の料金は 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.

モデル別の料金表はランディングページをご覧ください.

GPU インスタンス

同じ API キーで GPU のレンタルもできます。掲載中の GPU の一覧取得、テンプレートからのインスタンス起動、running になるまでのポーリング、SSH 情報と公開 API エンドポイントの取得、インスタンスの削除が可能です。課金は Web コンソールと同じく分単位で、同じ残高から差し引かれます。

このセクションは REST API についての説明です。すべてのアカウントが同じ API キーで利用できます。1 つのアカウントで同時に実行できるインスタンス数はチャージ履歴によって異なり、一度もチャージしていないアカウントは 1、初回チャージ後は 3、累計チャージ額が $100 に達すると 10 になります。

Cursor、Cline、opencode、Claude Code などの AI コーディングアシスタントをお使いですか？CloudGPU MCP サーバー はこの API をラップしており、アシスタントが GPU のレンタル、ジョブの実行、結果のダウンロード、シャットダウンまで行えます。

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.

その他の制限：キーごとに 1 時間あたり 20 回の作成、1 分あたり 60 回の GPU API リクエスト。実際のワークロードで引き上げが必要な場合は support@cloudgpu.app までご連絡ください。

レート制限

これらのデフォルト値はパブリックベータ期間中の不正利用を防ぐためのものです。引き上げが必要な場合はお問い合わせください。正当なワークロードであれば喜んで対応します。用途だけお知らせください。

エラー

エラーレスポンスは OpenAI と同じ形式です：HTTP ステータスコード + JSON ボディ { error: { type, code, message } }.