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

  1. Buka Konsol API lalu buat kunci. Salin nilai cgw-sk-... — hanya ditampilkan sekali.
  2. Isi saldo Anda lewat Tagihan. Satu saldo untuk panggilan API dan sewa GPU.
  3. Kirim permintaan:
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."} ] }'

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

MetodeJalurKegunaan
POST/v1/chat/completionsChat completion format OpenAI. Bentuk permintaan/respons sama dengan OpenAI.
GET/v1/modelsDaftar model yang tersedia + harga per token saat ini.
POST/v1/messagesFormat Claude Messages API, untuk Claude Code dan Anthropic SDK (base URL https://cloudgpu.app).
POST/v1/messages/count_tokensHitung token input sebuah permintaan Messages tanpa menjalankannya.
POST/v1/images/generationsPembuatan gambar (FLUX, Qwen-Image, Seedream), format images OpenAI.
POST/v1/audio/speechTeks ke suara, format audio OpenAI.
POST/v1/audio/transcriptionsSuara ke teks (unggah multipart), format audio OpenAI.
POST/v1/videosBuat 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}/contentUnduh 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.

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

MetodeJalurKegunaan
GET/v1/gpu/accountSaldo dalam USD, berapa instance yang boleh berjalan bersamaan, dan berapa yang berjalan sekarang.
GET/v1/gpu/offersKartu yang disewakan: model, VRAM, harga per jam, ketersediaan (none / low / ok), jumlah kartu minimum.
GET/v1/gpu/templatesTemplate: id, nama, kartu yang disarankan, apakah menyediakan endpoint API publik.
POST/v1/gpu/instancesJalankan 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/instancesInstance 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 menit100 permintaan
Per akun, per hari10.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 } }.

StatuskodeKapan terjadi
401missing_authorizationTidak ada header Authorization.
401invalid_api_keyKunci tidak dikenal atau sudah dicabut.
400model_not_foundID model tidak ada di katalog. Lihat GET /v1/models.
402insufficient_balanceSaldo di bawah $0,01. Silakan isi saldo.
429rate_limit_exceededBatas per menit atau per hari tercapai.
503upstream_not_configuredModel ini sementara tidak tersedia. Coba lagi nanti atau gunakan model lain.