Dokumentasi API
API CloudGPU kompatibel OpenAI: kirim permintaan ke https://cloudgpu.app/v1 dengan header Authorization: Bearer berisi kunci cgw-sk- Anda; kode OpenAI SDK yang sudah ada cukup diganti base_url dan kuncinya. Permintaan berformat Claude Messages dikirim ke https://cloudgpu.app/v1/messages. Di bawah: panduan cepat, lalu autentikasi, endpoint, batas laju, dan error.
Situs resmi CloudGPU hanya cloudgpu.app, dan alamat API hanya https://cloudgpu.app/v1.
Panduan cepat
- Buka Konsol API lalu buat kunci. Salin nilai
cgw-sk-...— hanya ditampilkan sekali. - Isi saldo Anda lewat Tagihan. Satu saldo untuk panggilan API dan sewa GPU.
- Kirim permintaan:
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."} ] }'
Autentikasi
Setiap permintaan ke /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.
Endpoint
| Metode | Jalur | Kegunaan |
|---|---|---|
| POST | /v1/chat/completions | Chat completion format OpenAI. Bentuk permintaan/respons sama dengan OpenAI. |
| GET | /v1/models | Daftar model yang tersedia + harga per token saat ini. |
| POST | /v1/messages | Format Claude Messages API, untuk Claude Code dan Anthropic SDK (base URL https://cloudgpu.app). |
| POST | /v1/messages/count_tokens | Hitung token input sebuah permintaan Messages tanpa menjalankannya. |
| POST | /v1/images/generations | Pembuatan gambar (FLUX, Qwen-Image, Seedream), format images OpenAI. |
| POST | /v1/audio/speech | Teks ke suara, format audio OpenAI. |
| POST | /v1/audio/transcriptions | Suara ke teks (unggah multipart), format audio OpenAI. |
| POST | /v1/videos | Buat tugas pembuatan video (Hailuo, Wan). Body: model, prompt, image opsional, resolution, seconds. Biaya dicadangkan saat tugas dibuat dan dikembalikan penuh jika gagal. |
| GET | /v1/videos/{id} | Status tugas: queued, in_progress, completed, atau failed. |
| GET | /v1/videos/{id}/content | Unduh MP4 yang sudah jadi (tersedia selama 24 jam). |
Embeddings belum tersedia.
Streaming
Sertakan "stream": true di body permintaan. Responsnya berupa Server-Sent Events format OpenAI. OpenAI SDK menanganinya secara transparan.
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
Kami tidak menyediakan SDK sendiri — OpenAI SDK bisa langsung dipakai dengan base_url override.
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);
Harga & penagihan
Anda membayar per token, per gambar, per karakter, atau per detik audio, tergantung modelnya; tarif terkini setiap model ada di tabel harga di https://cloudgpu.app/api. Tidak ada yang dihitung per jam dan tidak ada minimum bulanan.
Each request deducts from your prepaid balance. Successful calls show in your konsol within ~1 second with full token counts and dollar cost.
Tabel harga lengkap per model ada di halaman utama.
Tarif model Claude
Tarif kami per 1M token untuk model Claude di CloudGPU, berdampingan dengan harga daftar resmi. Harga daftar resmi dicek pada 2026-10-24 di halaman harga resmi Claude.
| Model | Input / output CloudGPU, per 1M token | Harga daftar resmi, input / output, per 1M token | Input ter-cache CloudGPU, per 1M token | Harga daftar resmi cache hit, per 1M token |
|---|---|---|---|---|
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, per 1M token
input $2.00 / output $10.00 / input ter-cache $0.10
Harga daftar resmi, per 1M token
input $4.00 / output $20.00 / cache hit $0.20
Claude Opus 5 claude-opus-5
CloudGPU, per 1M token
input $2.50 / output $12.50 / input ter-cache $0.25
Harga daftar resmi, per 1M token
input $5.00 / output $25.00 / cache hit $0.50
Claude Opus 4.8 claude-opus-4-8
CloudGPU, per 1M token
input $2.50 / output $12.50 / input ter-cache $0.25
Harga daftar resmi, per 1M token
input $5.00 / output $25.00 / cache hit $0.50
Claude Opus 4.7 claude-opus-4-7
CloudGPU, per 1M token
input $2.50 / output $12.50 / input ter-cache $0.25
Harga daftar resmi, per 1M token
input $5.00 / output $25.00 / cache hit $0.50
Claude Opus 4.6 claude-opus-4-6
CloudGPU, per 1M token
input $2.50 / output $12.50 / input ter-cache $0.25
Harga daftar resmi, per 1M token
input $5.00 / output $25.00 / cache hit $0.50
Claude Sonnet 5.5 claude-sonnet-5-5
CloudGPU, per 1M token
input $1.00 / output $5.00 / input ter-cache $0.05
Harga daftar resmi, per 1M token
input $2.00 / output $10.00 / cache hit $0.10
Claude Sonnet 5 claude-sonnet-5
CloudGPU, per 1M token
input $1.00 / output $5.00 / input ter-cache $0.10
Harga daftar resmi, per 1M token
input $2.00 / output $10.00 / cache hit $0.20
Claude Sonnet 4.6 claude-sonnet-4-6
CloudGPU, per 1M token
input $1.50 / output $7.50 / input ter-cache $0.15
Harga daftar resmi, per 1M token
input $3.00 / output $15.00 / cache hit $0.30
Claude Fable 5.1 claude-fable-5-1
CloudGPU, per 1M token
input $5.00 / output $25.00 / input ter-cache $0.125
Harga daftar resmi, per 1M token
input $10.00 / output $50.00 / cache hit $0.25
Claude Fable 5 claude-fable-5
CloudGPU, per 1M token
input $5.00 / output $25.00 / input ter-cache $0.50
Harga daftar resmi, per 1M token
input $10.00 / output $50.00 / cache hit $1.00
Harga daftar resmi bisa berubah setelah tanggal pengecekan; sumbernya adalah halaman harga resmi tersebut. Tarif kami diambil dari tabel harga langsung di /id/api. CloudGPU adalah layanan independen, bukan API Claude resmi.
Instance GPU
Kunci API yang sama juga menyewa GPU: lihat yang tersedia, jalankan instance dari template, poll sampai berjalan, baca detail SSH dan endpoint API publik, hancurkan. Penagihan sama dengan konsol web — per menit, dari saldo yang sama.
Bagian ini tentang REST API. Semua akun bisa memakainya dengan kunci API yang sama. Jumlah instance yang bisa berjalan bersamaan tergantung riwayat isi saldo: 1 untuk akun yang belum pernah isi saldo, 3 setelah isi saldo pertama, 10 setelah total isi saldo $100.
Memakai Cursor, Cline, opencode, Claude Code, atau asisten coding AI lain? Server MCP CloudGPU membungkus API ini sehingga asisten bisa menyewa GPU, menjalankan tugas, mengunduh hasil, dan mematikannya.
| Metode | Jalur | Kegunaan |
|---|---|---|
| GET | /v1/gpu/account | Saldo dalam USD, berapa instance yang boleh berjalan bersamaan, dan berapa yang berjalan sekarang. |
| GET | /v1/gpu/offers | Kartu yang disewakan: model, VRAM, harga per jam, ketersediaan (none / low / ok), jumlah kartu minimum. |
| GET | /v1/gpu/templates | Template: id, nama, kartu yang disarankan, apakah menyediakan endpoint API publik. |
| POST | /v1/gpu/instances | Jalankan instance. Body: gpu_model dan/atau template, opsional gpu_count (1–8) dan model_name. Batas matikan otomatis opsional, dijalankan oleh server kami meski klien Anda terputus: max_minutes (batas waktu setelah mulai), max_spend_usd (anggaran untuk instance ini), idle_minutes (hancurkan setelah GPU menganggur selama ini; 10–1440, 0 = mati). Mengembalikan 202 dengan status creating. setup_script opsional (bash, maks 16 KB): dijalankan sekali sebagai root di latar belakang setelah instance diserahkan; output di /root/cloudgpu-setup.log. gpu_model bisa diisi “auto”: kami pilih GPU tersedia yang bisa menjalankannya, berdasarkan harga; jika GPU yang Anda pilih tidak bisa menjalankan template, pesan error mencantumkan GPU yang bisa beserta harga saat ini. disk_gb opsional (100, 200, atau 500): disk sistem yang lebih besar untuk bobot model, dikenai biaya per jam di atas tarif GPU; kosongkan atau 0 untuk disk standar. |
| GET | /v1/gpu/instances | Instance Anda yang berjalan, sedang dimulai, dan baru saja berhenti. |
| GET | /v1/gpu/instances/{id} | Satu instance: status, host/port/user/password SSH, api_url, menit berjalan, biaya sejauh ini, dan limits (pengaturan matikan otomatis, expires_at, dan stopped_by bila dihentikan oleh batas). |
| DELETE | /v1/gpu/instances/{id} | Hancurkan instance dan selesaikan tagihan. POST /v1/gpu/instances/{id}/destroy melakukan hal yang sama. |
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.Batas lain: 20 pembuatan per jam dan 60 permintaan GPU API per menit per kunci. Hubungi support@cloudgpu.app untuk menaikkannya bagi beban kerja nyata.
Batas laju
| Per kunci API, per menit | 100 permintaan |
| Per akun, per hari | 10.000 permintaan |
Nilai bawaan ini untuk mencegah penyalahgunaan selama beta publik. Hubungi kami kalau perlu dinaikkan — dengan senang hati untuk beban kerja yang nyata, cukup beri tahu kasus penggunaannya.
Kesalahan
Respons kesalahan mengikuti bentuk OpenAI: kode status HTTP + body JSON { error: { type, code, message } }.
| Status | kode | Kapan terjadi |
|---|---|---|
| 401 | missing_authorization | Tidak ada header Authorization. |
| 401 | invalid_api_key | Kunci tidak dikenal atau sudah dicabut. |
| 400 | model_not_found | ID model tidak ada di katalog. Lihat GET /v1/models. |
| 402 | insufficient_balance | Saldo di bawah $0,01. Silakan isi saldo. |
| 429 | rate_limit_exceeded | Batas per menit atau per hari tercapai. |
| 503 | upstream_not_configured | Model ini sementara tidak tersedia. Coba lagi nanti atau gunakan model lain. |