Trên trang này
- Tổng quan
- Tính tiền & quyết toán
- Mức thuê & hàng chờ
- Máy Windows
- Ổ lưu trữ & máy kèm ổ
- Khoá SSH
- Tuỳ chọn nâng cao
- Ảnh Docker riêng
- Mẫu đã lưu
- Tạm dừng & bật lại
- Băng thông & số dư tối thiểu
- Hạn mức chi tiêu
- Luật vắng mặt
- Trạng thái & việc làm được
- Giới hạn theo tài khoản
- Bảo trì & ngừng bán
- Chạy thử với máy mẫu
- Luật riêng của Thuê GPU
- Nhịp thao tác
- Mã lỗi riêng
- GET /gpu/products
- POST /gpu/quote
- POST /gpu/image-check
- GET /gpu/saved-templates
- GET /gpu/saved-templates/info
- POST /gpu/saved-templates/create
- POST /gpu/saved-templates/update
- POST /gpu/saved-templates/delete
- GET /gpu/list
- GET /gpu/info
- GET /gpu/metrics
- GET /gpu/logs
- GET /gpu/charges
- POST /gpu/buy
- POST /gpu/cancel
- POST /gpu/upgrade
- POST /gpu/restart
- POST /gpu/stop
- POST /gpu/start
- POST /gpu/delete
- POST /gpu/limits
- POST /gpu/note
- GET /gpu/volumes
- GET /gpu/volumes/info
- GET /gpu/volumes/charges
- POST /gpu/volumes/create
- POST /gpu/volumes/rename
- POST /gpu/volumes/resize
- POST /gpu/volumes/delete
Tổng quan
Địa chỉ gốc của các endpoint trên trang này:
https://cloudmoon.net/api/v1| Endpoint | Việc | Quyền khoá |
|---|---|---|
GET /gpu/products |
Danh mục thuê GPU — CÙNG dữ liệu trang /gpu (không gọi nhà cung cấp). Linux (type = linux): mỗi card có giá MỖI GIỜ the… | Chỉ đọc |
POST /gpu/quote |
BÁO GIÁ thuê một máy — không trừ tiền, khoá chỉ đọc gọi được. CÙNG bộ kiểm với lệnh thuê (card · mức · mẫu · CUDA · ổ ·… | Chỉ đọc |
POST /gpu/image-check |
KIỂM một ảnh Docker công khai trước khi thuê máy bằng ảnh ấy — CÙNG bộ kiểm với quote / buy và nút «Kiểm ảnh» trên web:… | Chỉ đọc |
GET /gpu/saved-templates |
Mẫu đã lưu của tài khoản, sửa gần nhất trước — cùng danh sách tab «Mẫu của tôi» trên web. Mỗi mẫu = công thức PHẦN MỀM … | Chỉ đọc |
GET /gpu/saved-templates/info |
Một mẫu đã lưu — cùng khối của /gpu/saved-templates + start_command (chữ lệnh khởi động) CHỈ với khoá toàn quyền (khoá … | Chỉ đọc |
POST /gpu/saved-templates/create |
Lưu MỘT mẫu — cùng luật nút «Lưu làm mẫu» trên web. Thân = name + CÙNG các trường phần mềm của /gpu/quote (template + c… | Toàn quyền |
POST /gpu/saved-templates/update |
Sửa một mẫu — id + version (version đang xem: mẫu vừa được sửa ở nơi khác ⇒ 409 TEMPLATE_CHANGED kèm data.version hiện … | Toàn quyền |
POST /gpu/saved-templates/delete |
Xoá một mẫu. version (tuỳ chọn) = version đang xem ⇒ xoá có điều kiện (mẫu vừa được sửa ⇒ 409 TEMPLATE_CHANGED, mẫu còn… | Toàn quyền |
GET /gpu/list |
Máy GPU của tài khoản, mới nhất trước (không kèm mật khẩu). ?status=active (mặc định — đang tìm · đang tạo · đang chạy … | Chỉ đọc |
GET /gpu/info |
Chi tiết một máy GPU: status (searching · provisioning · running · releasing — đã ngừng tính tiền, đang gỡ · settling —… | Chỉ đọc |
GET /gpu/metrics |
Số đo của một máy: current = số SỐNG khi máy đang chạy (GPU % · nhiệt · VRAM · CPU % · RAM · ổ — số máy không báo được … | Chỉ đọc |
GET /gpu/logs |
Nhật ký hoạt động của một máy, mới nhất trước — cùng nhật ký trang máy (tiền giữ / thu / hoàn · giao máy · khởi động lạ… | Chỉ đọc |
GET /gpu/charges |
Sổ tiền từng khoản của một máy, mới nhất trước. amount có dấu: dương = trừ ví · âm = hoàn về ví. type: hold (giữ trước … | Chỉ đọc |
POST /gpu/buy |
Thuê một máy GPU — BẤT ĐỒNG BỘ: trả HTTP 202 kèm order_code, hệ thống giữ trước tiền ở bước đầu (Linux theo mức: ngay s… | Toàn quyền |
POST /gpu/cancel |
Huỷ đơn Linux theo mức đang TÌM MÁY (status searching) — hoàn ĐỦ tiền giữ trước. Máy vừa được tạo cho đơn ⇒ 409 MACHINE… | Toàn quyền |
POST /gpu/upgrade |
Chuyển đơn TIẾT KIỆM đang tìm máy sang THUÊ NHANH: giữ THÊM (giá nhanh − giá tiết kiệm) × giờ giữ NGAY, hạn chờ mới 10 … | Toàn quyền |
POST /gpu/restart |
Khởi động lại máy đang chạy. Mỗi máy một lần / 3 phút (chung web và API) — gửi sớm ⇒ 429 COOLDOWN kèm Retry-After. Khởi… | Toàn quyền |
POST /gpu/stop |
TẠM DỪNG máy đang chạy, GIỮ ĐĨA (phần mềm · mô hình · tệp trong máy còn nguyên) — chỉ máy Linux thuê theo mức (pause.su… | Toàn quyền |
POST /gpu/start |
BẬT LẠI máy đang tạm dừng (status paused) — đúng máy ấy, đĩa còn nguyên. Giữ trước hold_hours giờ chạy theo giá máy (ho… | Toàn quyền |
POST /gpu/delete |
TRẢ MÁY = DỪNG TÍNH TIỀN ngay (máy bị gỡ cùng dữ liệu, không khôi phục — máy kèm ổ lưu trữ: dữ liệu trong /workspace nằ… | Toàn quyền |
POST /gpu/limits |
Hạn mức chi tiêu của máy đang chạy: max_amount (tổng tiền tối đa, đ) · max_hours (số giờ chạy tối đa) — 0 = bỏ mức ấy, … | Toàn quyền |
POST /gpu/note |
Ghi chú máy (nhãn cho script): ≤ 100 ký tự một dòng, khoảng trắng gộp lại; chuỗi rỗng = bỏ ghi chú. Ghi được ở mọi trạn… | Toàn quyền |
GET /gpu/volumes |
Ổ lưu trữ của tài khoản, mới nhất trước — CÙNG số khối ổ trên trang Thuê GPU. Ổ gắn vào máy GPU / CPU kèm ổ ở /workspac… | Chỉ đọc |
GET /gpu/volumes/info |
Chi tiết MỘT ổ lưu trữ — cùng khối của /gpu/volumes + charges_summary (tổng trừ · tổng hoàn · ròng của ổ). Ổ của tài kh… | Chỉ đọc |
GET /gpu/volumes/charges |
Sổ tiền từng khoản của một ổ, mới nhất trước. amount có dấu: dương = trừ ví · âm = hoàn về ví. type: daily (thu một ngà… | Chỉ đọc |
POST /gpu/volumes/create |
Tạo ổ lưu trữ — trừ NGAY tiền ngày đầu (size_gb × price_gb_day) từ số dư, rồi thu trước từng ngày theo giá chốt lúc tạo… | Toàn quyền |
POST /gpu/volumes/rename |
Đặt / bỏ tên ổ lưu trữ (nhãn để phân biệt nhiều ổ): ≤ 40 ký tự — chữ · số (mọi thứ tiếng) · khoảng trắng và . _ - ( ) #… | Toàn quyền |
POST /gpu/volumes/resize |
Tăng dung lượng ổ lưu trữ (chỉ TĂNG, không giảm): trừ NGAY phần chênh (size_gb mới − cũ) × price_gb_day tính tới mốc th… | Toàn quyền |
POST /gpu/volumes/delete |
XOÁ ổ lưu trữ = NGỪNG TÍNH TIỀN ngay — ổ bị xoá cùng TOÀN BỘ dữ liệu /workspace, không khôi phục được; KHÔNG hoàn ngày … | Toàn quyền |
Giá đại lý: Giá như nhau với mọi tài khoản — không có chiết khấu đại lý. — xem mục Tài khoản đại lý.
Tính tiền & quyết toán
Thuê GPU trả từ số dư ví của tài khoản, giá như nhau với mọi tài khoản. Bạn trả cho thời gian máy chạy; máy chưa có thì chưa tính đồng nào.
- Giữ trước 1 giờ ở bước đầu của đơn — Linux theo mức: ngay sau lệnh thuê (vài giây); Windows: khi đã thấy máy hợp giá tối đa:
hold_amount=price_hour× 1 (Windows:max_price_hour× 1), trừ từ số dư khả dụng (dòngholdở/gpu/charges). Không có máy (hết thời gian chờ, không tạo được, bạn huỷ) ⇒ phần đã giữ được hoàn đủ. - Máy Linux tính theo PHÚT (tối thiểu 5 phút) từ mốc
billing.started_at— thường là lúc máy lên, có thể sớm hơn lúc giao (delivered_at) vài phút; máy Windows tính TRÒN GIỜ. Dùng hết phần đã giữ, hệ thống tự trừ tiếp từng giờ một — mốc đã trả tới nằm ởbilling.paid_until; máy Windows được trừ giờ kế tiếp sớm khoảng 5 phút trước mốc ấy. - Trả máy (
POST /gpu/delete) ngừng tính phí máy ngay, kể cả khi máy đang được gỡ; phí băng thông chốt theo số cuối sau khi máy gỡ xong (gồm phần phát sinh trong lúc gỡ; đọc số cuối hỏng quá lâu thì chốt theo phần đã thu). Vài phút sau đơn được quyết toán: phí máy tròn phút (Linux) hoặc tròn giờ (Windows) cộng phí băng thông; phần đã trừ mà chưa dùng hoàn về số dư, dùng quá phần đã trừ thì thu bù. Số chốt nằm ởbilling.settlement(fee·bandwidth_fee·refunded·debt·used_seconds), từng khoản ởGET /gpu/charges. - Ví không đủ trừ giờ kế tiếp (hoặc không đủ trả băng thông) ⇒ máy bị trả tự động và quyết toán như trên —
end_reasoninsufficient_balance/bandwidth_balance. Ví không bao giờ âm: phần không thu được ghi ởsettlement.debt.
Khối billing của mỗi máy
mode (minute · hour) · price_hour · min_minutes · charged đã trừ ròng (sau phần hoàn) · machine_fee · bandwidth_fee · bandwidth_gb · bandwidth_price_gb · estimate tạm tính nếu trả máy bây giờ · refund_estimate hoàn ước tính · used_seconds · started_at · paid_until · settlement (khi đã quyết toán): fee = số thực thu của máy — phí máy CỘNG phí băng thông, không gồm phần ghi nợ · bandwidth_fee = phần băng thông (đã tính trong fee; phần ví không đủ trả nằm ở debt) · refunded = tổng đã hoàn về ví · debt = phần chưa thu được · used_seconds; fee + refunded = tổng đã trừ ví cho máy — đừng cộng thêm bandwidth_fee vào fee · máy tròn giờ thêm hour_index · minutes_to_next_hour. Số này là CÙNG số trang máy trên web hiển thị. Máy từng tạm dừng: machine_fee gồm cả phí giữ đĩa — phần ấy tách ở disk_fee (và settlement.disk_fee khi đã quyết toán).
Sổ tiền — GET /gpu/charges
Mỗi dòng một khoản, mới nhất trước, amount có dấu (dương = trừ ví · âm = hoàn về ví); summary.net là ròng của cả đơn — bằng tổng các dòng khi phản hồi chứa đủ các khoản (mặc định 100 dòng, limit tối đa 200). type: hold giữ trước (kể cả giữ thêm khi chuyển nhanh) · period trừ kỳ kế · bandwidth trừ băng thông dần · refund hoàn khi quyết toán · extra_charge / bandwidth_settlement thu bù lúc quyết toán · extra_charge_partial / bandwidth_settlement_partial thu bù khi ví không đủ (phần thiếu ở settlement.debt) · manual_refund bộ phận hỗ trợ hoàn · adjustment điều chỉnh khác. Máy tạm dừng (mục Tạm dừng & bật lại): disk_storage thu trước một giờ giữ đĩa · pause_refund hoàn phần giờ chạy giữ dư lúc dừng · disk_refund hoàn phần giữ đĩa chưa dùng lúc bật lại · resume_refund hoàn khoản giữ khi bật lại không thành; giữ trước lúc bật lại là hold.
Mức thuê & hàng chờ (Linux)
Máy Linux thuê theo MỨC giá cố định — chọn card + tier, hệ thống tự tìm máy đúng loại. Giá mỗi giờ = giá mức × số card một máy (gpu_count) + phụ phí phần ổ vượt 30 GB đã gồm (disk_gb; bỏ trống ⇒ 30 GB = default_disk_gb), làm tròn lên 100đ — đọc ở GET /gpu/products; POST /gpu/quote cho đúng giá lệnh thuê sẽ đòi.
| Mức | Chờ máy tối đa (wait_minutes) | Nghĩa |
|---|---|---|
fast | 10 phút | Giá cao hơn, thường có máy ngay. |
saving | 30 · 60 · 180 phút (chọn một) | Rẻ hơn, có thể phải chờ tới 180 phút mới có máy. |
- Lệnh thuê trả HTTP 202 kèm
order_code,status: "searching". HỏiGET /gpu/infotới khirunning(có khốiconnection) — hoặcexpired(hết thời gian chờ) ·cancelled·failed, ba trường hợp này đều đã hoàn đủ phần tiền đã giữ. - Trong lúc chờ,
infocó khốiwaiting:tier·price_hour·held·wait_minutes·expires_at·seconds_left·fast_price_hour+upgrade_extra_hold+fast_bandwidth_price_gb(đơn tiết kiệm) ·region·filters. - Huỷ lúc nào cũng được khi còn chờ (
POST /gpu/cancel) — hoàn đủ. Máy vừa được tạo cho đơn ⇒409 MACHINE_ASSIGNED: đợirunningrồi trả bằng/gpu/delete(trong lúc khởi tạodeletetrả409 PROVISIONING), chỉ tính thời gian đã dùng. - Chuyển tiết kiệm → nhanh (
POST /gpu/upgradevớiprice_hour=waiting.fast_price_hour): giữ THÊM (giá nhanh − giá tiết kiệm) × 1 giờ ngay, hạn chờ mới 10 phút. Lệnh có trừ tiền ⇒Idempotency-Keybắt buộc. regionchỉ là ưu tiên (vùng ấy hết máy thì lấy máy vùng khác);min_ram_gb·min_vcpu·nvmelà bộ lọc bắt buộc — lọc càng chặt càng ít máy, giá không đổi.- Giá thay đổi giữa lúc bạn xem và lúc thuê ⇒
409 PRICE_CHANGEDkèm giá mới ởdata.price_hour, chưa giữ đồng nào — thân lệnh đã khác nên gửi lại vớiIdempotency-KeyMỚI. Gửi kèmbandwidth_price_gb(tuỳ chọn — giá băng thông đã xem ởquote; vớiupgradelàwaiting.fast_bandwidth_price_gb) để chốt cả giá băng thông: lệch giá hiện hành ⇒ cũng409 PRICE_CHANGED, giá mới ởdata.bandwidth_price_gb. Không gửi ⇒ đơn ghi giá băng thông hiện hành lúc đặt.
Máy Windows
- Chọn một nhóm ở
GET /gpu/products?type=windows(group). Giá khác nhau theo từng máy: bạn đặt giá tối đamax_price_hour—POST /gpu/quote(báo giá sống) gợi ý ba mức ởsuggested_max_priceskèm số máy mỗi mức. Hệ thống lấy máy rẻ nhất không vượt giá tối đa và tính đúng giá máy ấy; có máy hợp giá hay không chỉ biết lúc tìm máy — chưa thấy máy hợp giá thì đơn tự kết, chưa trừ đồng nào; đã giữ tiền mà không tạo được máy thì hoàn đủ (cả haifailed·out_of_capacity;can_ordercủaquotechỉ xét trần tài khoản + số dư). - Tính tròn giờ; giữ trước theo giá tối đa, quyết toán theo giá máy thật — phần chênh hoàn về số dư.
- Vào máy bằng RDP (
connection.rdp) hoặc SSH (connection.ssh), người dùngAdministrator; mật khẩu chỉ trả cho khoá Toàn quyền. - Nhóm tạm hết máy ⇒ danh mục ghi
in_stock: false, lệnh thuê nhận409 OUT_OF_STOCK(chưa giữ tiền). Máy Windows không có hàng chờ theo mức nên không huỷ chờ / chuyển nhanh được (400 NOT_SUPPORTED).
Ổ lưu trữ & máy kèm ổ
Ổ lưu trữ là ổ mạng riêng của tài khoản đặt ở Châu Âu (Romania): gắn vào máy GPU / CPU thuê kèm ổ tại /workspace, dữ liệu trong đó còn nguyên qua các lần thuê và trả máy (ổ hệ điều hành của máy — disk_gb — vẫn mất khi trả máy). Một ổ gắn được vào nhiều máy cùng lúc. Danh mục cỡ ổ + loại máy: GET /gpu/products?type=volume; quản lý ổ: /gpu/volumes · /gpu/volumes/info · /gpu/volumes/charges · create · rename · resize · delete.
Tiền ổ — thu trước từng ngày
Cỡ ổ (size_gb) | Tiền một ngày (98đ / GB / ngày) |
|---|---|
| 20 GB | 1.960đ |
| 50 GB | 4.900đ |
| 100 GB | 9.800đ |
| 200 GB | 19.600đ |
| 500 GB | 49.000đ |
POST /gpu/volumes/createtrừ ngay tiền ngày đầu; sau đó cứ 24 giờ tính từ lúc tạo (mốcpaid_until) hệ thống tự thu ngày kế. Giá chốt lúc tạo (price_gb_daycủa từng ổ) — đổi giá về sau không áp cho ổ đã có.POST /gpu/volumes/resizechỉ tăng: trừ ngay phần chênh (cỡ mới − cỡ cũ) × giá tính tớipaid_until(làm tròn lên), từ mốc ấy tiền ngày theo cỡ mới. Đang có lệnh tăng chưa xong, hoặc còn ≤ 1 phút tới mốc thu ⇒429 IN_PROGRESS.POST /gpu/volumes/deletengừng tính tiền ngay, không hoàn ngày đang dở, xoá cùng toàn bộ dữ liệu (confirm= đúngvolume_code). Còn máy đang gắn ⇒409 VOLUME_IN_USEkèm danh sách — trả máy trước.- Tối đa 10 ổ mỗi tài khoản (ổ đang xoá không tính) — quá ⇒
429 VOLUME_LIMIT; số còn tạo được:quota.remainingở/gpu/volumes,volume.remainingở danh mục. - Tạo và tăng trừ tiền ngay trong lệnh ⇒
Idempotency-Keybắt buộc: gửi lại cùng khoá ⇒ đúng kết quả cũ, không trừ lần hai.charged= số tiền chính lệnh ấy đã trừ. Hệ thống còn đang hoàn tất ⇒status: creating/resizing_to_gb— không làm được thì tự hoàn đủ (ổ thànhfailed· hoàn phần chênh).
Thiếu tiền — giữ ổ 7 ngày
- Tới mốc thu mà số dư không đủ ⇒ ổ chuyển
overdue(overdue_since·delete_at) và bạn nhận email. Dữ liệu còn nguyên, máy đang gắn vẫn chạy; tăng dung lượng hay thuê thêm máy kèm ổ ấy ⇒402 VOLUME_UNPAID. - Nạp ít nhất
amount_due(mọi ngày còn nợ tới hết ngày đang chạy) ⇒ hệ thống tự thu bù một lần (dòngdaily_catch_upở/gpu/volumes/charges) và ổ chạy tiếp. - Còn khoảng một ngày tới
delete_at⇒ email nhắc. Quádelete_at⇒ máy đang gắn bị trả tự động (end_reason: insufficient_balance), rồi ổ bị xoá cùng dữ liệu (end_reason: insufficient_balance), kèm email.
Trạng thái ổ
status | Nghĩa |
|---|---|
creating | Đã trừ ngày đầu, hệ thống đang hoàn tất — không xong thì tự hoàn đủ, ổ thành failed. |
active | Đang dùng, thu tiền theo ngày. |
overdue | Thiếu tiền giữ ổ — xem amount_due · delete_at. |
deleting · deleted | Đã ngừng tính tiền, đang xoá · đã xoá (deleted_at · end_reason). |
failed | Không tạo được — đã hoàn đủ. |
allowed_actions của ổ: rename (đang tạo · đang dùng · thiếu tiền) · resize (đang dùng, còn cỡ lớn hơn để bán, không có lệnh tăng chưa xong, nhánh kèm ổ đang bán) · delete (đang dùng hoặc thiếu tiền, không còn máy gắn). Kèm ổ tạm bảo trì / tạm ngưng nhận lệnh thì resize vẫn hiện nhưng lệnh nhận 503 — gửi lại sau (mục Bảo trì & ngừng bán).
Máy kèm ổ
- Chọn loại máy ở
GET /gpu/products?type=volume(machine— máy GPU, hoặc máy CPUkind: cpu), báo giá bằngPOST /gpu/quotevà thuê bằngPOST /gpu/buyvớitype: "volume"+volume_code(ổactivecủa bạn) +machine+template+cuda(máy GPU; máy CPU để trống) +price_hourđã xem. - Giá theo loại máy, tính theo phút từ lúc máy lên; giữ trước 1 giờ như máy Linux; không tính băng thông; hạn mức
max_amount/max_hoursáp như máy Linux; luật vắng mặt không áp. - Không có hàng chờ theo mức: hệ thống tìm máy trong 180 giây (
search_seconds) — không có máy ⇒ đơnfailed(out_of_capacity), hoàn đủ; ổ không gắn được lúc tạo máy (vừa thiếu tiền / đang xử lý) ⇒failed(volume_unavailable), hoàn đủ.cancel·upgrade⇒400 NOT_SUPPORTED. - Theo dõi bằng
/gpu/info·/gpu/listnhư máy thường: khốimachine{code,kind} ·cpu{vcpu} (máy CPU —gpu: null) ·volume{code,name,size_gb,mount_path,status}. Trả máy (/gpu/delete) không đụng tới ổ.
Khoá SSH
Máy Linux cho đăng nhập root bằng khoá SSH; máy Windows có cổng SSH (connection.ssh) thì đăng nhập bằng Administrator, song song với RDP bằng mật khẩu. Khoá cài vào máy lúc thuê gồm:
- các khoá gửi ở
ssh_keycủa lệnh thuê — một hoặc nhiều dòng, mỗi dòng một khoá công khai (nội dung tệp.pub); - các khoá đã lưu chọn bằng
ssh_key_ids(mã ở/account/ssh-keys); không gửissh_key_idsthì là các khoá bật «tự gắn» đã lưu ở trang Khoá SSH của tài khoản.
- Tối đa 5 khoá một máy (trùng vân tay tính một) — vượt ⇒
400, chưa giữ đồng nào. Nhận ed25519 · RSA từ 2048 bit · ECDSA · khoá bảo mật phần cứng sk-ed25519 / sk-ecdsa; DSA và khoá RIÊNG (private key) bị chối400. - Máy chụp tập khoá lúc thuê: sửa hay xoá khoá trong tài khoản sau đó không đổi máy đang chạy — gỡ khoá khỏi máy bằng cách sửa
~/.ssh/authorized_keystrong máy. quote·buytrảssh_keys= các khoá SẼ được cài (xem trước được);info·listtrảssh_keys= các khoá đã cài vào máy:id·nametheo khoá đã lưu cùng vân tay (nullkhi khoá dán chưa lưu, hoặc đã xoá khỏi tài khoản) ·type·fingerprint(SHA256 nhưssh-keygen -l). Mã khoá không thuộc tài khoản ⇒404 NOT_FOUND, chưa giữ đồng nào.- Máy mẫu chạy thử (
SANDBOX…) không mang khoá —ssh_keysrỗng; phản hồibuychạy thử vẫn trả đúng tập khoá sẽ cài. - Thêm · sửa · xoá khoá qua API: Tài khoản › Khoá SSH (
/account/ssh-keys·create·update·delete).
Tuỳ chọn nâng cao — biến môi trường · cổng · lệnh khởi động
Máy Linux (theo mức) và máy kèm ổ lưu trữ nhận thêm, ngay trong thân quote / buy: biến môi trường, cổng TCP mở ra Internet và một lệnh khởi động chạy nền mỗi lần máy khởi động. Ví dụ đặt HF_TOKEN, mở cổng 8000 và chạy vllm serve … ⇒ máy giao xong là có API mô hình ở public_host:public_port. Máy Windows chưa có tuỳ chọn này (gửi kèm ⇒ 400). Không tính thêm phí.
| Trường | Kiểu | Nghĩa |
|---|---|---|
env · env_gz | object · chuỗi | Biến môi trường {"TEN_BIEN": "giá trị"} — có trong mọi phiên SSH và trong lệnh khởi động. Chỉ gửi một trong hai. |
ports | mảng số | Cổng TCP trong máy mở ra Internet, vd [8000, 7860]. |
start_command · start_command_gz | chuỗi | Lệnh bash chạy nền mỗi lần máy khởi động (nhiều dòng được). Chỉ gửi một trong hai. |
- Biến: tối đa 20 biến; tên gồm chữ, số, dấu gạch dưới, không bắt đầu bằng số, tối đa 64 ký tự; mỗi giá trị ≤ 2.048 byte, tổng tên + giá trị ≤ 8.192 byte; giá trị không chứa ký tự điều khiển / xuống dòng và các ký tự
" ' \ ` $ #— giá trị phức tạp hãy đặt trong lệnh khởi động (export …). Tên dành riêng của hệ thống bị chối (cuối mục). - Cổng: tối đa 5 cổng TCP, mỗi cổng 1–65535, khác 22 (SSH), không trùng. Dịch vụ trong máy phải nghe ở
0.0.0.0(không phải127.0.0.1). Địa chỉ từ Internet làpublic_host:public_portởinfo/listkhi máyrunning— hệ thống cấp, có thể khác cổng trong máy; khởi động lại có thể đổi ⇒ đọc lạiinfo. - Lệnh khởi động: ≤ 4.096 byte; chạy nền bằng
bash -lngay khi máy sẵn sàng và mỗi lần máy khởi động lại, ở thư mục/workspace(không có thì/root), thấy các biến môi trường. Kết quả ghi ở/var/log/gpu-start.logtrong máy (tail -n 50 /var/log/gpu-start.log). Lệnh lỗi hay dừng không ảnh hưởng việc giao máy và tính tiền. - Bảo mật: giá trị biến không bao giờ được trả lại (chỉ
env_names); chữ lệnh chỉ trả ởinfovới khoá Toàn quyền (start_command), không có trongquote·buy·list. Biến và lệnh được lưu mã hoá.
Gửi bản nén khi bị chặn
Một số lệnh hay giá trị gửi thô có thể bị tường lửa web chặn trước khi tới API — câu trả lời khi đó là HTTP 403 với thân là trang HTML (không phải JSON). Gửi bản nén thay thế: start_command_gz / env_gz = nén deflate thô (raw deflate — không đầu zlib / gzip) rồi mã hoá base64. Bản nén hỏng ⇒ 400.
nen() { python3 -c 'import sys,zlib,base64; c=zlib.compressobj(9,zlib.DEFLATED,-15); print(base64.b64encode(c.compress(sys.stdin.buffer.read())+c.flush()).decode())'; }
ENV_GZ=$(printf '%s' '{"HF_TOKEN":"hf_...","MODEL":"Qwen/Qwen3-8B"}' | nen)
CMD_GZ=$(printf '%s' 'vllm serve "$MODEL" --host 0.0.0.0 --port 8000' | nen)
curl -X POST 'https://cloudmoon.net/api/v1/gpu/quote' \
-H 'X-API-Key: ak_...' \
-H 'Content-Type: application/json' \
-d '{"type":"linux","card":"gtx1080ti","tier":"fast","template":"pytorch","cuda":"12.4","ports":[8000],"env_gz":"'"$ENV_GZ"'","start_command_gz":"'"$CMD_GZ"'"}'import base64, json, zlib
import requests
def nen(chu: str) -> str:
c = zlib.compressobj(9, zlib.DEFLATED, -15) # deflate THÔ: wbits âm
return base64.b64encode(c.compress(chu.encode()) + c.flush()).decode()
r = requests.post(
"https://cloudmoon.net/api/v1/gpu/quote",
headers={"X-API-Key": "ak_..."},
json={"type": "linux", "card": "gtx1080ti", "tier": "fast", "template": "pytorch", "cuda": "12.4",
"ports": [8000],
"env_gz": nen(json.dumps({"HF_TOKEN": "hf_...", "MODEL": "Qwen/Qwen3-8B"})),
"start_command_gz": nen('vllm serve "$MODEL" --host 0.0.0.0 --port 8000')},
timeout=30,
)
print(r.status_code, r.json())// Node.js 18+ — lưu thành tệp .mjs
import { deflateRawSync } from "node:zlib";
const nen = (chu) => deflateRawSync(Buffer.from(chu, "utf8")).toString("base64");
const res = await fetch("https://cloudmoon.net/api/v1/gpu/quote", {
method: "POST",
headers: {
"X-API-Key": "ak_...",
"Content-Type": "application/json",
},
body: JSON.stringify({
type: "linux", card: "gtx1080ti", tier: "fast", template: "pytorch", cuda: "12.4",
ports: [8000],
env_gz: nen(JSON.stringify({ HF_TOKEN: "hf_...", MODEL: "Qwen/Qwen3-8B" })),
start_command_gz: nen('vllm serve "$MODEL" --host 0.0.0.0 --port 8000'),
}),
});
console.log(res.status, await res.json());<?php
$nen = fn(string $chu): string => base64_encode(gzdeflate($chu)); // gzdeflate = deflate THÔ
$than = [
'type' => 'linux', 'card' => 'gtx1080ti', 'tier' => 'fast', 'template' => 'pytorch', 'cuda' => '12.4',
'ports' => [8000],
'env_gz' => $nen(json_encode(['HF_TOKEN' => 'hf_...', 'MODEL' => 'Qwen/Qwen3-8B'])),
'start_command_gz' => $nen('vllm serve "$MODEL" --host 0.0.0.0 --port 8000'),
];
$ch = curl_init('https://cloudmoon.net/api/v1/gpu/quote');
curl_setopt_array($ch, [CURLOPT_POST => true, CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['X-API-Key: ak_...', 'Content-Type: application/json'],
CURLOPT_POSTFIELDS => json_encode($than)]);
$kq = curl_exec($ch);
echo curl_getinfo($ch, CURLINFO_RESPONSE_CODE), ' ', $kq;Phản hồi
quote·buy(202):ports— mỗi phần tử {port,public_host,public_port} (chưa có máy ⇒null) ·env_names·has_start_command·start_log_path(nullkhi không có lệnh).info·list: như trên, địa chỉ ngoài có khi máyrunning;infovới khoá Toàn quyền thêmstart_command.- Gửi lại cùng
Idempotency-Keymà đổi tuỳ chọn ⇒422 IDEMPOTENCY_MISMATCH(thân lệnh khác) — gửi lại phải đúng thân cũ, kể cả chuỗi nén. - Tính năng tạm ngưng ⇒ lệnh MỚI kèm tuỳ chọn nhận
503 MAINTENANCE; lệnh không kèm tuỳ chọn và máy đang chạy không bị ảnh hưởng. - Máy mẫu chạy thử (
SANDBOX…) không mang tuỳ chọn (ports·env_namesrỗng);quote·buychạy thử vẫn kiểm tuỳ chọn y như lượt thật.
Tên biến dành riêng (không phân biệt hoa thường): PATH · HOME · USER · LOGNAME · SHELL · PWD · OLDPWD · SHLVL · TERM · HOSTNAME · MAIL · IFS · ENV · PROMPT_COMMAND · PS1 · PS2 · PS4 · CDPATH · GLOBIGNORE · HISTFILE · PUBLIC_KEY · JUPYTER_TOKEN · JUPYTER_PASSWORD · UID · EUID · PPID · SHELLOPTS · GROUPS · RANDOM · SRANDOM · SECONDS · LINENO · HISTCMD · FUNCNAME · DIRSTACK · PIPESTATUS · EPOCHSECONDS · EPOCHREALTIME · OPTIND · OPTARG · OPTERR · MACHTYPE · OSTYPE · HOSTTYPE · _ · POSIXLY_CORRECT · EXECIGNORE · FUNCNEST · COLUMNS · LINES; mọi tên bắt đầu bằng CONTAINER_ · CM_ · LD_ · BASH · SSH_; và một số tên khác hệ thống dùng (bị chối với cùng lời báo).
Ảnh Docker riêng
Máy Linux thuê theo mức chạy được ảnh Docker công khai của bạn thay cho mẫu cài sẵn: gửi image (vd vllm/vllm-openai:latest, ghim được …@sha256:<digest>) trong thân quote / buy và bỏ template + cuda. Máy Windows và máy kèm ổ lưu trữ chưa nhận ảnh riêng (gửi kèm ⇒ 400). Không tính thêm phí.
Điều kiện của ảnh
- Công khai (kéo được không cần đăng nhập) ở một registry:
docker.io·ghcr.io·nvcr.io·quay.io·registry.gitlab.com·public.ecr.aws— danh sách ởcustom_image.registriescủa/gpu/products. - Có bản
linux/amd64; nền Ubuntu hoặc Debian 12 trở xuống; chạy bằng root. Nền Debian 13, Alpine, họ Red Hat, Arch, SUSE, BusyBox… và ảnh khaiUSERkhác root bị chối ngay lúc kiểm — vdpython:3.12-slimmặc định là Debian 13, dùngpython:3.12-slim-bookworm. - Nặng tối đa 30 GB nén (bản linux/amd64). Ảnh khai bản CUDA (
NVIDIA_REQUIRE_CUDA/CUDA_VERSION) chỉ chạy trên card hợp bản ấy — gửicardchoimage-checkđể biết trước.
Kiểm trước — POST /gpu/image-check
Thân {"image": "…", "card": "…"} (card tuỳ chọn). Ảnh đạt ⇒ ok: true + image (thêm os và default_command — lệnh gốc ENTRYPOINT + CMD của ảnh). Ảnh không đạt ⇒ vẫn 200 với ok: false + reason + message nói rõ cách sửa. Cả hai mang quota (lượt ở mục dưới). Khoá chỉ đọc gọi được; nhịp chung với nút «Kiểm ảnh» trên web (mục Giới hạn theo tài khoản).
Ảnh chưa có trong bộ đệm (chưa được kiểm trong ít phút gần đây) buộc hệ thống hỏi registry ⇒ mỗi tài khoản kiểm tối đa 20 ảnh mới mỗi giờ (custom_image.uncached_checks_per_hour), tính chung image-check · quote · buy và nút «Kiểm ảnh» trên web. Ảnh vừa kiểm và lượt chạy thử không tính. Quá trần ⇒ 429 RATE_LIMITED kèm Retry-After (data.image_reason: rate_limited).
reason / image_reason | Nghĩa |
|---|---|
invalid_reference | Tên ảnh sai cú pháp (chữ thường, [miền/]đường[:tag][@sha256:…], tối đa 255 ký tự). |
registry_not_allowed | Registry không nằm trong danh sách nhận. |
not_found | Không có ảnh / tag này, hoặc ảnh không công khai. |
no_linux_amd64 | Ảnh không có bản linux/amd64. |
too_large | Ảnh vượt cỡ nén tối đa. |
non_root_user | Ảnh chạy bằng người dùng không phải root. |
unsupported_base_os | Nền ảnh chưa hỗ trợ — message nói nền đã thấy và cách đổi. |
gpu_incompatible | Bản CUDA của ảnh không chạy trên card đã chọn. |
unsupported_format | Định dạng ảnh chưa hỗ trợ. |
Máy chạy ảnh thế nào
- Ghim bản: lệnh thuê ghim đúng bản đã kiểm (
image.digest) — tag đổi sau đó không ảnh hưởng máy. - Kéo ảnh lúc máy khởi động: ảnh lớn chờ lâu hơn (vài phút tới vài chục phút), chưa tính tiền trong lúc chờ. Máy kéo / chạy ảnh hỏng thì hệ thống thử máy khác; vẫn hỏng ⇒ đơn
failedvớiend_reason: image_failed, hoàn đủ. - Chế độ SSH: máy giao bằng SSH như mẫu cài sẵn nên lệnh gốc của ảnh không tự chạy — đặt nó vào
start_command(mục Tuỳ chọn nâng cao) nếu cần chạy dịch vụ. Biến môi trường của ảnh có sẵn trong phiên SSH và trong lệnh khởi động. - Cổng: cổng
EXPOSEcủa ảnh tự được mở ra Internet — địa chỉ ngoài ởimage.exposed_ports(public_host:public_portkhi máyrunning); thêm cổng khác bằngports.
Lượt không thành công
Mỗi tài khoản có tối đa 3 đơn ảnh riêng không thành công (kết thúc chưa giao máy sau khi đã thử kéo ảnh) trong 24 giờ trượt; đơn ảnh riêng đang chờ máy cũng giữ chỗ. Hết lượt ⇒ 429 IMAGE_LIMIT, lệnh chưa giữ đồng nào — quota.next_free_at của image-check cho biết lúc có lượt lại. Không tính lượt: bạn tự huỷ, không tìm được máy, ảnh bị chối lúc kiểm, registry tạm không trả lời.
Phản hồi
quote·buy(202) ·info·list: khốiimage{name·reference·registry·digest·size_bytes(nén) ·cuda·cuda_min_driver·exposed_ports}; máy dùng mẫu cài sẵn ⇒image: null. Máy ảnh riêng cótemplate: null·cuda: null.- Ảnh không đạt lúc
quote/buy⇒400 BAD_REQUESTkèmdata.image_reason(cùng mãreasonở bảng trên). Registry tạm không trả lời ⇒503 UNAVAILABLE, thử lại sau. Quá trần kiểm ảnh mới mỗi giờ ⇒429 RATE_LIMITED(đợi theoRetry-After). - Gửi lại cùng
Idempotency-Keymà đổiimage⇒422 IDEMPOTENCY_MISMATCH.
Điều kiện tóm tắt: ảnh phải công khai, có bản linux/amd64, nền Ubuntu hoặc Debian 12 trở xuống và chạy bằng root.
Mẫu đã lưu
Lưu một lần «công thức máy» — phần mềm + ổ — rồi lần sau chỉ chọn card + mức: gửi saved_template (mã mẫu) trong thân quote / buy của máy Linux thuê theo mức. Một mẫu gồm: nền (template + cuda, hoặc image) · disk_gb · khoá SSH đã lưu (ssh_key_ids) · biến môi trường · cổng TCP · lệnh khởi động. Card · mức · số card · vùng · bộ lọc máy · thời gian chờ · hạn mức vẫn chọn lúc thuê. Cùng danh sách với tab «Mẫu của tôi» trên web — lưu ở đâu cũng thuê được ở cả hai nơi. Không tính phí.
| Lệnh | Việc |
|---|---|
GET /gpu/saved-templates | Danh sách mẫu (sửa gần nhất trước) + max_templates. Khoá chỉ đọc gọi được. |
GET /gpu/saved-templates/info?id= | Một mẫu; khoá Toàn quyền thấy thêm start_command. |
POST /gpu/saved-templates/create | Lưu mẫu từ các trường phần mềm, hoặc chép từ một máy đã thuê (from_order_code). |
POST /gpu/saved-templates/update | Sửa mẫu — cần version đang xem. |
POST /gpu/saved-templates/delete | Xoá mẫu. |
Lưu mẫu
- Thân
create=name(≤ 60 ký tự, được trùng — mẫu gọi bằngid) + CÙNG các trường phần mềm củaquote/buy, kiểm y như lệnh thuê: mẫu cài sẵn + bản CUDA còn bán, cỡ ổ trongdisk_sizes_gb, khoá thuộc tài khoản, luật tên / giá trị biến, cổng, độ dài lệnh; ảnh mới được kiểm qua registry nhưimage-check(cùng nhịp + trần giờ). Bỏ trốngdisk_gb⇒default_disk_gb. Card chưa biết lúc lưu nên card × bản CUDA / ảnh được xét lúc thuê. - Khoá SSH: mẫu chỉ lưu khoá ĐÃ CÓ trong tài khoản —
ssh_key_idsvắng /null⇒ lúc thuê gắn các khoá «tự gắn» của tài khoản ·[]⇒ không khoá đã lưu (vào máy bằng mật khẩu) · danh sách mã ⇒ đúng các khoá ấy. Gửi khoá công khai thô (ssh_key) ⇒400— lưu khoá bằngPOST /account/ssh-keys/createtrước. - Ảnh: mẫu lưu ĐÚNG chữ bạn gửi — tag ⇒ mỗi lần thuê lấy bản mới nhất của tag rồi ghim digest vào máy; muốn cố định thì gửi
…@sha256:<digest>. - Từ máy đã thuê:
{"name": "…", "from_order_code": "…", "pin_image": false}— máy Linux thuê theo mức của bạn, đang chạy hoặc đã trả ≤ 30 ngày; phần mềm + ổ được chép ngay ở máy chủ (giá trị biến không đi qua bạn).pin_image: true⇒ ghim đúng bản ảnh máy ấy chạy. Khoá dán tay lúc thuê không vào mẫu — số khoá bị bỏ ởdropped_ssh_keys. Không gửi kèm trường phần mềm. - Tối đa 20 mẫu một tài khoản (
max_templates) — đủ ⇒429 TEMPLATE_LIMIT.Idempotency-Keytuỳ chọn: tên được trùng nên gửi lại không kèm khoá = mẫu thứ hai; gửi lại cùng khoá ⇒ đúng mẫu đã lưu.
Sửa · xoá
updatecầnid+version(version đang xem) + ít nhất một trường cần đổi; trường VẮNG giữ nguyên. Gửi nền là thay CẢ nền (template+cuda, hoặcimage).env/env_gz= CHỈ các biến cần đổi:{"TEN": "giá trị mới"}thay hoặc thêm ·{"TEN": null}xoá · tên không gửi giữ nguyên (giá trị cũ không bao giờ trả về).ports: []bỏ hết cổng ·start_command: ""bỏ lệnh ·ssh_key_ids: nullvề «tự gắn».- Mỗi lần sửa,
versiontăng 1. Mẫu vừa được sửa ở nơi khác (web, script khác) ⇒409 TEMPLATE_CHANGEDkèmdata.versionhiện tại, mẫu không đổi — đọc lại rồi gửi lại. deletenhậnid+versiontuỳ chọn (gửi thì xoá có điều kiện như sửa). Máy đã thuê từ mẫu không đổi khi sửa / xoá mẫu — máy chụp cấu hình lúc thuê.
Thuê bằng mẫu
- Thân
quote/buy= các trường của máy (card·tier·gpu_count·wait_minutes·region· bộ lọc ·max_amount·max_hours·price_hour·note) +saved_template(+saved_template_version). Mẫu dùng NGUYÊN — gửi kèm bất kỳ trường phần mềm nào (template·cuda·image·disk_gb·ssh_key·ssh_key_ids·env·env_gz·ports·start_command·start_command_gz, kể cảnull) ⇒400: muốn khác thì sửa mẫu hoặc thuê không dùng mẫu. Chỉ máy Linux thuê theo mức (Windows · máy kèm ổ ⇒400). quotetrảsaved_template{id·name·version} — gửi đúngversionấy ởbuy(saved_template_versionBẮT BUỘC khibuybằng mẫu): mẫu đổi sau lúc bạn xem ⇒409 TEMPLATE_CHANGED, chưa giữ đồng nào.- Mọi luật của lệnh thuê áp lên mẫu như gõ tay: card phải chạy được bản CUDA / ảnh của mẫu · bảo trì · tạm ngưng tuỳ chọn nâng cao / ảnh riêng · giá · hạn mức nhỏ nhất. Mẫu có khoá đã bị xoá khỏi tài khoản, hoặc mẫu cài sẵn / bản CUDA không còn bán ⇒
400nói rõ chỗ cần sửa —warningscủa mẫu báo trước điều đó. info·listcủa máy thuê từ mẫu cósaved_template= mẫu + version LÚC THUÊ (sửa / xoá mẫu sau đó không đổi khối này); máy không dùng mẫu ⇒null.- Gửi lại cùng
Idempotency-Key+ cùng thân ⇒ đúng đơn cũ (kể cả khi mẫu đã sửa sau đó); đổisaved_template_versionmà giữ khoá ⇒422 IDEMPOTENCY_MISMATCH.
curl -X POST 'https://cloudmoon.net/api/v1/gpu/buy' \
-H 'X-API-Key: ak_...' \
-H 'Idempotency-Key: 7f9c2e4b-1a2b-4c3d-9e8f-0123456789ab' \
-H 'Content-Type: application/json' \
-d '{"type":"linux","card":"gtx1080ti","tier":"fast","saved_template":45,"saved_template_version":3,"price_hour":4500,"max_hours":2}'import uuid
import requests
r = requests.post(
"https://cloudmoon.net/api/v1/gpu/buy",
headers={"X-API-Key": "ak_...", "Idempotency-Key": str(uuid.uuid4())},
json={"type": "linux", "card": "gtx1080ti", "tier": "fast", "saved_template": 45, "saved_template_version": 3, "price_hour": 4500, "max_hours": 2},
timeout=30,
)
print(r.status_code, r.json())// Node.js 18+ — lưu thành tệp .mjs
import { randomUUID } from "node:crypto";
const res = await fetch("https://cloudmoon.net/api/v1/gpu/buy", {
method: "POST",
headers: {
"X-API-Key": "ak_...",
"Content-Type": "application/json",
"Idempotency-Key": randomUUID(),
},
body: JSON.stringify({ type: "linux", card: "gtx1080ti", tier: "fast", saved_template: 45, saved_template_version: 3, price_hour: 4500, max_hours: 2 }),
});
console.log(res.status, await res.json());// cm_api(): xem mục "Client mẫu" ở trang Tổng quan
$kq = cm_api('POST', '/v1/gpu/buy', ['type' => 'linux', 'card' => 'gtx1080ti', 'tier' => 'fast', 'saved_template' => 45, 'saved_template_version' => 3, 'price_hour' => 4500, 'max_hours' => 2], bin2hex(random_bytes(16)));
print_r($kq);Khối mẫu
id · name · version · template · cuda (nền mẫu cài sẵn — ảnh riêng ⇒ null) · image · disk_gb · ssh_key_ids (null = «tự gắn») · missing_ssh_key_ids (khoá đã bị xoá khỏi tài khoản) · env_names (chỉ TÊN biến) · ports (mảng số, như lúc gửi) · has_start_command · start_command (chỉ info với khoá Toàn quyền) · warnings [{code, message}] — ssh_key_deleted · template_unavailable · corrupted; có cảnh báo thì thuê bằng mẫu bị chối tới khi sửa · created_at · updated_at · last_used_at (lần gần nhất thuê được máy từ mẫu — báo giá và chạy thử không tính).
Tạm dừng & bật lại
Máy Linux thuê theo mức (pause.supported: true — không áp cho máy Windows và máy kèm ổ lưu trữ) tạm dừng được: máy nhả card, giữ nguyên đĩa (phần mềm đã cài · mô hình · tệp trong máy), bạn chỉ trả tiền giữ đĩa theo giờ cho tới khi bật lại hoặc trả máy. Bật lại là đúng máy ấy chạy tiếp. Cùng luật với nút «Tạm dừng» / «Bật lại» trên trang máy — dừng ở web bật bằng API (hay ngược lại) đều được.
| Lệnh | Việc |
|---|---|
POST /gpu/stop | Tạm dừng máy đang chạy — 202, status stopping → paused. Không cần Idempotency-Key: gọi lại khi đã / đang dừng ⇒ 200 / 202 như cũ. |
POST /gpu/start | Bật lại máy đang tạm dừng — giữ trước tiền giờ chạy, 202, status resuming → running. Bắt buộc Idempotency-Key. |
Tiền khi tạm dừng
- Tiền giờ chạy ngừng ngay lúc nhận lệnh
stop(như trả máy). Khi máy chủ xác nhận máy đã dừng (thường dưới 2 phút): phần giờ chạy đã giữ mà chưa dùng hoàn về số dư (dòngpause_refund), rồi hệ thống thu trước một giờ giữ đĩa (dòngdisk_storage) và tiếp tục thu từng giờ — mốc đã trả tới ởpause.disk_paid_until. - Giá giữ đĩa theo giá ổ của chính máy, tính theo giờ (
pause.disk_price_hour; máy ổ 30 GB thường vài trăm đồng mỗi giờ) — có ngay khi lệnh được nhận. Lệnhstopđòi số dư — cộng phần giờ chạy sẽ được hoàn — đủ một giờ giữ đĩa đầu (thiếu ⇒402 INSUFFICIENT_BALANCEkèmdata.disk_price_hour). - Số dư không đủ một giờ giữ đĩa kế ⇒ máy bị TRẢ (xoá cùng dữ liệu,
end_reason: insufficient_balance) — không ghi nợ, không giữ hộ. Khi số dư chỉ còn đủ khoảng 24 giờ cho MỌI máy đang tính tiền của tài khoản (máy chạy + máy giữ đĩa), tài khoản nhận thư báo trước (một lần mỗi lượt tạm dừng).pause.balance_covers_hours= số dư đủ giữ đĩa thêm bao nhiêu giờ;pause.delete_atcó giá trị khi số dư đã không đủ giờ kế — là mốc máy bị trả nếu chưa nạp thêm. - Phí giữ đĩa nằm trong
billing.machine_feevà tách riêng ởbilling.disk_fee(billing.settlement.disk_feekhi đã quyết toán). Tối thiểu 5 phút giờ chạy tính một lần cho cả đơn — giờ chạy của mọi lần bật cộng dồn. - Trả máy đang tạm dừng (
/gpu/delete) ⇒ quyết toán gồm phần giữ đĩa đã dùng, phần giữ dư hoàn về số dư. Hạn mứcmax_amounttính cả tiền giữ đĩa: giờ giữ đĩa kế làm vượt mức ⇒ máy bị trả (end_reason: max_amount); hạn mức đặt được cả lúc máy đang tạm dừng.
Bật lại
startgiữ trướchold_hoursgiờ chạy theo giá máy (hold_amount, dònghold) ngay trong lệnh — cần số dư ≥ khoản giữ + số dư tối thiểu cho phí băng thông (thiếu ⇒402 INSUFFICIENT_BALANCEkèmdata.amount_required). Giá giờ chạy giữ như lúc thuê. Giờ chạy tính lại từ lúc máy chủ xác nhận máy chạy; phần giữ đĩa chưa dùng hoàn về số dư (dòngdisk_refund).- Máy thường chạy lại trong khoảng một phút. Máy chủ không còn card trống ⇒ sau khoảng 90 giây lệnh bật bị huỷ, khoản giữ hoàn đủ (dòng
resume_refund), máy vềpausedvớipause.last_action.result: no_capacity— thử lại sau ít phút, hoặc trả máy. - Sau khi bật, IP / cổng SSH ngoài có thể đổi — đọc lại
connectionở/gpu/infokhistatus = running. Tệp trên đĩa còn nguyên; tiến trình đang chạy lúc dừng thì không (lệnh khởi động của máy chạy lại một lần mỗi lần máy lên). - Máy gần chạm hạn mức chi tiêu ⇒
409 LIMIT_REACHED: nâng / bỏ hạn mức bằng/gpu/limitsrồi bật lại.
Hạn giữ máy của máy chủ
Mỗi máy có hạn máy chủ giữ máy (pause.contract_end — cũng hiện trên trang máy web). Còn dưới 24 giờ ⇒ stop nhận 409 CONTRACT_ENDING; còn dưới 1 giờ ⇒ start cũng vậy. Tới hạn, máy chủ dừng máy; hệ thống đóng đơn (end_reason: contract_ended) khi xác nhận máy đã dừng — máy đang tạm dừng thì đóng ngay — và tính tiền tới đúng mốc hạn; tài khoản nhận thư báo trước.
Nhịp
Mỗi máy một thao tác một lúc (đang dừng / đang bật ⇒ 429 IN_PROGRESS, xem pause.pending_action) và nghỉ 60 giây giữa hai lần tạm dừng / bật lại (429 COOLDOWN kèm Retry-After; còn bao lâu ở pause.cooldown_seconds). Ngoài ra là nhịp theo tài khoản ở mục Giới hạn theo tài khoản.
curl -X POST 'https://cloudmoon.net/api/v1/gpu/start' \
-H 'X-API-Key: ak_...' \
-H 'Idempotency-Key: 7f9c2e4b-1a2b-4c3d-9e8f-0123456789ab' \
-H 'Content-Type: application/json' \
-d '{"order_code":"131126GPUABCDEFGHJK"}'import uuid
import requests
r = requests.post(
"https://cloudmoon.net/api/v1/gpu/start",
headers={"X-API-Key": "ak_...", "Idempotency-Key": str(uuid.uuid4())},
json={"order_code": "131126GPUABCDEFGHJK"},
timeout=30,
)
print(r.status_code, r.json())// Node.js 18+ — lưu thành tệp .mjs
import { randomUUID } from "node:crypto";
const res = await fetch("https://cloudmoon.net/api/v1/gpu/start", {
method: "POST",
headers: {
"X-API-Key": "ak_...",
"Content-Type": "application/json",
"Idempotency-Key": randomUUID(),
},
body: JSON.stringify({ order_code: "131126GPUABCDEFGHJK" }),
});
console.log(res.status, await res.json());// cm_api(): xem mục "Client mẫu" ở trang Tổng quan
$kq = cm_api('POST', '/v1/gpu/start', ['order_code' => '131126GPUABCDEFGHJK'], bin2hex(random_bytes(16)));
print_r($kq);Khối pause
Có ở info · list · phản hồi stop / start: supported (máy thuộc loại tạm dừng được — đơn đang tìm máy của loại ấy cũng true) · disk_price_hour · paused_at (lúc ngừng tính giờ chạy) · disk_paid_until · balance_covers_hours · delete_at · contract_end · pending_action {action stop | start, since} · last_action {action, result done · failed · no_capacity, at} (trong 24 giờ — lệnh dừng không thành thì máy về running, lý do xem ở đây) · cooldown_seconds. Máy đã trả: mọi khoá vẫn có, các trường thời gian / tiền / thao tác là null và cooldown_seconds là 0 — chỉ supported còn nghĩa. Khối wallet thêm paused_machines · paused_hourly_total (tổng tiền giữ đĩa / giờ) và hours_affordable tính cả phần ấy.
Băng thông & số dư tối thiểu
- Máy Linux theo mức có phí băng thông theo GB truyền (tải xuống + tải lên), giá cố định theo mức: thuê tiết kiệm 170đ/GB · thuê nhanh 280đ/GB —
tiers.*.bandwidth_price_gbởproducts,bandwidth_price_gbởquote. Giá ghi vào đơn lúc đặt và có ngay ởbilling.bandwidth_price_gb(kể cả lúc chưa có máy); chuyển sang thuê nhanh (upgrade) thì theo giá mức nhanh (waiting.fast_bandwidth_price_gb).billing.bandwidth_gb= số GB đã ghi nhận,bandwidth_fee= số GB × giá (làm tròn lên đồng). Phí trừ dần vào số dư trong lúc máy chạy; phần còn lại chốt lúc quyết toán. Máy Windows và máy kèm ổ lưu trữ không tính băng thông riêng. - Số dư tối thiểu: mỗi máy có phí băng thông cần 10.000đ nằm yên trong ví (
balance_floorởquote·wallet.balance_floorởinfo) — khoản này không bị trừ, chỉ đỡ phần băng thông ghi nhận chậm vài phút. Lệnh thuê đòi số dư khả dụng ≥ tiền giữ trước + số dư tối thiểu (thiếu ⇒402 INSUFFICIENT_BALANCE, chưa trừ đồng nào). - Khối
wallet(ởinfo):balance·running_machines·hourly_total(tổng giá / giờ mọi máy đang chạy) ·balance_floor·hours_affordable(ví đủ thêm bao nhiêu giờ) — tự canh để không bị trả máy vì hết tiền. Máy tạm dừng:paused_machines·paused_hourly_total(tổng tiền giữ đĩa / giờ) —hours_affordabletính cả phần ấy.
Hạn mức chi tiêu
max_amount(tổng tiền tối đa cho máy, đ) và/hoặcmax_hours(số giờ chạy tối đa) — đặt lúc thuê (thân lệnhbuy) hoặc khi máy đang chạy bằngPOST /gpu/limits;0= không giới hạn. Gửi một trường thì trường kia giữ nguyên. Đơn đang chờ máy không sửa hạn mức được (đặt lúc thuê). Máy đang tạm dừng sửa được (giờ chạy đứng yên; tiền giữ đĩa tính vàomax_amount).- Sắp chạm mức ⇒ báo trước khoảng 10 phút, rồi máy tự trả trước khi phí máy + phí băng thông đã ghi nhận vượt mức —
end_reasonmax_amount/max_hours. Phí máy không vượt mức; phí băng thông ghi nhận chậm vài phút vẫn được chốt lúc quyết toán nên tổng phí có thể nhích quámax_amountmột chút. Máy tính theo phút: kỳ giữ kế tiếp chỉ giữ tới đúng mốc chạm mức (dòngperiodngắn hơn 1 giờ). - Mức mới phải ≥ mức nhỏ nhất đọc ở
limits.min_max_amount/min_max_hours(≈ tạm tính sau thêm khoảng 10 phút chạy; máy tròn giờ không thấp hơn số giờ đã trả) — thấp hơn ⇒400kèm hai số ấy. Giữ đúng mức đang có luôn được. Trần nhập: 2.000.000.000đ · 8.760 giờ. - Khối
limits(ởinfovà câu trả lời của/gpu/limits):max_amount·max_hours·auto_release_at(lúc dự kiến tự trả) ·warning·min_max_amount·min_max_hours(mức nhỏ nhất đặt được ngay lúc này).
Luật vắng mặt
Đơn Linux theo mức có thể chờ máy khá lâu. Máy được giao lúc bạn vắng mặt — tài khoản không gọi GET /gpu/info hay GET /gpu/list (cũng không mở trang máy trên web) trong 3 phút trước đó — sẽ được hẹn tự trả sau 15 phút (absent_release_at) kèm thông báo cho bạn.
- Mỗi lượt
info/listbằng khoá của chính tài khoản được tính là đang có mặt — y như mở trang máy (ghi nhận tối đa một lần mỗi 30 giây) — và gỡ các hẹn tự trả chưa tới hạn của mọi máy đang chạy của tài khoản; hẹn đã quá thì máy vẫn được trả. Script chờ máy vốn hỏiinfođịnh kỳ nên không bị trả oan. - Không ai hỏi tới khi hết hẹn ⇒ máy được trả, chỉ tính 15 phút ấy —
end_reason: absent. - Lượt chạy thử (
X-Sandbox: 1) không tính là có mặt.
Trạng thái & việc làm được
status | Nghĩa |
|---|---|
searching | Đã nhận lệnh, đang tìm máy (khối waiting) — tiền giữ trước được trừ ở bước đầu (xem billing.charged). |
provisioning | Đã có máy, đang khởi tạo / chuẩn bị. |
running | Sẵn sàng — khối connection có SSH / RDP, đang tính tiền. |
stopping | Đang tạm dừng — giờ chạy đã ngừng tính, máy đang dừng (mục Tạm dừng). |
paused | Đã tạm dừng — giữ đĩa, tính tiền giữ đĩa theo giờ (khối pause). |
resuming | Đang bật lại — đã giữ trước tiền giờ chạy. |
releasing | Đã ngừng tính tiền, máy đang được gỡ. |
settling | Máy đã gỡ, đang chờ quyết toán (thường vài phút). |
released | Đã trả và quyết toán — xem billing.settlement, end_reason. |
cancelled · expired | Bạn huỷ khi còn chờ · hết thời gian chờ mà chưa có máy — đã hoàn đủ. |
failed | Không tạo được máy — đã hoàn đủ (đọc end_reason). |
Vì sao máy dừng — end_reason
customer bạn trả · max_amount / max_hours chạm hạn mức · insufficient_balance ví không đủ giờ kế (hoặc không đủ tiền giữ trước lúc đơn bắt đầu; máy kèm ổ lưu trữ: ổ quá thời hạn giữ vì số dư không đủ — máy tự trả rồi ổ bị xoá) · bandwidth_balance ví không đủ băng thông · absent luật vắng mặt · cancelled bạn huỷ khi chờ · wait_timeout hết thời gian chờ · out_of_capacity không có / không tạo được máy phù hợp (Windows: trong giá tối đa) · image_failed máy không khởi động được với ảnh Docker riêng của bạn — đã hoàn đủ · volume_unavailable ổ lưu trữ gắn kèm không dùng được lúc tạo máy (đang thiếu tiền giữ ổ hoặc đang xử lý) — đã hoàn đủ · contract_ended máy chủ hết hạn giữ máy (tính tiền tới đúng mốc ấy; máy tạm dừng mà số dư không đủ giờ giữ đĩa kế là insufficient_balance) · infrastructure sự cố hạ tầng · support bộ phận hỗ trợ trả · system lý do khác — liên hệ hỗ trợ kèm order_code.
Giá trị của allowed_actions
cancel · upgrade (đơn đang chờ) · restart · delete · limits (máy đang chạy) · stop (máy đang chạy) · start (máy đang tạm dừng — lúc ấy còn delete · limits) · note (mọi lúc) — việc làm được NGAY lúc này. Gọi lệnh vắng mặt thường bị chối với mã nói rõ vì sao (NOT_RUNNING · PROVISIONING · MACHINE_ASSIGNED · NOT_WAITING · ORDER_CLOSED · NOT_SUPPORTED); riêng gọi lại cancel · upgrade · delete khi việc ấy đã xong trước đó thì trả 200 (gọi lại an toàn). Khởi động lại có thể đổi IP / cổng ⇒ hỏi lại info.
Giới hạn theo tài khoản
- Tối đa 3 máy cùng lúc — tính cả máy đang tìm, đang tạo và đang gỡ (
429 MACHINE_LIMIT); 10 lượt thuê / giờ (429 RATE_LIMITED). Hai bộ đếm tính cả lệnh trên web,quotecho biết trước quacan_order/blocked. - Hai lệnh thuê cùng lúc của một tài khoản chạy lần lượt — lệnh sau có thể nhận
429 BUSY(gửi lại sau vài giây, cùngIdempotency-Key).
Nhịp theo tài khoản (chung với web — gọi trên web cũng trừ vào cùng ngân sách), quá nhịp ⇒ 429 RATE_LIMITED kèm Retry-After:
| Nhóm lệnh | Tối đa |
|---|---|
Đọc máy — list · info · metrics · logs · charges (chung lượt làm mới trang máy trên web) | 40 lượt / phút |
Báo giá máy Windows — quote với type: windows (báo giá sống) | 20 lượt / phút |
Huỷ đơn đang chờ máy — cancel | 20 lượt / phút |
Chuyển sang thuê nhanh — upgrade | 10 lượt / phút |
Đặt hạn mức — limits | 20 lượt / phút |
Ghi chú — note | 20 lượt / phút |
Đọc ổ lưu trữ — volumes · volumes/info · volumes/charges (chung lượt làm mới khối ổ trên web) | 40 lượt / phút |
Tạo ổ lưu trữ — volumes/create | 6 lượt / phút |
Tăng dung lượng ổ — volumes/resize | 6 lượt / phút |
Đổi tên ổ — volumes/rename | 10 lượt / phút |
Xoá ổ — volumes/delete | 10 lượt / phút |
Kiểm ảnh Docker — image-check, và quote / buy có image (chung nút «Kiểm ảnh» và lệnh thuê kèm ảnh trên web); ảnh chưa có trong bộ đệm còn có trần theo giờ — mục Ảnh Docker riêng | 6 lượt / phút |
Lưu mẫu — saved-templates/create (cả từ máy đã thuê; chung nút «Lưu làm mẫu» trên web) | 20 lượt / 10 phút |
Sửa mẫu — saved-templates/update (chung trang sửa mẫu trên web) | 60 lượt / 10 phút |
Xoá mẫu — saved-templates/delete | 30 lượt / 10 phút |
Tạm dừng máy — stop (chung nút «Tạm dừng» trên web) | 10 lượt / phút |
Bật lại máy — start (chung nút «Bật lại» trên web) | 10 lượt / phút |
Ngoài ra là giới hạn tần suất chung của khoá API (mục Giới hạn tần suất) và nhịp trên cùng một máy (mục Nhịp thao tác bên dưới).
Bảo trì & ngừng bán
- Bảo trì mảng ⇒
products·quote·buytrả503 SERVICE_DISABLED. Máy và đơn đã có vẫn dùng bình thường:list·info·metrics·logs·charges·cancel·upgrade·restart·delete·limits·note·stop·startvẫn chạy. - Một loại máy tạm bảo trì ⇒ thuê mới / báo giá loại ấy nhận
503 MAINTENANCE; danh mục vẫn bày nhưng mangorderable: false. Đơn đang chờ vẫn chờ (hết thời gian chờ thì tự huỷ, hoàn đủ). Máy đang chạy vẫn dùng được; trả máy vẫn ngừng tính tiền ngay (máy được gỡ khi hết bảo trì); khởi động lại có thể chưa làm được (503 UNAVAILABLE). - Ngừng bán một loại card, một mức (
saving/fast) của card, hay một nhóm Windows ⇒ lựa chọn ấy biến khỏiproducts, thuê / báo giá nhận404 NOT_FOUND— đọc lại danh mục. - Nhóm Windows hết máy ⇒
in_stock: false+409 OUT_OF_STOCK(mục Máy Windows). - Ổ lưu trữ & máy kèm ổ — ổ và máy đã có không bị ảnh hưởng (đọc · đổi tên · xoá ổ · trả máy vẫn chạy); chỉ lệnh MỚI bị chối, trước khi trừ đồng nào:
bảo trì mảng ⇒
products?type=volume·quote/buytype=volume·volumes/create·volumes/resizenhận503 SERVICE_DISABLED; tạm ngừng bán riêng nhánh kèm ổ ⇒ danh mục vẫn bày vớiorderable: false, tạo / tăng ổ và thuê máy kèm ổ nhận503 SERVICE_DISABLED; kèm ổ tạm bảo trì ⇒orderable: false, các lệnh ấy nhận503 MAINTENANCE; kèm ổ tạm ngưng nhận lệnh ⇒orderable: false, nhận503 UNAVAILABLE; ngừng bán một loại máy kèm ổ ⇒ loại ấy biến khỏi danh mục,quote/buyloại ấy nhận404 NOT_FOUND. Cỡ ổ không có trongvolume.sizes_gb⇒400. - Ảnh Docker riêng tạm ngưng ⇒ lệnh MỚI kèm
imagevàimage-checknhận503 MAINTENANCE(custom_image.enabled: falseở/gpu/products); lệnh không kèm ảnh và máy đang chạy không ảnh hưởng. - Tạm dừng máy tạm khoá ⇒ lệnh
stopMỚI nhận503 MAINTENANCE; máy đang tạm dừng vẫnstart·deleteđược. Loại máy tạm bảo trì ⇒stop/startnhận503 MAINTENANCE. - Mẫu đã lưu không có công tắc riêng: đọc · lưu · sửa · xoá mẫu vẫn chạy cả lúc mảng bảo trì. Thuê bằng mẫu chịu đúng các công tắc của lệnh gõ tay theo nội dung mẫu — bảo trì mảng / loại máy · tuỳ chọn nâng cao tạm ngưng (mẫu có biến · cổng · lệnh) · ảnh riêng tạm ngưng (mẫu có ảnh).
Chạy thử với máy mẫu
POST /gpu/buy kèm X-Sandbox: 1 kiểm y như lượt thật (card · mức · mẫu · CUDA · ổ · số dư · giới hạn) rồi trả 202 với order_code dạng SANDBOX… — không giữ tiền, không tạo máy. Hỏi info / metrics / logs / charges với mã ấy (vẫn kèm X-Sandbox: 1) ⇒ máy mẫu:
- Đi đúng các trạng thái của máy thật, rút gọn thời gian:
searchingkhoảng 10 giây đầu (đã giữ trước),provisioningtới khoảng 40 giây, rồirunning— IP mẫu thuộc dải tài liệu203.0.113.0/24, mật khẩu mẫuSandbox-…. Kịch bảnPROVISION_FAILED⇒failed(out_of_capacity), hoàn đủ. - Tính tiền theo đúng luật máy thật (giữ trước · kỳ kế · hạn mức tự trả) theo tuổi của mã — giờ tạo nằm trong mã; mã chỉ sống 62 ngày.
- Mã mang lựa chọn của lệnh thuê (loại máy, mức, số card, ổ, mẫu, CUDA, vùng, bộ lọc, hạn mức) nhưng không mang ghi chú — máy mẫu luôn có
note: null. Mã dài hơn mã thật nhiều (có thể tới khoảng 240 ký tự) — lưu ở trường đủ rộng. - Lệnh trên máy mẫu (
cancel·upgrade·restart·delete·limits·note) trả kết quả mô phỏng cùng khuôn và chối theo đúng điều kiện trạng thái như lượt thật (máy mẫu không áp nhịp theo tài khoản và đệm khởi động lại); máy mẫu không đổi theo các lệnh ấy (không lưu gì). Thiếu headerX-Sandbox⇒ mãSANDBOX…nhận404. - Với
order_codethật, lượt chạy thử kiểm trên chính máy ấy rồi trả mô phỏng — máy không bị đụng tới; lượt đọc chạy thử không đồng bộ máy và không tính có mặt. - Ổ mẫu:
POST /gpu/volumes/createkèmX-Sandbox: 1kiểm như lượt thật (cỡ · trần số ổ · số dư ngày đầu) rồi trả mã ổSANDBOX…— đúng cỡ đã chọn, tính tiền theo giá hiện hành và theo tuổi của mã (sống 62 ngày), không mang tên. Dùng mã ấy (vẫn kèm header) với/gpu/volumes/*vàquote/buytype=volume; kịch bảnVOLUME_UNPAIDlúc tạo ⇒ ổ mẫu thiếu tiền từ ngày thứ hai. Đổi tên · tăng · xoá trên ổ mẫu hay ổ thật kèm header ⇒ kết quả mô phỏng, không đổi gì. buytype=volumechạy thử (ổ thật hoặc ổ mẫu) ⇒ máy mẫu kèm ổ đi các trạng thái như máy mẫu ở trên; kịch bảnPROVISION_FAILED⇒failed.- Ảnh Docker riêng: chạy thử không hỏi registry —
image-check·quote·buydùng kết quả kiểm THẬT gần đây của cùng ảnh; chưa có ⇒ kết quả mô phỏng (sandbox: true;digest— trừ khi bạn đã ghim — ·size_bytes·cuda·os· cổng · lệnh gốc để trống). Gọiimage-checkkhông kèm header trước để có kết quả thật. MãSANDBOX…của lệnh thuê kèm ảnh mang theo tên ảnh (dài tới khoảng 750 ký tự) ⇒infocủa máy mẫu có khốiimage; kịch bảnIMAGE_LIMITthử được lời chối hết lượt. - Tạm dừng:
stop/startkèmX-Sandbox: 1kiểm y như lượt thật (trạng thái · nghỉ · hạn giữ máy · hạn mức · số dư khi bật) rồi trả kết quả mô phỏng — máy không dừng, không giữ tiền;stopchạy thử chưa có giá đĩa (disk_price_hour: null) và chưa xét số dư giờ đĩa đầu. Máy mẫuSANDBOX…đangrunningdừng thử được; máy mẫu không bao giờpausednênstarttrên máy mẫu nhận409 NOT_PAUSED— thửstarttrên máy thật đang tạm dừng (kèm header). - Mẫu đã lưu:
saved-templates/create·update·deletekèmX-Sandbox: 1kiểm y như lượt thật (tên · trần số mẫu · phiên bản · mọi luật phần mềm) rồi trả mẫu mô phỏng —createcóid: null; không lưu, không sửa, không xoá gì; ảnh mới không hỏi registry (như mục Ảnh Docker riêng).quote·buychạy thử bằng mẫu giải mẫu như thật nhưng không ghilast_used_at; máy mẫuSANDBOX…mang nền · ổ · ảnh của mẫu nhưngsaved_template: null(không mang dấu mẫu, khoá, tuỳ chọn). Kịch bảnTEMPLATE_CHANGED(buy · update · delete) vàTEMPLATE_LIMIT(create) thử được lời chối.
Luật riêng của Thuê GPU
- Không có chiết khấu đại lý, hoa hồng giới thiệu, chu kỳ hay gia hạn: muốn dừng tính tiền HẲN là trả máy, và trả máy là xoá máy cùng dữ liệu — không khôi phục được (
confirm= đúngorder_code). Lưu dữ liệu ra ngoài trước khi trả (máy kèm ổ lưu trữ: dữ liệu trong/workspacenằm trên ổ, còn nguyên). Máy Linux thuê theo mức còn tạm dừng được — chỉ trả tiền giữ đĩa (mục Tạm dừng & bật lại). - Lệnh có trừ tiền (
buy·upgrade·start) bắt buộcIdempotency-Key: gửi lại cùng khoá ⇒ đúng mã đơn / kết quả cũ, không thuê hai máy, không giữ thêm hai lần. Huỷ chờ · trả máy không cần khoá ấy: gọi lại khi việc đã xong trả200với trạng thái hiện tại, không làm thêm gì (quyết toán của lần trả đầu có thể hoàn dư hoặc thu bù). - Khoá SSH công khai (
ssh_key+ khoá «tự gắn» của tài khoản — mục Khoá SSH) được cài sẵn vào máy; mật khẩu (connection.password) chỉ trả cho khoá API Toàn quyền khi máy đang chạy, khoá Chỉ đọc nhậncredentials_note. - Ghi chú máy (
note) ≤ 100 ký tự một dòng, khoảng trắng gộp lại, chuỗi rỗng = bỏ — đặt lúc thuê hoặc bằngPOST /gpu/note(cả máy đã trả). - Máy đã trả vẫn đọc được thông tin + sổ tiền ở
/gpu/infovà/gpu/list?status=closed.
Nhịp thao tác trên cùng một máy
Để máy kịp đổi trạng thái, các lệnh trên cùng một máy phải cách lệnh trước một khoảng tối thiểu (cùng luật với web). Các việc trong cùng một dòng dùng chung một đồng hồ. Gửi sớm hơn ⇒ 429 COOLDOWN (header Retry-After cho biết còn bao nhiêu giây); gửi trong lúc máy đang xử lý lệnh khác ⇒ 429 IN_PROGRESS.
| Lệnh | Cách lệnh trước trên cùng máy |
|---|---|
| Khởi động lại | 3 phút (chung với nút «Khởi động lại» trên web — gửi sớm ⇒ 429 COOLDOWN kèm Retry-After số giây còn lại) |
| Huỷ chờ · chuyển nhanh · trả máy · hạn mức | không phải chờ (chỉ một lệnh mỗi lúc trên cùng máy (429 IN_PROGRESS)) |
| Ghi chú | không phải chờ (không khoá máy — chỉ nhịp theo tài khoản (mục «Giới hạn theo tài khoản»)) |
Mã lỗi riêng
Ngoài các mã lỗi chung của mọi endpoint, trang này còn có các mã dưới đây. Hãy rẽ nhánh theo code.
| HTTP | code | Ý nghĩa | Nên làm gì |
|---|---|---|---|
| 404 | NOT_FOUND |
Không tìm thấy máy (order_code sai / không thuộc tài khoản của khoá) — hoặc lựa chọn lúc thuê / báo giá đã NGỪNG BÁN: loại card bị ẩn, mức (saving / fast) bị bỏ cho card ấy, nhóm Windows không còn bán. |
Đọc lại /gpu/products rồi chọn lựa chọn đang bán. |
| 400 | NOT_SUPPORTED |
Đơn không làm được thao tác này: huỷ chờ / chuyển nhanh chỉ cho đơn Linux theo mức (máy Windows · máy kèm ổ không có hàng chờ theo mức). | Máy đã có ⇒ trả bằng /gpu/delete. |
| 400 | CONFIRM_REQUIRED |
Lệnh trả máy thiếu trường xác nhận. | Gửi confirm bằng đúng order_code — máy bị gỡ cùng dữ liệu, không khôi phục được. |
| 402 | INSUFFICIENT_BALANCE |
Số dư khả dụng không đủ tiền giữ trước (giá / giờ × giờ giữ) cộng số dư tối thiểu cho phí băng thông (balance_floor — giữ yên trong ví, không bị trừ) — lệnh CHƯA trừ đồng nào. |
Nạp thêm rồi gửi lại (cùng Idempotency-Key được). Xem trước bằng /gpu/quote. |
| 409 | PRICE_CHANGED |
Giá / giờ vừa đổi so với price_hour bạn gửi (thuê theo mức · chuyển nhanh) — CHƯA giữ đồng nào; giá mới ở data.price_hour. |
Xem lại giá rồi gửi lại với price_hour mới (thân lệnh đã khác ⇒ Idempotency-Key MỚI). |
| 409 | OUT_OF_STOCK |
Nhóm máy Windows tạm hết máy trống (danh mục ghi in_stock: false) — lệnh CHƯA giữ tiền. |
Chọn nhóm khác hoặc thử lại sau — thêm ?in_stock=1 vào /gpu/products. |
| 409 | MACHINE_ASSIGNED |
Đơn đã có máy (vừa được tạo) — không huỷ chờ được nữa. | Không cần máy nữa ⇒ đợi status = running rồi trả bằng /gpu/delete (chỉ tính thời gian đã dùng; trong lúc khởi tạo delete trả 409 PROVISIONING). |
| 409 | NOT_WAITING |
Đơn không còn chờ máy — chỉ đổi mức được khi đơn tiết kiệm đang tìm máy. | Xem /gpu/info. |
| 409 | NOT_RUNNING |
Máy không ở trạng thái đang chạy (đang tìm · đang tạo) — khởi động lại và hạn mức chỉ cho máy đang chạy. | Hỏi /gpu/info tới khi status = running. |
| 409 | PROVISIONING |
Máy đang được khởi tạo, hoặc đơn đang chờ máy — chưa trả được. | Đơn đang chờ ⇒ huỷ bằng /gpu/cancel (hoàn đủ) · đang tạo ⇒ đợi running rồi trả. |
| 409 | ORDER_CLOSED |
Đơn / máy đã đóng (đã trả · đã huỷ · không tạo được) — chỉ còn ghi chú. | Không thao tác được nữa — thuê máy mới bằng /gpu/buy. |
| 429 | MACHINE_LIMIT |
Đã có số máy tối đa cùng lúc của tài khoản (max_machines ở /gpu/products — tính cả máy đang tìm · đang tạo · đang gỡ). |
Trả bớt máy rồi thuê thêm. |
| 429 | RATE_LIMITED |
Quá số lượt thuê mỗi giờ của tài khoản, hoặc gọi quá nhanh một nhóm lệnh (bảng nhịp theo tài khoản ở mục «Giới hạn theo tài khoản» — CHUNG web và API). | Chờ Retry-After giây. |
| 429 | COOLDOWN |
Máy vừa được khởi động lại — mỗi máy phải cách lần trước một khoảng (mục «Nhịp thao tác», chung web và API). | Chờ Retry-After giây. |
| 429 | IN_PROGRESS |
Đơn đang xử lý một lệnh khác (hai lệnh cùng lúc trên một máy), hoặc đơn vừa đổi giữa lúc kiểm và lúc ghi. | Chờ Retry-After giây rồi gửi lại. |
| 400 | CONFIRM_REQUIRED |
Lệnh xoá ổ lưu trữ thiếu trường xác nhận. | Gửi confirm bằng đúng volume_code — ổ bị xoá cùng toàn bộ dữ liệu /workspace, không khôi phục được. |
| 402 | INSUFFICIENT_BALANCE |
Số dư không đủ tiền ngày đầu của ổ lưu trữ mới, hoặc phần chênh khi tăng dung lượng (số cần ở data.amount_required) — lệnh CHƯA trừ đồng nào. |
Nạp thêm rồi gửi lại (cùng Idempotency-Key được). |
| 402 | VOLUME_UNPAID |
Ổ lưu trữ đang thiếu tiền giữ ổ (status = overdue) — chưa tăng dung lượng / chưa thuê máy kèm ổ này được. Lệnh CHƯA trừ đồng nào. |
Nạp ít nhất amount_due (xem /gpu/volumes/info) — hệ thống tự thu bù trong khoảng một phút, ổ về active rồi gửi lại. |
| 409 | INVALID_STATE |
Ổ lưu trữ không còn làm được thao tác này (đang xoá · đã xoá · không tạo được). | Xem status ở /gpu/volumes/info — cần ổ mới thì tạo bằng /gpu/volumes/create. |
| 409 | VOLUME_IN_USE |
Ổ lưu trữ còn máy đang gắn (đang tìm · đang tạo · đang chạy · đang trả) — chưa xoá được; danh sách máy ở data.attached_machines. |
Trả các máy ấy bằng /gpu/delete rồi xoá ổ. |
| 429 | VOLUME_LIMIT |
Đã có số ổ lưu trữ tối đa của tài khoản (quota.max_volumes ở /gpu/volumes — ổ đang xoá không tính). |
Xoá bớt ổ không dùng, hoặc tăng dung lượng ổ đang có bằng /gpu/volumes/resize. |
| 429 | IN_PROGRESS |
Ổ lưu trữ đang được tạo · đang tăng dung lượng · sát mốc thu ngày mới (khoảng một phút), hoặc đang xử lý một lệnh khác. | Chờ Retry-After giây rồi gửi lại. |
| 503 | MAINTENANCE |
Loại máy này đang tạm bảo trì — lệnh thuê / báo giá MỚI tạm chối. Máy đang chạy vẫn dùng được; trả máy vẫn ngừng tính tiền ngay (máy được gỡ khi hết bảo trì); khởi động lại có thể chưa làm được (503 UNAVAILABLE). |
Thử lại sau ít phút, hoặc chọn loại máy khác. |
| 503 | UNAVAILABLE |
Tạm chưa làm được thao tác (mức thuê nhanh tạm ngưng · lệnh khởi động lại / trả máy chưa tới được máy · báo giá Windows chưa đọc được). | Thử lại sau ít phút; trả máy vẫn chưa được ⇒ liên hệ hỗ trợ kèm order_code. |
| 404 | NOT_FOUND |
Mã khoá trong ssh_key_ids không có hoặc không thuộc tài khoản của khoá API (cùng câu với mã không có) — lệnh CHƯA giữ đồng nào. |
Đọc lại /account/ssh-keys rồi gửi đúng mã khoá của bạn. |
| 404 | NOT_FOUND |
Không tìm thấy mẫu đã lưu (id / saved_template không có, hoặc mẫu không thuộc tài khoản của khoá API — cùng câu với mã không có), hoặc from_order_code không phải máy của bạn — lệnh CHƯA làm gì. |
Đọc lại /gpu/saved-templates (máy: /gpu/list). |
| 409 | TEMPLATE_CHANGED |
Mẫu đã lưu vừa được sửa sau lần bạn đọc — data.version = version hiện tại. Lệnh CHƯA làm gì (thuê: chưa giữ đồng nào · sửa / xoá: mẫu còn nguyên). |
Đọc lại /gpu/saved-templates/info, xem lại mẫu rồi gửi lại với version (sửa / xoá) hoặc saved_template_version (quote / buy) mới. |
| 429 | TEMPLATE_LIMIT |
Tài khoản đã lưu đủ số mẫu tối đa (max_templates ở /gpu/saved-templates). |
Xoá mẫu không còn dùng bằng /gpu/saved-templates/delete rồi lưu lại. |
| 429 | IMAGE_LIMIT |
Hết lượt thuê bằng ảnh Docker riêng: số đơn ảnh riêng không thành công trong 24 giờ cộng số đơn ảnh riêng đang chờ máy đã chạm custom_image.failed_order_limit_24h — lệnh CHƯA giữ đồng nào. |
Đợi các đơn đang chờ xong hoặc tới quota.next_free_at (xem /gpu/image-check), hoặc thuê bằng mẫu cài sẵn (template). |
| 400 | NOT_SUPPORTED |
Tạm dừng / bật lại chỉ cho máy Linux thuê theo mức (pause.supported = true) — máy Windows · máy kèm ổ lưu trữ không tạm dừng được. |
Không cần máy nữa ⇒ trả bằng /gpu/delete. |
| 402 | INSUFFICIENT_BALANCE |
Tạm dừng: số dư (cộng phần giờ chạy sẽ được hoàn) không đủ một giờ giữ đĩa đầu (giá ở data.disk_price_hour) · bật lại: số dư không đủ khoản giữ trước giờ chạy + số dư tối thiểu cho phí băng thông (số cần ở data.amount_required) — lệnh CHƯA làm gì. |
Nạp thêm rồi gửi lại (bật lại: cùng Idempotency-Key được). |
| 409 | NOT_RUNNING |
Tạm dừng chỉ cho máy đang chạy (status = running) — máy đang tìm · đang tạo chưa dừng được. |
Hỏi /gpu/info tới khi status = running. |
| 409 | NOT_PAUSED |
Bật lại chỉ cho máy đang tạm dừng (status = paused). |
Xem status ở /gpu/info — máy đang chạy thì không cần bật. |
| 409 | CONTRACT_ENDING |
Máy chủ sắp hết hạn giữ máy (pause.contract_end, kèm ở data.contract_end): tạm dừng chối khi còn dưới 24 giờ, bật lại chối khi còn dưới 1 giờ. Tới hạn máy chủ dừng máy; đơn đóng (end_reason contract_ended) khi xác nhận máy đã dừng, tính tiền tới đúng mốc hạn. |
Lưu dữ liệu cần giữ rồi trả máy bằng /gpu/delete; cần chạy tiếp ⇒ thuê máy mới. |
| 409 | LIMIT_REACHED |
Máy đã gần chạm hạn mức chi tiêu bạn đặt (limits) — bật lại sẽ bị tự trả gần như ngay. |
Nâng hoặc bỏ hạn mức bằng /gpu/limits rồi bật lại. |
| 429 | COOLDOWN |
Máy vừa tạm dừng / bật lại — mỗi máy một thao tác một lúc và phải nghỉ một khoảng giữa hai lần (pause.cooldown_seconds). |
Chờ Retry-After giây. |
| 429 | IN_PROGRESS |
Máy đang được tạm dừng / bật lại (pause.pending_action), hoặc đang xử lý một lệnh khác. |
Chờ Retry-After giây rồi đọc /gpu/info. |
| 503 | MAINTENANCE |
Tạm dừng máy đang tạm khoá (chặn lệnh tạm dừng MỚI) hoặc loại máy này đang bảo trì — khi chỉ khoá tạm dừng, máy đang tạm dừng vẫn bật lại / trả được. | Thử lại sau ít phút; không cần máy nữa ⇒ /gpu/delete. |
/gpu/products
Chỉ đọcDanh mục thuê GPU — CÙNG dữ liệu trang /gpu (không gọi nhà cung cấp). Linux (type = linux): mỗi card có giá MỖI GIỜ theo mức (saving · fast) × số card một máy (gpu_counts) + phụ phí phần ổ vượt disk_included_gb (price_hour theo disk_gb, làm tròn lên 100đ), thời gian chờ chọn được, mẫu cài sẵn + bản CUDA chạy được, ước số máy theo mức (availability — mẫu lượt kiểm thị trường gần nhất, more: true = có thể nhiều hơn). Windows (type = windows): mỗi nhóm thuê được (group) với giá từ · số máy · vùng · mẫu, tính tròn giờ. orderable = đang nhận lệnh thuê. Kèm thông số chung (ổ · vùng · bộ lọc máy · giờ giữ trước · sàn số dư mỗi máy · giá băng thông tối đa · số máy tối đa mỗi tài khoản). Lọc ?type= · ?in_stock=1. Máy KÈM Ổ LƯU TRỮ (type = volume — chỉ khi gửi tường minh; bỏ trống type vẫn là Linux + Windows): mỗi loại máy GPU / CPU (machine · kind) có giá MỖI GIỜ tính theo PHÚT, mẫu cài sẵn + bản CUDA, ổ hệ điều hành của máy (disk_gb), hạn mức nhỏ nhất (limits_min), ước số máy (availability), orderable; khối volume: vị trí · mount_path /workspace · cỡ ổ bán (sizes_gb) · giá mỗi GB / ngày (price_gb_day) · tiền mỗi ngày theo cỡ (daily_amount) · trần số ổ (max_volumes) · số ổ còn tạo được (remaining) · số ngày giữ ổ khi thiếu tiền (grace_days) · orderable; kèm search_seconds (thời gian tìm máy) · sàn số dư. Ảnh Docker riêng: danh mục Linux (bỏ trống type / type = linux) có custom_image — enabled · registries (registry nhận ảnh) · max_size_gb (cỡ NÉN tối đa của bản linux/amd64) · failed_order_limit_24h (số đơn ảnh riêng không thành công tối đa trong 24 giờ trượt — đơn ảnh riêng đang chờ máy cũng giữ chỗ) · uncached_checks_per_hour (số lượt kiểm ảnh CHƯA có trong bộ đệm tối đa mỗi giờ của tài khoản — ảnh vừa được kiểm gần đây không tính) · requirements. Mẫu đã lưu: danh mục Linux (bỏ trống type / type = linux) có saved_templates — max_per_account = số mẫu tối đa một tài khoản (danh sách ở /gpu/saved-templates).
GET https://cloudmoon.net/api/v1/gpu/products| Tham số | Vị trí | Bắt buộc | Mô tả |
|---|---|---|---|
type |
query | không | linux | windows (bỏ trống = cả hai) · volume = máy kèm ổ lưu trữ + cỡ ổ (chỉ khi gửi tường minh) |
in_stock |
query | không | 1 = chỉ lựa chọn in_stock: true — Windows: nhóm còn máy theo kho · Linux: loại đang nhận thuê (không bảo đảm có máy ngay — xem availability); thuê được hay không xem orderable · volume: loại máy đang nhận thuê kèm ổ |
curl 'https://cloudmoon.net/api/v1/gpu/products' \
-H 'X-API-Key: ak_...'import requests
r = requests.get(
"https://cloudmoon.net/api/v1/gpu/products",
headers={"X-API-Key": "ak_..."},
timeout=30,
)
print(r.status_code, r.json())// Node.js 18+ — lưu thành tệp .mjs
const res = await fetch("https://cloudmoon.net/api/v1/gpu/products", {
headers: { "X-API-Key": "ak_..." },
});
console.log(res.status, await res.json());// cm_api(): xem mục "Client mẫu" ở trang Tổng quan
$kq = cm_api('GET', '/v1/gpu/products');
print_r($kq);{
"status": "success",
"msg": "OK",
"data": {
"items": [
{
"type": "linux",
"card": "gtx1080ti",
"name": "GTX 1080 Ti",
"vram_gb": 11,
"billing": "minute",
"price_from": 3500,
"gpu_counts": {
"1": {
"tiers": {
"saving": {
"price_hour": {
"30": 3500,
"60": 4300,
"100": 5200,
"200": 7600
},
"wait_minutes": [
30,
60,
180
]
},
"fast": {
"price_hour": {
"30": 4500,
"60": 5300,
"100": 6200,
"200": 8600
},
"wait_minutes": [
10
]
}
},
"availability": {
"saving": {
"machines": 9,
"more": false
},
"fast": {
"machines": 27,
"more": false
}
}
}
},
"templates": [
{
"code": "ubuntu_cuda",
"name": "Ubuntu + CUDA",
"cuda": [
"12.4",
"12.8"
]
},
{
"code": "pytorch",
"name": "PyTorch + CUDA",
"cuda": [
"12.4"
]
}
],
"cuda": [
"12.4",
"12.8"
],
"in_stock": true,
"orderable": true
},
{
"type": "windows",
"group": "windows|P40|24|1|gio",
"name": "P40",
"vram_gb": 24,
"gpu_count": 1,
"billing": "hour",
"price_from": 11200,
"machines": 2,
"regions": [
{
"code": "vn",
"name": "Việt Nam",
"machines": 2
}
],
"templates": [
{
"code": "windows10",
"name": "Windows 10 (dùng thử, chưa kích hoạt)"
}
],
"in_stock": true,
"orderable": true
}
],
"total": 2,
"availability_sampled_at": "2026-11-13T08:00:12+07:00",
"currency": "VND",
"disk_sizes_gb": [
30,
60,
100,
200
],
"disk_included_gb": 30,
"default_disk_gb": 30,
"regions": [
{
"code": "vn",
"name": "Việt Nam"
},
{
"code": "asia",
"name": "Châu Á"
},
{
"code": "us",
"name": "Bắc Mỹ"
},
{
"code": "eu",
"name": "Châu Âu"
},
{
"code": "khac",
"name": "Khác"
}
],
"filters": {
"min_ram_gb": [
32,
64,
128
],
"min_vcpu": [
8,
16,
32
],
"nvme": true
},
"hold_hours": 1,
"min_minutes": 1,
"balance_floor_per_machine": 10000,
"bandwidth_max_price_gb": 420,
"max_machines": 3,
"custom_image": {
"enabled": true,
"registries": [
"docker.io",
"ghcr.io",
"nvcr.io",
"quay.io",
"registry.gitlab.com",
"public.ecr.aws"
],
"max_size_gb": 30,
"failed_order_limit_24h": 3,
"uncached_checks_per_hour": 20,
"requirements": "ảnh phải công khai, có bản linux/amd64, nền Ubuntu hoặc Debian 12 trở xuống và chạy bằng root"
},
"saved_templates": {
"max_per_account": 20
}
}
}/gpu/quote
Chỉ đọcBÁO GIÁ thuê một máy — không trừ tiền, khoá chỉ đọc gọi được. CÙNG bộ kiểm với lệnh thuê (card · mức · mẫu · CUDA · ổ · số card · vùng · bộ lọc · hạn mức · bảo trì): can_order phản ánh trần tài khoản + số dư (false ⇒ lệnh thuê sẽ bị chối theo blocked); Linux: can_order = true thì lệnh thuê chỉ còn hỏng vì thứ đổi giữa hai lượt · Windows: còn máy hợp giá tối đa hay không chỉ biết lúc tìm máy (chưa thấy máy hợp giá ⇒ đơn tự kết, chưa trừ đồng nào; đã giữ tiền mà không tạo được máy ⇒ hoàn đủ). Trả giá mỗi giờ của máy, tiền giữ trước (hold_amount = price_hour × hold_hours — Windows: max_price_hour × hold_hours), sàn số dư (balance_floor — giữ yên trong ví cho phí băng thông, không bị trừ), số dư khả dụng (trừ tiền giữ của lệnh còn chờ), can_order + blocked (trần máy · lượt / giờ · số dư), hạn mức nhỏ nhất đặt được (limits_min) và ước số máy đạt cấu hình. Linux: không gọi nhà cung cấp. Windows: báo giá sống (gợi ý giá tối đa suggested_max_prices); nhóm không còn máy trống ⇒ 409 OUT_OF_STOCK. Chạy thử (X-Sandbox: 1): không gọi nhà cung cấp — Windows dùng báo giá đã lưu ≤ 60 giây; chưa có thì trả bản mô phỏng (sandbox: true · giá từ + số máy theo danh mục · suggested_max_prices rỗng). Máy kèm ổ lưu trữ (type = volume): volume_code (ổ active của bạn — /gpu/volumes) + machine (/gpu/products?type=volume) + template + cuda (máy GPU; máy CPU để trống) + max_amount / max_hours; trả price_hour (tính theo phút) · hold_amount · balance_floor (máy kèm ổ không tính băng thông — chỉ sàn của các máy khác đang tính) · can_order + blocked · limits_min · volume (name · size_gb · status · location · mount_path) · search_seconds · availability. Ổ đang thiếu tiền ⇒ 402 VOLUME_UNPAID. Không gọi nhà cung cấp; chạy thử nhận cả mã ổ mẫu SANDBOX… của /gpu/volumes/create. Khoá SSH: ssh_key_ids = mã khoá đã lưu (/account/ssh-keys) gộp với ssh_key — không gửi ssh_key_ids thì máy nhận các khoá «tự gắn» của tài khoản; trả ssh_keys = các khoá SẼ được cài vào máy (id · name · type · fingerprint; id / name null với khoá dán chưa lưu). Tuỳ chọn nâng cao (máy Linux · máy kèm ổ; máy Windows ⇒ 400): env (object) hoặc env_gz · ports · start_command hoặc start_command_gz — kiểm y như lệnh thuê; trả ports (public_host / public_port null — chưa có máy) · env_names · has_start_command · start_log_path. Không trả giá trị biến hay chữ lệnh. Ảnh Docker riêng (máy Linux theo mức): image = tên ảnh công khai THAY template + cuda (bỏ trống hai trường ấy) — kiểm y như lệnh thuê: registry nhận, ảnh công khai, có bản linux/amd64, nền Ubuntu hoặc Debian 12 trở xuống, chạy bằng root, cỡ nén, CUDA của ảnh với card, lượt thuê ảnh riêng không thành công trong 24 giờ; trả image (digest sẽ ghim lên máy · size_bytes nén · cuda · exposed_ports) và template = null. Ảnh không đạt ⇒ 400 kèm data.image_reason · hết lượt ⇒ 429 IMAGE_LIMIT · quá trần kiểm ảnh mới mỗi giờ ⇒ 429 RATE_LIMITED. Kiểm trước bằng POST /gpu/image-check. Mẫu đã lưu (máy Linux theo mức): saved_template = mã mẫu ở /gpu/saved-templates — máy dùng NGUYÊN phần mềm + ổ của mẫu (nền · disk_gb · khoá SSH · biến · cổng · lệnh khởi động), chỉ gửi trường của máy (card · tier · gpu_count · wait_minutes · region · bộ lọc · max_amount · max_hours); gửi kèm trường phần mềm (kể cả null) ⇒ 400. Kiểm như lệnh gõ tay (card × bản CUDA / ảnh của mẫu · công tắc · giá · hạn mức nhỏ nhất); trả saved_template {id · name · version} — version để gửi ở buy. saved_template_version (tuỳ chọn) lệch version hiện tại ⇒ 409 TEMPLATE_CHANGED kèm data.version.
POST https://cloudmoon.net/api/v1/gpu/quote| Tham số | Vị trí | Bắt buộc | Mô tả |
|---|---|---|---|
type |
body | không | linux (mặc định) | windows | volume (máy kèm ổ lưu trữ) |
card |
body | không | Linux — BẮT BUỘC: mã card trong /gpu/products |
tier |
body | không | Linux — BẮT BUỘC: saving | fast (không có mặc định) |
template |
body | có | mã mẫu cài sẵn (templates của card / nhóm) · volume: templates của loại máy · gửi image thì bỏ trống (ảnh riêng thay mẫu cài sẵn) · gửi saved_template thì bỏ trống (mẫu đã lưu thay cả phần mềm) |
cuda |
body | không | Linux — BẮT BUỘC: bản CUDA của mẫu (templates[].cuda) · volume: BẮT BUỘC với máy GPU, máy CPU để trống · gửi image thì bỏ trống · gửi saved_template thì bỏ trống |
disk_gb |
body | không | Linux: cỡ ổ (disk_sizes_gb; bỏ trống = default_disk_gb ở /gpu/products) · gửi saved_template thì bỏ trống (cỡ ổ theo mẫu) |
gpu_count |
body | không | Linux: số card một máy (gpu_counts; mặc định 1) |
wait_minutes |
body | không | Linux: thời gian chờ máy (wait_minutes của mức; mặc định fast 10 · saving 60) |
region |
body | không | Linux: vùng ƯU TIÊN (vùng ấy hết máy thì lấy vùng khác, giá không đổi) |
min_ram_gb |
body | không | Linux: RAM tối thiểu (filters.min_ram_gb) |
min_vcpu |
body | không | Linux: vCPU tối thiểu (filters.min_vcpu) |
nvme |
body | không | Linux: true = chỉ máy ổ NVMe |
group |
body | không | Windows — BẮT BUỘC: nhóm trong /gpu/products?type=windows |
max_price_hour |
body | không | Windows: giá tối đa mỗi giờ bạn chấp nhận (bỏ trống = giá gợi ý) |
volume_code |
body | không | volume — BẮT BUỘC: mã ổ lưu trữ của bạn (/gpu/volumes, status active) |
machine |
body | không | volume — BẮT BUỘC: loại máy (items[].machine ở /gpu/products?type=volume) |
max_amount |
body | không | hạn mức tổng tiền (đ) — 0 = không đặt |
max_hours |
body | không | hạn mức số giờ chạy — 0 = không đặt |
ssh_key |
body | không | khoá SSH công khai — một hoặc nhiều dòng; máy nhận các khoá này CỘNG các khoá «tự gắn» đã lưu ở trang Khoá SSH của tài khoản (tối đa 5 khoá một máy) — gửi ssh_key_ids thì khoá «tự gắn» được thay bằng đúng các khoá đã chọn |
ssh_key_ids |
body | không | mảng mã khoá đã lưu (/account/ssh-keys) — vắng / null ⇒ các khoá «tự gắn» · [] ⇒ không dùng khoá đã lưu nào; gộp với ssh_key, tối đa 5 khoá một máy; mã không thuộc tài khoản ⇒ 404 NOT_FOUND |
env |
body | không | object {"TEN_BIEN": "giá trị"} — biến môi trường của máy (Linux · máy kèm ổ): có trong mọi phiên SSH và trong lệnh khởi động. Tên: chữ, số, dấu gạch dưới, không bắt đầu bằng số; giá trị không chứa nháy kép, nháy đơn, gạch chéo ngược, dấu huyền, $, # và ký tự điều khiển. Trần + tên dành riêng: mục Tuỳ chọn nâng cao |
env_gz |
body | không | env dạng NÉN: chuỗi JSON object nén deflate thô (raw deflate — không đầu zlib / gzip) rồi mã hoá base64 — dùng khi bản thô bị chặn (HTTP 403 kèm trang HTML). Không gửi cùng env |
ports |
body | không | mảng cổng TCP mở ra Internet, vd [8000, 7860] — 1–65535, khác 22, không trùng; dịch vụ trong máy phải nghe ở 0.0.0.0; địa chỉ ngoài đọc ở ports của /gpu/info |
start_command |
body | không | lệnh bash chạy NỀN mỗi lần máy khởi động (nhiều dòng được; thư mục /workspace, không có thì /root) — kết quả ghi ở start_log_path TRONG máy; lệnh lỗi không ảnh hưởng việc giao máy |
start_command_gz |
body | không | start_command dạng NÉN (deflate thô rồi base64) — dùng khi bản thô bị chặn (HTTP 403 kèm trang HTML). Không gửi cùng start_command |
image |
body | không | Linux theo mức: tên ảnh Docker CÔNG KHAI — vd vllm/vllm-openai:latest · ghcr.io/ten/anh:tag, ghim được …@sha256:<digest>; máy chạy ảnh này thay mẫu cài sẵn (bỏ template + cuda). Registry nhận: custom_image.registries ở /gpu/products · kiểm trước: POST /gpu/image-check |
saved_template |
body | không | Linux theo mức: mã mẫu đã lưu (/gpu/saved-templates) — máy dùng NGUYÊN phần mềm + ổ của mẫu; KHÔNG gửi kèm template · cuda · image · disk_gb · ssh_key · ssh_key_ids · env · env_gz · ports · start_command · start_command_gz (kể cả null) ⇒ 400 |
saved_template_version |
body | không | version của mẫu đã xem — gửi thì so (mẫu vừa sửa ⇒ 409 TEMPLATE_CHANGED kèm data.version); bỏ trống ⇒ dùng bản hiện tại, phản hồi trả saved_template.version để gửi ở buy |
Chạy thử Lệnh đọc — gửi kèm X-Sandbox: 1 vẫn chạy như thường (không đổi gì).
curl -X POST 'https://cloudmoon.net/api/v1/gpu/quote' \
-H 'X-API-Key: ak_...' \
-H 'Content-Type: application/json' \
-d '{"type":"linux","card":"gtx1080ti","tier":"fast","template":"pytorch","cuda":"12.4"}'import requests
r = requests.post(
"https://cloudmoon.net/api/v1/gpu/quote",
headers={"X-API-Key": "ak_..."},
json={"type": "linux", "card": "gtx1080ti", "tier": "fast", "template": "pytorch", "cuda": "12.4"},
timeout=30,
)
print(r.status_code, r.json())// Node.js 18+ — lưu thành tệp .mjs
const res = await fetch("https://cloudmoon.net/api/v1/gpu/quote", {
method: "POST",
headers: {
"X-API-Key": "ak_...",
"Content-Type": "application/json",
},
body: JSON.stringify({ type: "linux", card: "gtx1080ti", tier: "fast", template: "pytorch", cuda: "12.4" }),
});
console.log(res.status, await res.json());// cm_api(): xem mục "Client mẫu" ở trang Tổng quan
$kq = cm_api('POST', '/v1/gpu/quote', ['type' => 'linux', 'card' => 'gtx1080ti', 'tier' => 'fast', 'template' => 'pytorch', 'cuda' => '12.4']);
print_r($kq);{
"type": "linux",
"card": "gtx1080ti",
"tier": "fast",
"template": "pytorch",
"cuda": "12.4"
}{
"status": "success",
"msg": "OK",
"data": {
"type": "linux",
"card": "gtx1080ti",
"name": "GTX 1080 Ti",
"vram_gb": 11,
"gpu_count": 1,
"tier": "fast",
"wait_minutes": 10,
"template": "pytorch",
"cuda": "12.4",
"disk_gb": 30,
"region": null,
"filters": {
"min_ram_gb": null,
"min_vcpu": null,
"nvme": false
},
"billing": "minute",
"price_hour": 4500,
"min_minutes": 1,
"currency": "VND",
"hold_hours": 1,
"hold_amount": 4500,
"balance_floor": 10000,
"balance": 250000,
"available_balance": 250000,
"enough": true,
"can_order": true,
"blocked": null,
"max_amount": 0,
"max_hours": 0,
"limits_min": {
"max_amount": 900,
"max_hours": 1
},
"availability": {
"machines": 27,
"more": false,
"sampled_at": "2026-11-13T08:00:12+07:00"
},
"ssh_keys": [
{
"id": 12,
"name": "laptop",
"type": "ssh-ed25519",
"fingerprint": "SHA256:m01GjYNaMp/HHfXEVr4XfLk9COmgsZLrfQONnPvGTzM"
}
],
"ports": [
{
"port": 8000,
"public_host": null,
"public_port": null
}
],
"env_names": [
"HF_TOKEN",
"MODEL"
],
"has_start_command": true,
"start_log_path": "/var/log/gpu-start.log",
"image": {
"name": "ollama/ollama:latest",
"reference": "docker.io/ollama/ollama:latest",
"registry": "docker.io",
"digest": "sha256:c46478678875d60e84ebba1a7537dc4c964c22a88567422a1a4563e286c2fa26",
"size_bytes": 2105383936,
"cuda": null,
"cuda_min_driver": null,
"exposed_ports": [
{
"port": 11434,
"public_host": null,
"public_port": null
}
]
},
"saved_template": {
"id": 45,
"name": "vLLM Qwen 8B",
"version": 3
}
}
}/gpu/image-check
Chỉ đọcKIỂM một ảnh Docker công khai trước khi thuê máy bằng ảnh ấy — CÙNG bộ kiểm với quote / buy và nút «Kiểm ảnh» trên web: ảnh phải công khai (kéo được không cần đăng nhập) ở một registry trong custom_image.registries, có bản linux/amd64, nền Ubuntu hoặc Debian 12 trở xuống, chạy bằng root, không quá max_size_gb (nén); gửi card thì xét luôn bản CUDA của ảnh với card. Ảnh đạt ⇒ ok = true + image (digest sẽ ghim lên máy · size_bytes nén · os · cuda · cuda_min_driver · exposed_ports · default_command = lệnh gốc ENTRYPOINT + CMD — máy chạy chế độ SSH nên KHÔNG tự chạy lệnh này, đặt vào start_command nếu cần). Ảnh không đạt ⇒ vẫn 200 với ok = false + reason (invalid_reference · registry_not_allowed · not_found · no_linux_amd64 · too_large · non_root_user · unsupported_base_os · gpu_incompatible · unsupported_format) + message nói rõ cách sửa. quota = lượt thuê bằng ảnh riêng: limit · remaining · failed_24h · waiting_orders (đơn ảnh riêng đang chờ máy) · next_free_at. Tính năng tạm ngưng ⇒ 503 MAINTENANCE · registry tạm không trả lời ⇒ 503 UNAVAILABLE (không tính vào quota) · quá custom_image.uncached_checks_per_hour lượt kiểm ảnh mới trong một giờ ⇒ 429 RATE_LIMITED kèm Retry-After (data.image_reason = rate_limited; ảnh vừa kiểm gần đây vẫn qua). Khoá chỉ đọc gọi được; nhịp theo tài khoản chung với web (mục Giới hạn theo tài khoản). Chạy thử (X-Sandbox: 1) không hỏi registry: dùng kết quả kiểm thật gần đây, chưa có thì trả kết quả mô phỏng (sandbox: true; digest · cỡ · nền · CUDA · cổng · lệnh gốc để trống).
POST https://cloudmoon.net/api/v1/gpu/image-check| Tham số | Vị trí | Bắt buộc | Mô tả |
|---|---|---|---|
image |
body | có | tên ảnh Docker công khai — vd vllm/vllm-openai:latest · ghcr.io/ten/anh:tag · ten/anh@sha256:<digest> |
card |
body | không | mã card (/gpu/products?type=linux) — gửi thì xét CUDA của ảnh với card |
Chạy thử Lệnh đọc — gửi kèm X-Sandbox: 1 vẫn chạy như thường (không đổi gì).
curl -X POST 'https://cloudmoon.net/api/v1/gpu/image-check' \
-H 'X-API-Key: ak_...' \
-H 'Content-Type: application/json' \
-d '{"image":"ollama/ollama:latest","card":"rtx4090"}'import requests
r = requests.post(
"https://cloudmoon.net/api/v1/gpu/image-check",
headers={"X-API-Key": "ak_..."},
json={"image": "ollama/ollama:latest", "card": "rtx4090"},
timeout=30,
)
print(r.status_code, r.json())// Node.js 18+ — lưu thành tệp .mjs
const res = await fetch("https://cloudmoon.net/api/v1/gpu/image-check", {
method: "POST",
headers: {
"X-API-Key": "ak_...",
"Content-Type": "application/json",
},
body: JSON.stringify({ image: "ollama/ollama:latest", card: "rtx4090" }),
});
console.log(res.status, await res.json());// cm_api(): xem mục "Client mẫu" ở trang Tổng quan
$kq = cm_api('POST', '/v1/gpu/image-check', ['image' => 'ollama/ollama:latest', 'card' => 'rtx4090']);
print_r($kq);{
"image": "ollama/ollama:latest",
"card": "rtx4090"
}{
"status": "success",
"msg": "OK",
"data": {
"ok": true,
"reason": null,
"message": null,
"image": {
"name": "ollama/ollama:latest",
"reference": "docker.io/ollama/ollama:latest",
"registry": "docker.io",
"digest": "sha256:c46478678875d60e84ebba1a7537dc4c964c22a88567422a1a4563e286c2fa26",
"size_bytes": 2105383936,
"cuda": null,
"cuda_min_driver": null,
"exposed_ports": [
{
"port": 11434,
"public_host": null,
"public_port": null
}
],
"os": "Ubuntu 24.04",
"default_command": "/bin/ollama serve"
},
"quota": {
"limit": 3,
"remaining": 3,
"failed_24h": 0,
"waiting_orders": 0,
"next_free_at": null
}
}
}/gpu/saved-templates
Chỉ đọcMẫu đã lưu của tài khoản, sửa gần nhất trước — cùng danh sách tab «Mẫu của tôi» trên web. Mỗi mẫu = công thức PHẦN MỀM + Ổ cho máy Linux thuê theo mức: nền (template + cuda, hoặc image) · disk_gb · ssh_key_ids (null = các khoá «tự gắn» lúc thuê · [] = không khoá đã lưu) · missing_ssh_key_ids (khoá đã bị xoá khỏi tài khoản) · env_names (chỉ TÊN biến) · ports · has_start_command · warnings (thuê bằng mẫu sẽ bị chối tới khi sửa: ssh_key_deleted · template_unavailable · corrupted) · last_used_at (lần gần nhất thuê được máy từ mẫu). Không có chữ lệnh khởi động — đọc /gpu/saved-templates/info bằng khoá toàn quyền. max_templates = số mẫu tối đa một tài khoản. Khoá chỉ đọc gọi được.
GET https://cloudmoon.net/api/v1/gpu/saved-templatesKhông có tham số — chỉ cần header X-API-Key.
curl 'https://cloudmoon.net/api/v1/gpu/saved-templates' \
-H 'X-API-Key: ak_...'import requests
r = requests.get(
"https://cloudmoon.net/api/v1/gpu/saved-templates",
headers={"X-API-Key": "ak_..."},
timeout=30,
)
print(r.status_code, r.json())// Node.js 18+ — lưu thành tệp .mjs
const res = await fetch("https://cloudmoon.net/api/v1/gpu/saved-templates", {
headers: { "X-API-Key": "ak_..." },
});
console.log(res.status, await res.json());// cm_api(): xem mục "Client mẫu" ở trang Tổng quan
$kq = cm_api('GET', '/v1/gpu/saved-templates');
print_r($kq);{
"status": "success",
"msg": "OK",
"data": {
"items": [
{
"id": 45,
"name": "vLLM Qwen 8B",
"version": 3,
"template": null,
"cuda": null,
"image": "vllm/vllm-openai:latest",
"disk_gb": 100,
"ssh_key_ids": [
12
],
"missing_ssh_key_ids": [],
"env_names": [
"HF_TOKEN",
"MODEL"
],
"ports": [
8000
],
"has_start_command": true,
"warnings": [],
"created_at": "2026-11-17T07:42:10+07:00",
"updated_at": "2026-11-17T09:12:55+07:00",
"last_used_at": "2026-11-17T09:18:04+07:00"
}
],
"total": 1,
"max_templates": 20
}
}/gpu/saved-templates/info
Chỉ đọcMột mẫu đã lưu — cùng khối của /gpu/saved-templates + start_command (chữ lệnh khởi động) CHỈ với khoá toàn quyền (khoá chỉ đọc không có trường này). Giá trị biến môi trường không bao giờ trả về (chỉ env_names). Mẫu không có / không thuộc tài khoản ⇒ 404 NOT_FOUND.
GET https://cloudmoon.net/api/v1/gpu/saved-templates/info| Tham số | Vị trí | Bắt buộc | Mô tả |
|---|---|---|---|
id |
query | có | mã mẫu (items[].id ở /gpu/saved-templates) |
curl 'https://cloudmoon.net/api/v1/gpu/saved-templates/info?id=45' \
-H 'X-API-Key: ak_...'import requests
r = requests.get(
"https://cloudmoon.net/api/v1/gpu/saved-templates/info",
headers={"X-API-Key": "ak_..."},
params={"id": "45"},
timeout=30,
)
print(r.status_code, r.json())// Node.js 18+ — lưu thành tệp .mjs
const res = await fetch("https://cloudmoon.net/api/v1/gpu/saved-templates/info?id=45", {
headers: { "X-API-Key": "ak_..." },
});
console.log(res.status, await res.json());// cm_api(): xem mục "Client mẫu" ở trang Tổng quan
$kq = cm_api('GET', '/v1/gpu/saved-templates/info?id=45');
print_r($kq);{
"status": "success",
"msg": "OK",
"data": {
"id": 45,
"name": "vLLM Qwen 8B",
"version": 3,
"template": null,
"cuda": null,
"image": "vllm/vllm-openai:latest",
"disk_gb": 100,
"ssh_key_ids": [
12
],
"missing_ssh_key_ids": [],
"env_names": [
"HF_TOKEN",
"MODEL"
],
"ports": [
8000
],
"has_start_command": true,
"start_command": "vllm serve \"$MODEL\" --host 0.0.0.0 --port 8000",
"warnings": [],
"created_at": "2026-11-17T07:42:10+07:00",
"updated_at": "2026-11-17T09:12:55+07:00",
"last_used_at": "2026-11-17T09:18:04+07:00"
}
}/gpu/saved-templates/create
Toàn quyềnLưu MỘT mẫu — cùng luật nút «Lưu làm mẫu» trên web. Thân = name + CÙNG các trường phần mềm của /gpu/quote (template + cuda, hoặc image · disk_gb — bỏ trống ⇒ default_disk_gb · ssh_key_ids — vắng / null ⇒ các khoá «tự gắn» lúc thuê, [] ⇒ không khoá đã lưu · env | env_gz · ports · start_command | start_command_gz), kiểm y như lệnh thuê (ảnh mới kiểm qua registry như image-check — cùng nhịp + trần giờ); khoá công khai thô (ssh_key) không vào mẫu ⇒ 400 — lưu ở /account/ssh-keys/create rồi gửi mã. HOẶC name + from_order_code (máy Linux theo mức của bạn, đang chạy hoặc trả ≤ 30 ngày) + pin_image? — chép phần mềm + ổ của máy ấy ngay ở máy chủ; khoá dán lúc thuê không vào mẫu (số khoá bỏ ở dropped_ssh_keys). Đủ số mẫu ⇒ 429 TEMPLATE_LIMIT. Trả khối mẫu (không có chữ lệnh). Chạy thử (X-Sandbox: 1): kiểm như thật rồi trả mẫu mô phỏng id = null — không lưu gì.
POST https://cloudmoon.net/api/v1/gpu/saved-templates/create| Tham số | Vị trí | Bắt buộc | Mô tả |
|---|---|---|---|
Idempotency-Key |
header | không | tuỳ chọn — tên mẫu được trùng nên gửi lại không kèm khoá sẽ lưu thêm một mẫu; gửi lại cùng khoá ⇒ đúng mẫu đã lưu |
name |
body | có | tên mẫu ≤ 60 ký tự (được trùng — mẫu gọi bằng id) |
template |
body | không | mã mẫu cài sẵn (templates ở /gpu/products) — đi cùng cuda; không gửi cùng image |
cuda |
body | không | bản CUDA của mẫu cài sẵn (templates[].cuda) |
image |
body | không | ảnh Docker công khai thay mẫu cài sẵn — lưu đúng chữ bạn gửi: tag ⇒ mỗi lần thuê lấy bản mới nhất của tag; ghim bằng …@sha256:<digest> |
disk_gb |
body | không | cỡ ổ (disk_sizes_gb ở /gpu/products) |
ssh_key_ids |
body | không | mã khoá đã lưu (/account/ssh-keys) — null ⇒ lúc thuê gắn các khoá «tự gắn» · [] ⇒ không khoá đã lưu |
env |
body | không | object {"TEN_BIEN": "giá trị"} — cùng luật /gpu/quote (mục Tuỳ chọn nâng cao) |
env_gz |
body | không | env dạng nén deflate thô rồi base64 (khi bản thô bị chặn) — không gửi cùng env |
ports |
body | không | mảng cổng TCP, vd [8000, 7860] |
start_command |
body | không | lệnh bash chạy nền mỗi lần máy khởi động |
start_command_gz |
body | không | start_command dạng nén (deflate thô rồi base64) — không gửi cùng start_command |
from_order_code |
body | không | thay cho các trường phần mềm: order_code của một máy Linux theo mức của bạn (đang chạy hoặc trả ≤ 30 ngày) — chép phần mềm + ổ của máy ấy |
pin_image |
body | không | chỉ cùng from_order_code: true ⇒ ghim đúng bản ảnh máy ấy chạy (mặc định false — ảnh theo tag như lúc thuê) |
Chạy thử Gửi kèm X-Sandbox: 1: máy chủ kiểm như lượt thật rồi trả kết quả mô phỏng cùng khuôn — không trừ tiền, không đổi gì. Kịch bản lỗi (X-Sandbox-Scenario): TEMPLATE_LIMIT (429) · RATE_LIMITED (429) · BUSY (429).
curl -X POST 'https://cloudmoon.net/api/v1/gpu/saved-templates/create' \
-H 'X-API-Key: ak_...' \
-H 'Idempotency-Key: 7f9c2e4b-1a2b-4c3d-9e8f-0123456789ab' \
-H 'Content-Type: application/json' \
-d '{"name":"vLLM Qwen 8B","image":"vllm/vllm-openai:latest","disk_gb":100,"ssh_key_ids":[12],"env":{"HF_TOKEN":"hf_...","MODEL":"Qwen/Qwen3-8B"},"ports":[8000],"start_command":"vllm serve \"$MODEL\" --host 0.0.0.0 --port 8000"}'import uuid
import requests
r = requests.post(
"https://cloudmoon.net/api/v1/gpu/saved-templates/create",
headers={"X-API-Key": "ak_...", "Idempotency-Key": str(uuid.uuid4())},
json={"name": "vLLM Qwen 8B", "image": "vllm/vllm-openai:latest", "disk_gb": 100, "ssh_key_ids": [12], "env": {"HF_TOKEN": "hf_...", "MODEL": "Qwen/Qwen3-8B"}, "ports": [8000], "start_command": "vllm serve \"$MODEL\" --host 0.0.0.0 --port 8000"},
timeout=30,
)
print(r.status_code, r.json())// Node.js 18+ — lưu thành tệp .mjs
import { randomUUID } from "node:crypto";
const res = await fetch("https://cloudmoon.net/api/v1/gpu/saved-templates/create", {
method: "POST",
headers: {
"X-API-Key": "ak_...",
"Content-Type": "application/json",
"Idempotency-Key": randomUUID(),
},
body: JSON.stringify({ name: "vLLM Qwen 8B", image: "vllm/vllm-openai:latest", disk_gb: 100, ssh_key_ids: [12], env: { HF_TOKEN: "hf_...", MODEL: "Qwen/Qwen3-8B" }, ports: [8000], start_command: "vllm serve \"$MODEL\" --host 0.0.0.0 --port 8000" }),
});
console.log(res.status, await res.json());// cm_api(): xem mục "Client mẫu" ở trang Tổng quan
$kq = cm_api('POST', '/v1/gpu/saved-templates/create', ['name' => 'vLLM Qwen 8B', 'image' => 'vllm/vllm-openai:latest', 'disk_gb' => 100, 'ssh_key_ids' => [12], 'env' => ['HF_TOKEN' => 'hf_...', 'MODEL' => 'Qwen/Qwen3-8B'], 'ports' => [8000], 'start_command' => 'vllm serve "$MODEL" --host 0.0.0.0 --port 8000'], bin2hex(random_bytes(16)));
print_r($kq);{
"name": "vLLM Qwen 8B",
"image": "vllm/vllm-openai:latest",
"disk_gb": 100,
"ssh_key_ids": [
12
],
"env": {
"HF_TOKEN": "hf_...",
"MODEL": "Qwen/Qwen3-8B"
},
"ports": [
8000
],
"start_command": "vllm serve \"$MODEL\" --host 0.0.0.0 --port 8000"
}{
"status": "success",
"msg": "Đã lưu mẫu «vLLM Qwen 8B»",
"data": {
"id": 45,
"name": "vLLM Qwen 8B",
"version": 1,
"template": null,
"cuda": null,
"image": "vllm/vllm-openai:latest",
"disk_gb": 100,
"ssh_key_ids": [
12
],
"missing_ssh_key_ids": [],
"env_names": [
"HF_TOKEN",
"MODEL"
],
"ports": [
8000
],
"has_start_command": true,
"warnings": [],
"created_at": "2026-11-17T07:42:10+07:00",
"updated_at": "2026-11-17T07:42:10+07:00",
"last_used_at": null
}
}/gpu/saved-templates/update
Toàn quyềnSửa một mẫu — id + version (version đang xem: mẫu vừa được sửa ở nơi khác ⇒ 409 TEMPLATE_CHANGED kèm data.version hiện tại, không đổi gì) + ít nhất một trường cần đổi; trường VẮNG giữ nguyên. Gửi nền là thay CẢ nền (template + cuda, hoặc image). env / env_gz = CHỈ các biến cần đổi: {"TEN": "giá trị"} thay / thêm · {"TEN": null} xoá · tên không gửi giữ nguyên (giá trị cũ không bao giờ trả về). ports: [] bỏ hết cổng · start_command: "" bỏ lệnh · ssh_key_ids: null về «tự gắn». Mỗi lần sửa version + 1; máy đã thuê từ mẫu không đổi. Trả khối mẫu sau khi sửa.
POST https://cloudmoon.net/api/v1/gpu/saved-templates/update| Tham số | Vị trí | Bắt buộc | Mô tả |
|---|---|---|---|
id |
body | có | mã mẫu |
version |
body | có | version đang xem (/gpu/saved-templates) |
name |
body | không | tên mới ≤ 60 ký tự |
template |
body | không | mã mẫu cài sẵn (templates ở /gpu/products) — đi cùng cuda; không gửi cùng image |
cuda |
body | không | bản CUDA của mẫu cài sẵn (templates[].cuda) |
image |
body | không | ảnh Docker công khai thay mẫu cài sẵn — lưu đúng chữ bạn gửi: tag ⇒ mỗi lần thuê lấy bản mới nhất của tag; ghim bằng …@sha256:<digest> |
disk_gb |
body | không | cỡ ổ (disk_sizes_gb ở /gpu/products) |
ssh_key_ids |
body | không | mã khoá đã lưu (/account/ssh-keys) — null ⇒ lúc thuê gắn các khoá «tự gắn» · [] ⇒ không khoá đã lưu |
env |
body | không | object {"TEN_BIEN": "giá trị"} — cùng luật /gpu/quote (mục Tuỳ chọn nâng cao) |
env_gz |
body | không | env dạng nén deflate thô rồi base64 (khi bản thô bị chặn) — không gửi cùng env |
ports |
body | không | mảng cổng TCP, vd [8000, 7860] |
start_command |
body | không | lệnh bash chạy nền mỗi lần máy khởi động |
start_command_gz |
body | không | start_command dạng nén (deflate thô rồi base64) — không gửi cùng start_command |
Chạy thử Gửi kèm X-Sandbox: 1: máy chủ kiểm như lượt thật rồi trả kết quả mô phỏng cùng khuôn — không trừ tiền, không đổi gì. Kịch bản lỗi (X-Sandbox-Scenario): TEMPLATE_CHANGED (409) · RATE_LIMITED (429).
curl -X POST 'https://cloudmoon.net/api/v1/gpu/saved-templates/update' \
-H 'X-API-Key: ak_...' \
-H 'Content-Type: application/json' \
-d '{"id":45,"version":3,"env":{"MODEL":"Qwen/Qwen3-14B","OLD_VAR":null},"ports":[8000,7860]}'import requests
r = requests.post(
"https://cloudmoon.net/api/v1/gpu/saved-templates/update",
headers={"X-API-Key": "ak_..."},
json={"id": 45, "version": 3, "env": {"MODEL": "Qwen/Qwen3-14B", "OLD_VAR": None}, "ports": [8000, 7860]},
timeout=30,
)
print(r.status_code, r.json())// Node.js 18+ — lưu thành tệp .mjs
const res = await fetch("https://cloudmoon.net/api/v1/gpu/saved-templates/update", {
method: "POST",
headers: {
"X-API-Key": "ak_...",
"Content-Type": "application/json",
},
body: JSON.stringify({ id: 45, version: 3, env: { MODEL: "Qwen/Qwen3-14B", OLD_VAR: null }, ports: [8000, 7860] }),
});
console.log(res.status, await res.json());// cm_api(): xem mục "Client mẫu" ở trang Tổng quan
$kq = cm_api('POST', '/v1/gpu/saved-templates/update', ['id' => 45, 'version' => 3, 'env' => ['MODEL' => 'Qwen/Qwen3-14B', 'OLD_VAR' => null], 'ports' => [8000, 7860]]);
print_r($kq);{
"id": 45,
"version": 3,
"env": {
"MODEL": "Qwen/Qwen3-14B",
"OLD_VAR": null
},
"ports": [
8000,
7860
]
}{
"status": "success",
"msg": "Đã lưu thay đổi của mẫu «vLLM Qwen 8B»",
"data": {
"id": 45,
"name": "vLLM Qwen 8B",
"version": 4,
"template": null,
"cuda": null,
"image": "vllm/vllm-openai:latest",
"disk_gb": 100,
"ssh_key_ids": [
12
],
"missing_ssh_key_ids": [],
"env_names": [
"HF_TOKEN",
"MODEL"
],
"ports": [
8000,
7860
],
"has_start_command": true,
"warnings": [],
"created_at": "2026-11-17T07:42:10+07:00",
"updated_at": "2026-11-17T10:05:31+07:00",
"last_used_at": "2026-11-17T09:18:04+07:00"
}
}/gpu/saved-templates/delete
Toàn quyềnXoá một mẫu. version (tuỳ chọn) = version đang xem ⇒ xoá có điều kiện (mẫu vừa được sửa ⇒ 409 TEMPLATE_CHANGED, mẫu còn nguyên). Máy đã thuê từ mẫu không đổi. Mẫu không có / đã xoá / không thuộc tài khoản ⇒ 404 NOT_FOUND.
POST https://cloudmoon.net/api/v1/gpu/saved-templates/delete| Tham số | Vị trí | Bắt buộc | Mô tả |
|---|---|---|---|
id |
body | có | mã mẫu |
version |
body | không | version đang xem — gửi thì xoá có điều kiện |
Chạy thử Gửi kèm X-Sandbox: 1: máy chủ kiểm như lượt thật rồi trả kết quả mô phỏng cùng khuôn — không trừ tiền, không đổi gì. Kịch bản lỗi (X-Sandbox-Scenario): TEMPLATE_CHANGED (409) · RATE_LIMITED (429).
curl -X POST 'https://cloudmoon.net/api/v1/gpu/saved-templates/delete' \
-H 'X-API-Key: ak_...' \
-H 'Content-Type: application/json' \
-d '{"id":45,"version":4}'import requests
r = requests.post(
"https://cloudmoon.net/api/v1/gpu/saved-templates/delete",
headers={"X-API-Key": "ak_..."},
json={"id": 45, "version": 4},
timeout=30,
)
print(r.status_code, r.json())// Node.js 18+ — lưu thành tệp .mjs
const res = await fetch("https://cloudmoon.net/api/v1/gpu/saved-templates/delete", {
method: "POST",
headers: {
"X-API-Key": "ak_...",
"Content-Type": "application/json",
},
body: JSON.stringify({ id: 45, version: 4 }),
});
console.log(res.status, await res.json());// cm_api(): xem mục "Client mẫu" ở trang Tổng quan
$kq = cm_api('POST', '/v1/gpu/saved-templates/delete', ['id' => 45, 'version' => 4]);
print_r($kq);{
"id": 45,
"version": 4
}{
"status": "success",
"msg": "Đã xoá mẫu — máy đã thuê từ mẫu không đổi",
"data": {
"id": 45,
"name": "vLLM Qwen 8B",
"version": 4,
"deleted": true
}
}/gpu/list
Chỉ đọcMáy GPU của tài khoản, mới nhất trước (không kèm mật khẩu). ?status=active (mặc định — đang tìm · đang tạo · đang chạy · đang trả) | closed | all. Phân trang. Gọi lệnh này được tính là bạn ĐANG CÓ MẶT (như mở trang máy trên web): máy giao lúc bạn vắng không bị tự trả sau 15 phút (gọi TRƯỚC hạn — hẹn đã quá thì máy vẫn được trả). Chạy thử (X-Sandbox: 1): chỉ đọc số đang lưu, không tính là có mặt. Mỗi máy có ssh_keys — các khoá SSH đã cài vào máy (như /gpu/info). Mỗi máy có ports · env_names · has_start_command · start_log_path (như /gpu/info, không kèm start_command). Mỗi máy có saved_template (mẫu đã lưu lúc thuê — như /gpu/info). Tạm dừng: active gồm cả máy stopping · paused · resuming (vẫn tính tiền giữ đĩa); mỗi máy có khối pause + billing.disk_fee như /gpu/info.
GET https://cloudmoon.net/api/v1/gpu/list| Tham số | Vị trí | Bắt buộc | Mô tả |
|---|---|---|---|
status |
query | không | active (mặc định) | closed | all |
limit |
query | không | 1-200, mặc định 50 |
page |
query | không | Trang, tính từ 1 |
curl 'https://cloudmoon.net/api/v1/gpu/list' \
-H 'X-API-Key: ak_...'import requests
r = requests.get(
"https://cloudmoon.net/api/v1/gpu/list",
headers={"X-API-Key": "ak_..."},
timeout=30,
)
print(r.status_code, r.json())// Node.js 18+ — lưu thành tệp .mjs
const res = await fetch("https://cloudmoon.net/api/v1/gpu/list", {
headers: { "X-API-Key": "ak_..." },
});
console.log(res.status, await res.json());// cm_api(): xem mục "Client mẫu" ở trang Tổng quan
$kq = cm_api('GET', '/v1/gpu/list');
print_r($kq);{
"status": "success",
"msg": "OK",
"data": {
"items": [
{
"order_code": "131126GPUABCDEFGHJK",
"status": "running",
"type": "linux",
"tier": "fast",
"gpu": {
"model": "GTX 1080 Ti",
"vram_gb": 11,
"count": 1
},
"os": "linux",
"template": "pytorch",
"cuda": "12.4",
"disk_gb": 30,
"country": "ca",
"note": "train-01",
"channel": "api",
"created_at": "2026-11-13T09:15:02+07:00",
"delivered_at": "2026-11-13T09:17:40+07:00",
"stopped_at": null,
"end_reason": null,
"absent_release_at": null,
"billing": {
"mode": "minute",
"price_hour": 4500,
"min_minutes": 1,
"charged": 4500,
"machine_fee": 675,
"bandwidth_fee": 0,
"bandwidth_gb": 0,
"bandwidth_price_gb": 52,
"estimate": 675,
"refund_estimate": 3825,
"used_seconds": 540,
"started_at": "2026-11-13T09:16:58+07:00",
"paid_until": "2026-11-13T10:16:58+07:00",
"settlement": null
},
"waiting": null,
"limits": {
"max_amount": 20000,
"max_hours": 0,
"auto_release_at": "2026-11-13T13:41:58+07:00",
"warning": false,
"min_max_amount": 1575,
"min_max_hours": 1
},
"connection": {
"host": "203.0.113.40",
"username": "root",
"ssh": {
"port": 40122,
"command": "ssh -p 40122 [email protected]"
},
"rdp": null
},
"ssh_keys": [
{
"id": 12,
"name": "laptop",
"type": "ssh-ed25519",
"fingerprint": "SHA256:m01GjYNaMp/HHfXEVr4XfLk9COmgsZLrfQONnPvGTzM"
}
],
"ports": [
{
"port": 8000,
"public_host": "203.0.113.40",
"public_port": 40123
}
],
"env_names": [
"HF_TOKEN",
"MODEL"
],
"has_start_command": true,
"start_log_path": "/var/log/gpu-start.log",
"image": {
"name": "ollama/ollama:latest",
"reference": "docker.io/ollama/ollama:latest",
"registry": "docker.io",
"digest": "sha256:c46478678875d60e84ebba1a7537dc4c964c22a88567422a1a4563e286c2fa26",
"size_bytes": 2105383936,
"cuda": null,
"cuda_min_driver": null,
"exposed_ports": [
{
"port": 11434,
"public_host": "203.0.113.40",
"public_port": 40125
}
]
},
"saved_template": {
"id": 45,
"name": "vLLM Qwen 8B",
"version": 3
},
"pause": {
"supported": true,
"disk_price_hour": null,
"paused_at": null,
"disk_paid_until": null,
"balance_covers_hours": null,
"delete_at": null,
"contract_end": "2026-12-13T09:17:40+07:00",
"pending_action": null,
"last_action": null,
"cooldown_seconds": 0
},
"volume": null,
"allowed_actions": [
"restart",
"delete",
"limits",
"note"
]
}
],
"page": 1,
"limit": 50,
"total": 1
}
}/gpu/info
Chỉ đọcChi tiết một máy GPU: status (searching · provisioning · running · releasing — đã ngừng tính tiền, đang gỡ · settling — đã gỡ, chờ quyết toán · released · cancelled · expired · failed) · máy · billing (cùng số trang máy: đã trừ · phí máy · băng thông · tạm tính · hoàn ước tính · quyết toán) · waiting (đơn đang tìm máy: hạn chờ · giá nhanh nếu muốn chuyển) · limits (hạn mức + lúc dự kiến tự trả + mức nhỏ nhất đặt được) · connection (SSH / RDP — password CHỈ kèm khi khoá TOÀN QUYỀN và máy đang chạy) · end_reason · allowed_actions · wallet. Gọi lệnh này được tính là bạn ĐANG CÓ MẶT (như mở trang máy trên web). Chạy thử (X-Sandbox: 1): chỉ đọc số đang lưu — không đồng bộ máy, không tính là có mặt. Mã SANDBOX… (lệnh thuê chạy thử) chỉ đọc được kèm X-Sandbox: 1 — máy mẫu theo tuổi mã (< 10 s searching · < 40 s provisioning · sau đó running, hoặc failed với kịch bản PROVISION_FAILED; chạm hạn mức ⇒ released), mật khẩu mẫu Sandbox-…; lệnh huỷ / trả mô phỏng không đổi máy mẫu (không lưu gì). Máy mẫu KHÔNG mang ghi chú (note luôn null — mã chỉ mang lựa chọn máy + hạn mức) · mã thử sống 62 ngày kể từ lúc tạo (quá ⇒ 404). Máy kèm ổ lưu trữ (type = volume): machine {code, kind gpu | cpu} · cpu {vcpu} (máy CPU — khi ấy gpu = null) · volume {code, name, size_gb, mount_path = /workspace, status: creating · active · overdue · deleting · deleted · failed}; disk_gb là ổ hệ điều hành của máy (mất khi trả máy), dữ liệu cần giữ để trong ổ lưu trữ; end_reason thêm volume_unavailable (ổ không gắn được vào máy — tiền giữ trước hoàn đủ). ssh_keys = các khoá SSH đã cài vào máy lúc thuê (id · name · type · fingerprint SHA256 như ssh-keygen -l; id / name null khi khoá không còn hoặc chưa từng lưu trong tài khoản) — xoá khoá khỏi tài khoản không gỡ khỏi máy; máy mẫu SANDBOX… không mang khoá ⇒ []. Tuỳ chọn nâng cao: ports = cổng TCP đã mở — public_host:public_port là địa chỉ từ Internet (null tới khi máy running; khởi động lại có thể đổi — đọc lại) · env_names (CHỈ tên biến — giá trị không bao giờ trả lại) · has_start_command · start_log_path (log lệnh khởi động TRONG máy); start_command = chữ lệnh, CHỈ với khoá toàn quyền. Ảnh Docker riêng: image = ảnh của máy (name · reference · registry · digest đã ghim · size_bytes nén · cuda · cuda_min_driver · exposed_ports — cổng EXPOSE của ảnh, public_host:public_port có khi máy running); máy dùng mẫu cài sẵn ⇒ image = null; máy ảnh riêng có template = null. Mẫu đã lưu: saved_template {id · name · version} = mẫu máy được thuê từ, LÚC THUÊ (sửa / xoá mẫu sau đó không đổi); máy không dùng mẫu và máy mẫu SANDBOX… ⇒ null. Tạm dừng: status thêm stopping (đang tạm dừng — giờ chạy đã ngừng tính) · paused (đang giữ đĩa) · resuming (đang bật lại); pause = supported (máy Linux thuê theo mức) · disk_price_hour · paused_at · disk_paid_until (giữ đĩa đã trả tới) · balance_covers_hours (số dư đủ giữ đĩa thêm bao nhiêu giờ) · delete_at (mốc máy bị trả nếu số dư vẫn không đủ một giờ giữ đĩa) · contract_end (máy chủ giữ máy tới — tới hạn máy chủ dừng máy; đơn đóng với end_reason contract_ended khi xác nhận máy đã dừng, tính tiền tới mốc hạn) · pending_action · last_action (24 giờ: done · failed · no_capacity) · cooldown_seconds; billing.disk_fee = phần giữ đĩa NẰM TRONG machine_fee (settlement.disk_fee khi đã quyết toán); wallet thêm paused_machines · paused_hourly_total và hours_affordable tính cả tiền giữ đĩa; allowed_actions thêm stop · start; limits đặt được cả khi máy tạm dừng.
GET https://cloudmoon.net/api/v1/gpu/info| Tham số | Vị trí | Bắt buộc | Mô tả |
|---|---|---|---|
order_code |
query | có | Mã đơn (order_code) — lấy từ lệnh mua hoặc /list |
Chạy thử Nhận cả mã SANDBOX… của lệnh mua chạy thử ⇒ trả máy mẫu.
curl 'https://cloudmoon.net/api/v1/gpu/info?order_code=131126GPUABCDEFGHJK' \
-H 'X-API-Key: ak_...'import requests
r = requests.get(
"https://cloudmoon.net/api/v1/gpu/info",
headers={"X-API-Key": "ak_..."},
params={"order_code": "131126GPUABCDEFGHJK"},
timeout=30,
)
print(r.status_code, r.json())// Node.js 18+ — lưu thành tệp .mjs
const res = await fetch("https://cloudmoon.net/api/v1/gpu/info?order_code=131126GPUABCDEFGHJK", {
headers: { "X-API-Key": "ak_..." },
});
console.log(res.status, await res.json());// cm_api(): xem mục "Client mẫu" ở trang Tổng quan
$kq = cm_api('GET', '/v1/gpu/info?order_code=131126GPUABCDEFGHJK');
print_r($kq);{
"status": "success",
"msg": "OK",
"data": {
"order_code": "131126GPUABCDEFGHJK",
"status": "running",
"type": "linux",
"tier": "fast",
"gpu": {
"model": "GTX 1080 Ti",
"vram_gb": 11,
"count": 1
},
"os": "linux",
"template": "pytorch",
"cuda": "12.4",
"disk_gb": 30,
"country": "ca",
"note": "train-01",
"channel": "api",
"created_at": "2026-11-13T09:15:02+07:00",
"delivered_at": "2026-11-13T09:17:40+07:00",
"stopped_at": null,
"end_reason": null,
"absent_release_at": null,
"billing": {
"mode": "minute",
"price_hour": 4500,
"min_minutes": 1,
"charged": 4500,
"machine_fee": 675,
"bandwidth_fee": 0,
"bandwidth_gb": 0,
"bandwidth_price_gb": 52,
"estimate": 675,
"refund_estimate": 3825,
"used_seconds": 540,
"started_at": "2026-11-13T09:16:58+07:00",
"paid_until": "2026-11-13T10:16:58+07:00",
"settlement": null
},
"waiting": null,
"limits": {
"max_amount": 20000,
"max_hours": 0,
"auto_release_at": "2026-11-13T13:41:58+07:00",
"warning": false,
"min_max_amount": 1575,
"min_max_hours": 1
},
"connection": {
"host": "203.0.113.40",
"username": "root",
"ssh": {
"port": 40122,
"command": "ssh -p 40122 [email protected]"
},
"rdp": null,
"password": "S3cret-pass"
},
"ssh_keys": [
{
"id": 12,
"name": "laptop",
"type": "ssh-ed25519",
"fingerprint": "SHA256:m01GjYNaMp/HHfXEVr4XfLk9COmgsZLrfQONnPvGTzM"
}
],
"ports": [
{
"port": 8000,
"public_host": "203.0.113.40",
"public_port": 40123
}
],
"env_names": [
"HF_TOKEN",
"MODEL"
],
"has_start_command": true,
"start_log_path": "/var/log/gpu-start.log",
"start_command": "vllm serve Qwen/Qwen3-8B --host 0.0.0.0 --port 8000",
"image": {
"name": "ollama/ollama:latest",
"reference": "docker.io/ollama/ollama:latest",
"registry": "docker.io",
"digest": "sha256:c46478678875d60e84ebba1a7537dc4c964c22a88567422a1a4563e286c2fa26",
"size_bytes": 2105383936,
"cuda": null,
"cuda_min_driver": null,
"exposed_ports": [
{
"port": 11434,
"public_host": "203.0.113.40",
"public_port": 40125
}
]
},
"saved_template": {
"id": 45,
"name": "vLLM Qwen 8B",
"version": 3
},
"pause": {
"supported": true,
"disk_price_hour": null,
"paused_at": null,
"disk_paid_until": null,
"balance_covers_hours": null,
"delete_at": null,
"contract_end": "2026-12-13T09:17:40+07:00",
"pending_action": null,
"last_action": null,
"cooldown_seconds": 0
},
"volume": null,
"allowed_actions": [
"restart",
"delete",
"limits",
"note"
],
"wallet": {
"balance": 245500,
"running_machines": 1,
"hourly_total": 4500,
"balance_floor": 10000,
"hours_affordable": 52
},
"credentials_note": null
}
}/gpu/metrics
Chỉ đọcSố đo của một máy: current = số SỐNG khi máy đang chạy (GPU % · nhiệt · VRAM · CPU % · RAM · ổ — số máy không báo được thì null; stale: true = số cũ vài phút) + hardware (CPU · số nhân · RAM · tốc độ mạng · driver · CUDA tối đa · tốc độ đọc ổ; máy chỉ báo số vCPU ⇒ cpu_model = null, cpu_cores = số vCPU) · series = chuỗi theo range (3600 · 21600 · 86400 giây, tối đa 120 điểm). Chạy thử (X-Sandbox: 1): current = mẫu đã lưu gần nhất (không hỏi máy), hardware = null. Mã SANDBOX…: số mẫu cố định khi máy mẫu đang chạy, series rỗng.
GET https://cloudmoon.net/api/v1/gpu/metrics| Tham số | Vị trí | Bắt buộc | Mô tả |
|---|---|---|---|
order_code |
query | có | Mã đơn (order_code) — lấy từ lệnh mua hoặc /list |
range |
query | không | 3600 (mặc định) · 21600 · 86400 |
Chạy thử Nhận cả mã SANDBOX… của lệnh mua chạy thử ⇒ trả máy mẫu.
curl 'https://cloudmoon.net/api/v1/gpu/metrics?order_code=131126GPUABCDEFGHJK' \
-H 'X-API-Key: ak_...'import requests
r = requests.get(
"https://cloudmoon.net/api/v1/gpu/metrics",
headers={"X-API-Key": "ak_..."},
params={"order_code": "131126GPUABCDEFGHJK"},
timeout=30,
)
print(r.status_code, r.json())// Node.js 18+ — lưu thành tệp .mjs
const res = await fetch("https://cloudmoon.net/api/v1/gpu/metrics?order_code=131126GPUABCDEFGHJK", {
headers: { "X-API-Key": "ak_..." },
});
console.log(res.status, await res.json());// cm_api(): xem mục "Client mẫu" ở trang Tổng quan
$kq = cm_api('GET', '/v1/gpu/metrics?order_code=131126GPUABCDEFGHJK');
print_r($kq);{
"status": "success",
"msg": "OK",
"data": {
"order_code": "131126GPUABCDEFGHJK",
"status": "running",
"current": {
"at": "2026-11-13T09:26:01+07:00",
"gpu_util_pct": 97,
"gpu_temp_c": 71,
"vram_used_gb": 9.8,
"vram_total_gb": 11,
"cpu_util_pct": 34,
"ram_used_gb": 12.4,
"ram_total_gb": 31.6,
"disk_used_gb": 18.2,
"disk_total_gb": 30,
"stale": false
},
"hardware": {
"cpu_model": "Xeon E5-2630 v4",
"cpu_cores": 10,
"ram_gb": 32,
"net_up_mbps": 222,
"net_down_mbps": 536,
"driver": "580.159.03",
"cuda_max": 13,
"disk_read_mbps": 479
},
"range": 3600,
"series": [
{
"at": "2026-11-13T09:24:00+07:00",
"gpu_util_pct": 95.5,
"gpu_temp_c": 70,
"vram_used_gb": 9.7,
"vram_total_gb": 11,
"cpu_util_pct": 31,
"ram_used_gb": 12.1,
"ram_total_gb": 31.6,
"disk_used_gb": 18.1,
"disk_total_gb": 30
}
]
}
}/gpu/logs
Chỉ đọcNhật ký hoạt động của một máy, mới nhất trước — cùng nhật ký trang máy (tiền giữ / thu / hoàn · giao máy · khởi động lại · đổi kết nối · hạn mức · trả máy). kind: money · event · release. Không có log hệ thống bên trong máy. Mã SANDBOX…: nhật ký dựng theo tuổi máy mẫu.
GET https://cloudmoon.net/api/v1/gpu/logs| Tham số | Vị trí | Bắt buộc | Mô tả |
|---|---|---|---|
order_code |
query | có | Mã đơn (order_code) — lấy từ lệnh mua hoặc /list |
limit |
query | không | 1-100, mặc định 100 |
Chạy thử Nhận cả mã SANDBOX… của lệnh mua chạy thử ⇒ trả máy mẫu.
curl 'https://cloudmoon.net/api/v1/gpu/logs?order_code=131126GPUABCDEFGHJK' \
-H 'X-API-Key: ak_...'import requests
r = requests.get(
"https://cloudmoon.net/api/v1/gpu/logs",
headers={"X-API-Key": "ak_..."},
params={"order_code": "131126GPUABCDEFGHJK"},
timeout=30,
)
print(r.status_code, r.json())// Node.js 18+ — lưu thành tệp .mjs
const res = await fetch("https://cloudmoon.net/api/v1/gpu/logs?order_code=131126GPUABCDEFGHJK", {
headers: { "X-API-Key": "ak_..." },
});
console.log(res.status, await res.json());// cm_api(): xem mục "Client mẫu" ở trang Tổng quan
$kq = cm_api('GET', '/v1/gpu/logs?order_code=131126GPUABCDEFGHJK');
print_r($kq);{
"status": "success",
"msg": "OK",
"data": {
"order_code": "131126GPUABCDEFGHJK",
"items": [
{
"at": "2026-11-13T09:17:40+07:00",
"text": "Máy sẵn sàng — bắt đầu dùng",
"kind": "event"
},
{
"at": "2026-11-13T09:15:09+07:00",
"text": "Giữ trước 4.500đ cho giờ đầu (phần chưa dùng hoàn lại khi trả máy)",
"kind": "money"
}
],
"total": 2
}
}/gpu/charges
Chỉ đọcSổ tiền từng khoản của một máy, mới nhất trước. amount có dấu: dương = trừ ví · âm = hoàn về ví. type: hold (giữ trước — kể cả giữ thêm khi chuyển nhanh) · period (thu kỳ kế) · bandwidth (thu băng thông dần) · refund (hoàn khi quyết toán) · extra_charge / bandwidth_settlement (thu bù khi quyết toán) · extra_charge_partial / bandwidth_settlement_partial (thu bù khi ví không đủ — dòng ghi phần ĐÃ thu, phần còn thiếu ở billing.settlement.debt của /gpu/info; ví không bao giờ âm) · manual_refund (hỗ trợ hoàn). from / to = khoảng thời gian của khoản (khoản hoàn / thu bù: from = to = mốc ngừng tính tiền; created_at = lúc ghi khoản). summary: tổng trừ · tổng hoàn · ròng. Mã SANDBOX…: sổ dựng theo tuổi máy mẫu (giữ trước · kỳ thu kế · hoàn lúc trả). Tạm dừng: type thêm disk_storage (thu trước một giờ giữ đĩa khi máy tạm dừng) · pause_refund (hoàn phần giờ chạy đã giữ dư lúc máy tạm dừng) · disk_refund (hoàn phần giữ đĩa chưa dùng lúc bật lại) · resume_refund (hoàn khoản giữ trước khi bật lại không thành); giữ trước lúc bật lại là hold.
GET https://cloudmoon.net/api/v1/gpu/charges| Tham số | Vị trí | Bắt buộc | Mô tả |
|---|---|---|---|
order_code |
query | có | Mã đơn (order_code) — lấy từ lệnh mua hoặc /list |
limit |
query | không | 1-200, mặc định 100 |
Chạy thử Nhận cả mã SANDBOX… của lệnh mua chạy thử ⇒ trả máy mẫu.
curl 'https://cloudmoon.net/api/v1/gpu/charges?order_code=131126GPUABCDEFGHJK' \
-H 'X-API-Key: ak_...'import requests
r = requests.get(
"https://cloudmoon.net/api/v1/gpu/charges",
headers={"X-API-Key": "ak_..."},
params={"order_code": "131126GPUABCDEFGHJK"},
timeout=30,
)
print(r.status_code, r.json())// Node.js 18+ — lưu thành tệp .mjs
const res = await fetch("https://cloudmoon.net/api/v1/gpu/charges?order_code=131126GPUABCDEFGHJK", {
headers: { "X-API-Key": "ak_..." },
});
console.log(res.status, await res.json());// cm_api(): xem mục "Client mẫu" ở trang Tổng quan
$kq = cm_api('GET', '/v1/gpu/charges?order_code=131126GPUABCDEFGHJK');
print_r($kq);{
"status": "success",
"msg": "OK",
"data": {
"order_code": "131126GPUABCDEFGHJK",
"items": [
{
"type": "refund",
"amount": -3825,
"from": "2026-11-13T09:31:12+07:00",
"to": "2026-11-13T09:31:12+07:00",
"created_at": "2026-11-13T09:31:12+07:00"
},
{
"type": "hold",
"amount": 4500,
"from": "2026-11-13T09:15:09+07:00",
"to": "2026-11-13T10:15:09+07:00",
"created_at": "2026-11-13T09:15:09+07:00"
}
],
"total": 2,
"summary": {
"charged": 4500,
"refunded": 3825,
"net": 675
}
}
}/gpu/buy
Toàn quyềnThuê một máy GPU — BẤT ĐỒNG BỘ: trả HTTP 202 kèm order_code, hệ thống giữ trước tiền ở bước đầu (Linux theo mức: ngay sau lệnh thuê · Windows: khi đã thấy máy hợp giá tối đa) rồi tìm máy ở nền; hỏi /gpu/info?order_code= tới khi status = running (connection có SSH / RDP). Thân = thân /gpu/quote + Linux: price_hour BẮT BUỘC (giá / giờ đã xem ở quote — giá đổi ⇒ 409 PRICE_CHANGED kèm data.price_hour, chưa giữ đồng nào) · Windows: max_price_hour BẮT BUỘC (máy rẻ nhất ≤ mức này). Giữ trước hold_amount (giá × giờ giữ) từ số dư khả dụng + để yên balance_floor cho phí băng thông; hết thời gian chờ mà chưa có máy ⇒ tự huỷ, hoàn đủ (status expired). Trần: max_machines máy cùng lúc (429 MACHINE_LIMIT) · số lượt thuê mỗi giờ (429 RATE_LIMITED). Gọi /gpu/info hoặc /gpu/list = bạn đang có mặt — máy giao lúc vắng quá 3 phút mà 15 phút không ai hỏi thì tự trả. Nên đặt max_amount / max_hours để máy tự trả khi chạm mức. Thử miễn phí: header X-Sandbox: 1 (mã SANDBOX… — máy mẫu đi searching → provisioning → running). Máy kèm ổ lưu trữ (type = volume): thân = volume_code + machine + template + cuda (máy GPU) + price_hour BẮT BUỘC (giá / giờ đã xem ở quote type=volume) + ssh_key · max_amount · max_hours · note. Ổ gắn vào máy ở /workspace — dữ liệu còn nguyên sau khi trả máy. Không có hàng chờ theo mức: giữ trước rồi tìm máy trong search_seconds giây (/gpu/products?type=volume), không có máy ⇒ failed (out_of_capacity), hoàn đủ; cancel / upgrade không dùng được (400 NOT_SUPPORTED). Tính theo PHÚT, không tính băng thông, luật vắng mặt không áp; hạn mức áp như máy Linux. Ổ đang thiếu tiền ⇒ 402 VOLUME_UNPAID. Chạy thử nhận cả mã ổ mẫu SANDBOX… của /gpu/volumes/create. Khoá SSH: ssh_key_ids (mã khoá ở /account/ssh-keys) chọn khoá đã lưu thay cho khoá «tự gắn», gộp với ssh_key, tối đa 5 khoá một máy — mã không thuộc tài khoản ⇒ 404 NOT_FOUND (chưa giữ đồng nào); phản hồi 202 có ssh_keys = các khoá sẽ được cài vào máy. Tuỳ chọn nâng cao (máy Linux · máy kèm ổ; Windows ⇒ 400): env | env_gz · ports · start_command | start_command_gz (mục Tuỳ chọn nâng cao của trang này) — máy nhận biến + lệnh lúc giao, lệnh chạy lại mỗi lần máy khởi động; phản hồi 202 có ports · env_names · has_start_command · start_log_path, KHÔNG có giá trị biến hay chữ lệnh. Đổi tuỳ chọn mà giữ Idempotency-Key ⇒ 422 IDEMPOTENCY_MISMATCH. Ảnh Docker riêng (máy Linux theo mức): image THAY template + cuda — kiểm như quote rồi ghim digest lên đơn (máy chạy ĐÚNG bản đã kiểm, tag đổi sau đó không ảnh hưởng); phản hồi 202 có image + template = null. Máy kéo ảnh lúc khởi động — ảnh lớn chờ lâu hơn, chưa tính tiền trong lúc chờ; máy nào kéo / chạy ảnh hỏng thì hệ thống thử máy khác, vẫn hỏng ⇒ đơn failed (end_reason image_failed), hoàn đủ và tính một lượt không thành công (custom_image.failed_order_limit_24h ở /gpu/products). Máy chạy chế độ SSH nên KHÔNG tự chạy lệnh gốc của ảnh — đặt vào start_command (default_command ở /gpu/image-check). Mẫu đã lưu: saved_template + saved_template_version (BẮT BUỘC khi dùng mẫu — version đã xem ở quote / saved-templates): mẫu đổi sau lúc xem ⇒ 409 TEMPLATE_CHANGED kèm data.version, chưa giữ đồng nào. Máy chụp cấu hình mẫu LÚC THUÊ — sửa / xoá mẫu sau đó không đổi máy; phản hồi 202 có saved_template. Gửi lại cùng Idempotency-Key + cùng thân ⇒ đúng đơn cũ kể cả khi mẫu đã sửa.
POST https://cloudmoon.net/api/v1/gpu/buy| Tham số | Vị trí | Bắt buộc | Mô tả |
|---|---|---|---|
Idempotency-Key |
header | có | BẮT BUỘC (thiếu ⇒ 400 IDEMPOTENCY_KEY_REQUIRED) — gửi lại cùng khoá ⇒ đúng order_code cũ, không thuê hai máy |
type |
body | không | linux (mặc định) | windows | volume (máy kèm ổ lưu trữ) |
card |
body | không | Linux — BẮT BUỘC: mã card ở /gpu/products |
tier |
body | không | Linux — BẮT BUỘC: saving | fast (không có mặc định) |
price_hour |
body | không | Linux — BẮT BUỘC: giá / giờ đã xem ở /gpu/quote · volume: BẮT BUỘC (quote type=volume) |
group |
body | không | Windows — BẮT BUỘC: group ở /gpu/products?type=windows |
max_price_hour |
body | không | Windows — BẮT BUỘC: giá tối đa / giờ |
volume_code |
body | không | volume — BẮT BUỘC: mã ổ lưu trữ của bạn (/gpu/volumes, status active) |
machine |
body | không | volume — BẮT BUỘC: loại máy (items[].machine ở /gpu/products?type=volume) |
template |
body | có | mã mẫu cài sẵn (templates của card / nhóm) · volume: templates của loại máy · gửi image thì bỏ trống (ảnh riêng thay mẫu cài sẵn) · gửi saved_template thì bỏ trống (mẫu đã lưu thay cả phần mềm) |
cuda |
body | không | Linux — BẮT BUỘC: bản CUDA của mẫu (templates[].cuda) · volume: BẮT BUỘC với máy GPU, máy CPU để trống · gửi image thì bỏ trống · gửi saved_template thì bỏ trống |
disk_gb |
body | không | Linux — cỡ ổ (disk_sizes_gb; bỏ trống = default_disk_gb ở /gpu/products) · gửi saved_template thì bỏ trống (cỡ ổ theo mẫu) |
gpu_count |
body | không | Linux — số card một máy (gpu_counts) |
wait_minutes |
body | không | Linux — thời gian chờ tối đa (wait_minutes của mức) |
region |
body | không | Linux — vùng ưu tiên |
min_ram_gb |
body | không | Linux — bộ lọc RAM |
min_vcpu |
body | không | Linux — bộ lọc vCPU |
nvme |
body | không | Linux — true = chỉ máy ổ NVMe |
ssh_key |
body | không | khoá SSH công khai — một hoặc nhiều dòng; máy nhận các khoá này CỘNG các khoá «tự gắn» đã lưu ở trang Khoá SSH của tài khoản (tối đa 5 khoá một máy) — gửi ssh_key_ids thì khoá «tự gắn» được thay bằng đúng các khoá đã chọn |
ssh_key_ids |
body | không | mảng mã khoá đã lưu (/account/ssh-keys) — vắng / null ⇒ các khoá «tự gắn» · [] ⇒ không dùng khoá đã lưu nào; gộp với ssh_key, tối đa 5 khoá một máy; mã không thuộc tài khoản ⇒ 404 NOT_FOUND |
env |
body | không | object {"TEN_BIEN": "giá trị"} — biến môi trường của máy (Linux · máy kèm ổ): có trong mọi phiên SSH và trong lệnh khởi động. Tên: chữ, số, dấu gạch dưới, không bắt đầu bằng số; giá trị không chứa nháy kép, nháy đơn, gạch chéo ngược, dấu huyền, $, # và ký tự điều khiển. Trần + tên dành riêng: mục Tuỳ chọn nâng cao |
env_gz |
body | không | env dạng NÉN: chuỗi JSON object nén deflate thô (raw deflate — không đầu zlib / gzip) rồi mã hoá base64 — dùng khi bản thô bị chặn (HTTP 403 kèm trang HTML). Không gửi cùng env |
ports |
body | không | mảng cổng TCP mở ra Internet, vd [8000, 7860] — 1–65535, khác 22, không trùng; dịch vụ trong máy phải nghe ở 0.0.0.0; địa chỉ ngoài đọc ở ports của /gpu/info |
start_command |
body | không | lệnh bash chạy NỀN mỗi lần máy khởi động (nhiều dòng được; thư mục /workspace, không có thì /root) — kết quả ghi ở start_log_path TRONG máy; lệnh lỗi không ảnh hưởng việc giao máy |
start_command_gz |
body | không | start_command dạng NÉN (deflate thô rồi base64) — dùng khi bản thô bị chặn (HTTP 403 kèm trang HTML). Không gửi cùng start_command |
image |
body | không | Linux theo mức: tên ảnh Docker CÔNG KHAI — vd vllm/vllm-openai:latest · ghcr.io/ten/anh:tag, ghim được …@sha256:<digest>; máy chạy ảnh này thay mẫu cài sẵn (bỏ template + cuda). Registry nhận: custom_image.registries ở /gpu/products · kiểm trước: POST /gpu/image-check |
saved_template |
body | không | Linux theo mức: mã mẫu đã lưu (/gpu/saved-templates) — máy dùng NGUYÊN phần mềm + ổ của mẫu; KHÔNG gửi kèm template · cuda · image · disk_gb · ssh_key · ssh_key_ids · env · env_gz · ports · start_command · start_command_gz (kể cả null) ⇒ 400 |
saved_template_version |
body | không | BẮT BUỘC khi gửi saved_template: version đã xem ở /gpu/quote hoặc /gpu/saved-templates — mẫu đổi sau đó ⇒ 409 TEMPLATE_CHANGED kèm data.version, chưa giữ đồng nào |
max_amount |
body | không | hạn mức tiền (đ) — 0 = không đặt |
max_hours |
body | không | hạn mức giờ — 0 = không đặt |
note |
body | không | ghi chú máy ≤ 100 ký tự một dòng |
Chạy thử Gửi kèm X-Sandbox: 1: máy chủ kiểm như lượt thật rồi trả kết quả mô phỏng cùng khuôn — không trừ tiền, không đổi gì. Kịch bản lỗi (X-Sandbox-Scenario): INSUFFICIENT_BALANCE (402) · PRICE_CHANGED (409) · OUT_OF_STOCK (409) · MACHINE_LIMIT (429) · RATE_LIMITED (429) · BUSY (429) · SERVICE_DISABLED (503) · MAINTENANCE (503) · VOLUME_UNPAID (402) · PROVISION_FAILED (lệnh vẫn nhận, info về sau báo failed) · IMAGE_LIMIT (429) · TEMPLATE_CHANGED (409).
curl -X POST 'https://cloudmoon.net/api/v1/gpu/buy' \
-H 'X-API-Key: ak_...' \
-H 'Idempotency-Key: 7f9c2e4b-1a2b-4c3d-9e8f-0123456789ab' \
-H 'Content-Type: application/json' \
-d '{"type":"linux","card":"gtx1080ti","tier":"fast","template":"pytorch","cuda":"12.4","disk_gb":30,"price_hour":4500,"max_hours":2,"note":"train-01"}'import uuid
import requests
r = requests.post(
"https://cloudmoon.net/api/v1/gpu/buy",
headers={"X-API-Key": "ak_...", "Idempotency-Key": str(uuid.uuid4())},
json={"type": "linux", "card": "gtx1080ti", "tier": "fast", "template": "pytorch", "cuda": "12.4", "disk_gb": 30, "price_hour": 4500, "max_hours": 2, "note": "train-01"},
timeout=30,
)
print(r.status_code, r.json())// Node.js 18+ — lưu thành tệp .mjs
import { randomUUID } from "node:crypto";
const res = await fetch("https://cloudmoon.net/api/v1/gpu/buy", {
method: "POST",
headers: {
"X-API-Key": "ak_...",
"Content-Type": "application/json",
"Idempotency-Key": randomUUID(),
},
body: JSON.stringify({ type: "linux", card: "gtx1080ti", tier: "fast", template: "pytorch", cuda: "12.4", disk_gb: 30, price_hour: 4500, max_hours: 2, note: "train-01" }),
});
console.log(res.status, await res.json());// cm_api(): xem mục "Client mẫu" ở trang Tổng quan
$kq = cm_api('POST', '/v1/gpu/buy', ['type' => 'linux', 'card' => 'gtx1080ti', 'tier' => 'fast', 'template' => 'pytorch', 'cuda' => '12.4', 'disk_gb' => 30, 'price_hour' => 4500, 'max_hours' => 2, 'note' => 'train-01'], bin2hex(random_bytes(16)));
print_r($kq);{
"type": "linux",
"card": "gtx1080ti",
"tier": "fast",
"template": "pytorch",
"cuda": "12.4",
"disk_gb": 30,
"price_hour": 4500,
"max_hours": 2,
"note": "train-01"
}{
"status": "success",
"msg": "Đã nhận lệnh thuê — hệ thống đang tìm máy",
"data": {
"order_code": "131126GPUABCDEFGHJK",
"status": "searching",
"type": "linux",
"tier": "fast",
"gpu": {
"model": "GTX 1080 Ti",
"vram_gb": 11,
"count": 1
},
"cpu": null,
"machine": null,
"volume": null,
"template": "pytorch",
"cuda": "12.4",
"disk_gb": 30,
"region": null,
"billing": "minute",
"price_hour": 4500,
"max_price_hour": null,
"hold_amount": 4500,
"hold_hours": 1,
"wait_minutes": 10,
"max_amount": 0,
"max_hours": 2,
"note": "train-01",
"ssh_keys": [
{
"id": 12,
"name": "laptop",
"type": "ssh-ed25519",
"fingerprint": "SHA256:m01GjYNaMp/HHfXEVr4XfLk9COmgsZLrfQONnPvGTzM"
}
],
"ports": [
{
"port": 8000,
"public_host": null,
"public_port": null
}
],
"env_names": [
"HF_TOKEN",
"MODEL"
],
"has_start_command": true,
"start_log_path": "/var/log/gpu-start.log",
"image": {
"name": "ollama/ollama:latest",
"reference": "docker.io/ollama/ollama:latest",
"registry": "docker.io",
"digest": "sha256:c46478678875d60e84ebba1a7537dc4c964c22a88567422a1a4563e286c2fa26",
"size_bytes": 2105383936,
"cuda": null,
"cuda_min_driver": null,
"exposed_ports": [
{
"port": 11434,
"public_host": null,
"public_port": null
}
]
},
"saved_template": {
"id": 45,
"name": "vLLM Qwen 8B",
"version": 3
},
"created_at": "2026-11-13T10:18:38+07:00"
}
}/gpu/cancel
Toàn quyềnHuỷ đơn Linux theo mức đang TÌM MÁY (status searching) — hoàn ĐỦ tiền giữ trước. Máy vừa được tạo cho đơn ⇒ 409 MACHINE_ASSIGNED (đợi máy running rồi trả bằng /gpu/delete — chỉ tính thời gian đã dùng). Gọi lại khi đã huỷ ⇒ 200 như cũ. Máy Windows / kèm ổ ⇒ 400 NOT_SUPPORTED.
POST https://cloudmoon.net/api/v1/gpu/cancel| Tham số | Vị trí | Bắt buộc | Mô tả |
|---|---|---|---|
order_code |
body | có | Mã đơn (order_code) — lấy từ lệnh mua hoặc /list |
Chạy thử Gửi kèm X-Sandbox: 1: máy chủ kiểm như lượt thật rồi trả kết quả mô phỏng cùng khuôn — không trừ tiền, không đổi gì. Nhận cả mã SANDBOX… của lệnh mua chạy thử ⇒ trả máy mẫu. Kịch bản lỗi (X-Sandbox-Scenario): NOT_SUPPORTED (400) · MACHINE_ASSIGNED (409) · ORDER_CLOSED (409) · IN_PROGRESS (429) · RATE_LIMITED (429).
curl -X POST 'https://cloudmoon.net/api/v1/gpu/cancel' \
-H 'X-API-Key: ak_...' \
-H 'Content-Type: application/json' \
-d '{"order_code":"131126GPUABCDEFGHJK"}'import requests
r = requests.post(
"https://cloudmoon.net/api/v1/gpu/cancel",
headers={"X-API-Key": "ak_..."},
json={"order_code": "131126GPUABCDEFGHJK"},
timeout=30,
)
print(r.status_code, r.json())// Node.js 18+ — lưu thành tệp .mjs
const res = await fetch("https://cloudmoon.net/api/v1/gpu/cancel", {
method: "POST",
headers: {
"X-API-Key": "ak_...",
"Content-Type": "application/json",
},
body: JSON.stringify({ order_code: "131126GPUABCDEFGHJK" }),
});
console.log(res.status, await res.json());// cm_api(): xem mục "Client mẫu" ở trang Tổng quan
$kq = cm_api('POST', '/v1/gpu/cancel', ['order_code' => '131126GPUABCDEFGHJK']);
print_r($kq);{
"order_code": "131126GPUABCDEFGHJK"
}{
"status": "success",
"msg": "Đã huỷ đơn — 3.500đ tiền giữ trước đã về số dư",
"data": {
"order_code": "131126GPUABCDEFGHJK",
"status": "cancelled",
"refunded": 3500,
"refund_pending": false
}
}/gpu/upgrade
Toàn quyềnChuyển đơn TIẾT KIỆM đang tìm máy sang THUÊ NHANH: giữ THÊM (giá nhanh − giá tiết kiệm) × giờ giữ NGAY, hạn chờ mới 10 phút, tìm máy ngay. price_hour = giá nhanh / giờ đã xem (info.waiting.fast_price_hour — giá đổi ⇒ 409 PRICE_CHANGED kèm data.price_hour). Hạn mức tiền đặt lúc thuê chưa đủ 10 phút ở giá nhanh ⇒ 400 (huỷ rồi thuê lại). Đơn đã nhanh ⇒ 200.
POST https://cloudmoon.net/api/v1/gpu/upgrade| Tham số | Vị trí | Bắt buộc | Mô tả |
|---|---|---|---|
Idempotency-Key |
header | có | BẮT BUỘC (lệnh trừ tiền) — gửi lại cùng khoá ⇒ kết quả cũ, không giữ thêm hai lần |
order_code |
body | có | Mã đơn (order_code) — lấy từ lệnh mua hoặc /list |
price_hour |
body | có | giá thuê nhanh / giờ đã xem |
Chạy thử Gửi kèm X-Sandbox: 1: máy chủ kiểm như lượt thật rồi trả kết quả mô phỏng cùng khuôn — không trừ tiền, không đổi gì. Nhận cả mã SANDBOX… của lệnh mua chạy thử ⇒ trả máy mẫu. Kịch bản lỗi (X-Sandbox-Scenario): NOT_SUPPORTED (400) · NOT_WAITING (409) · PRICE_CHANGED (409) · INSUFFICIENT_BALANCE (402) · IN_PROGRESS (429) · RATE_LIMITED (429) · IDEMPOTENCY_PENDING (409) · UNAVAILABLE (503).
curl -X POST 'https://cloudmoon.net/api/v1/gpu/upgrade' \
-H 'X-API-Key: ak_...' \
-H 'Idempotency-Key: 7f9c2e4b-1a2b-4c3d-9e8f-0123456789ab' \
-H 'Content-Type: application/json' \
-d '{"order_code":"131126GPUABCDEFGHJK","price_hour":4500}'import uuid
import requests
r = requests.post(
"https://cloudmoon.net/api/v1/gpu/upgrade",
headers={"X-API-Key": "ak_...", "Idempotency-Key": str(uuid.uuid4())},
json={"order_code": "131126GPUABCDEFGHJK", "price_hour": 4500},
timeout=30,
)
print(r.status_code, r.json())// Node.js 18+ — lưu thành tệp .mjs
import { randomUUID } from "node:crypto";
const res = await fetch("https://cloudmoon.net/api/v1/gpu/upgrade", {
method: "POST",
headers: {
"X-API-Key": "ak_...",
"Content-Type": "application/json",
"Idempotency-Key": randomUUID(),
},
body: JSON.stringify({ order_code: "131126GPUABCDEFGHJK", price_hour: 4500 }),
});
console.log(res.status, await res.json());// cm_api(): xem mục "Client mẫu" ở trang Tổng quan
$kq = cm_api('POST', '/v1/gpu/upgrade', ['order_code' => '131126GPUABCDEFGHJK', 'price_hour' => 4500], bin2hex(random_bytes(16)));
print_r($kq);{
"order_code": "131126GPUABCDEFGHJK",
"price_hour": 4500
}{
"status": "success",
"msg": "Đã chuyển sang thuê nhanh — đang tìm máy ngay",
"data": {
"order_code": "131126GPUABCDEFGHJK",
"status": "searching",
"tier": "fast",
"price_hour": 4500,
"extra_hold": 1000,
"wait_until": "2026-11-13T10:28:38+07:00"
}
}/gpu/restart
Toàn quyềnKhởi động lại máy đang chạy. Mỗi máy một lần / 3 phút (chung web và API) — gửi sớm ⇒ 429 COOLDOWN kèm Retry-After. Khởi động lại có thể đổi IP:cổng ⇒ hỏi lại /gpu/info (tự đồng bộ).
POST https://cloudmoon.net/api/v1/gpu/restart| Tham số | Vị trí | Bắt buộc | Mô tả |
|---|---|---|---|
order_code |
body | có | Mã đơn (order_code) — lấy từ lệnh mua hoặc /list |
Chạy thử Gửi kèm X-Sandbox: 1: máy chủ kiểm như lượt thật rồi trả kết quả mô phỏng cùng khuôn — không trừ tiền, không đổi gì. Nhận cả mã SANDBOX… của lệnh mua chạy thử ⇒ trả máy mẫu. Kịch bản lỗi (X-Sandbox-Scenario): NOT_RUNNING (409) · COOLDOWN (429) · IN_PROGRESS (429) · UNAVAILABLE (503).
curl -X POST 'https://cloudmoon.net/api/v1/gpu/restart' \
-H 'X-API-Key: ak_...' \
-H 'Content-Type: application/json' \
-d '{"order_code":"131126GPUABCDEFGHJK"}'import requests
r = requests.post(
"https://cloudmoon.net/api/v1/gpu/restart",
headers={"X-API-Key": "ak_..."},
json={"order_code": "131126GPUABCDEFGHJK"},
timeout=30,
)
print(r.status_code, r.json())// Node.js 18+ — lưu thành tệp .mjs
const res = await fetch("https://cloudmoon.net/api/v1/gpu/restart", {
method: "POST",
headers: {
"X-API-Key": "ak_...",
"Content-Type": "application/json",
},
body: JSON.stringify({ order_code: "131126GPUABCDEFGHJK" }),
});
console.log(res.status, await res.json());// cm_api(): xem mục "Client mẫu" ở trang Tổng quan
$kq = cm_api('POST', '/v1/gpu/restart', ['order_code' => '131126GPUABCDEFGHJK']);
print_r($kq);{
"order_code": "131126GPUABCDEFGHJK"
}{
"status": "success",
"msg": "Đã gửi lệnh khởi động lại — máy sẽ sẵn sàng lại sau ít phút",
"data": {
"order_code": "131126GPUABCDEFGHJK",
"status": "running",
"restarting": true,
"next_restart_after": 180
}
}/gpu/stop
Toàn quyềnTẠM DỪNG máy đang chạy, GIỮ ĐĨA (phần mềm · mô hình · tệp trong máy còn nguyên) — chỉ máy Linux thuê theo mức (pause.supported = true). Tiền giờ chạy NGỪNG ngay lúc nhận lệnh; máy dừng ở nền (status stopping → paused, thường dưới 2 phút — trả HTTP 202). Khi máy chủ xác nhận: hoàn phần giờ chạy đã giữ dư, thu TRƯỚC một giờ giữ đĩa (pause.disk_price_hour — theo giá ổ của chính máy), rồi thu từng giờ tới khi bật lại hoặc trả máy. Số dư không đủ một giờ giữ đĩa kế ⇒ máy bị TRẢ (xoá cùng dữ liệu, end_reason insufficient_balance) — có thư báo trước khi số dư chỉ còn đủ khoảng một ngày cho mọi máy đang tính tiền của tài khoản. Lệnh đòi số dư (cộng phần giờ chạy sẽ được hoàn) đủ một giờ giữ đĩa đầu. Máy chủ sắp hết hạn giữ máy (pause.contract_end còn dưới 24 giờ) ⇒ 409 CONTRACT_ENDING. Mỗi máy một thao tác một lúc + nghỉ giữa hai lần tạm dừng / bật lại ⇒ 429 COOLDOWN kèm Retry-After. Gọi lại khi đã / đang tạm dừng ⇒ 200 / 202 như cũ (lệnh không trừ tiền ⇒ không cần Idempotency-Key). Chạy thử (X-Sandbox: 1): kiểm như lệnh thật rồi trả kết quả mô phỏng — không hỏi máy chủ nên chưa có giá đĩa (disk_price_hour null) và chưa xét số dư giờ đĩa đầu; máy mẫu SANDBOX… đang running dừng thử được.
POST https://cloudmoon.net/api/v1/gpu/stop| Tham số | Vị trí | Bắt buộc | Mô tả |
|---|---|---|---|
order_code |
body | có | Mã đơn (order_code) — lấy từ lệnh mua hoặc /list |
Chạy thử Gửi kèm X-Sandbox: 1: máy chủ kiểm như lượt thật rồi trả kết quả mô phỏng cùng khuôn — không trừ tiền, không đổi gì. Nhận cả mã SANDBOX… của lệnh mua chạy thử ⇒ trả máy mẫu. Kịch bản lỗi (X-Sandbox-Scenario): NOT_SUPPORTED (400) · NOT_RUNNING (409) · CONTRACT_ENDING (409) · INSUFFICIENT_BALANCE (402) · COOLDOWN (429) · IN_PROGRESS (429) · RATE_LIMITED (429) · MAINTENANCE (503).
curl -X POST 'https://cloudmoon.net/api/v1/gpu/stop' \
-H 'X-API-Key: ak_...' \
-H 'Content-Type: application/json' \
-d '{"order_code":"131126GPUABCDEFGHJK"}'import requests
r = requests.post(
"https://cloudmoon.net/api/v1/gpu/stop",
headers={"X-API-Key": "ak_..."},
json={"order_code": "131126GPUABCDEFGHJK"},
timeout=30,
)
print(r.status_code, r.json())// Node.js 18+ — lưu thành tệp .mjs
const res = await fetch("https://cloudmoon.net/api/v1/gpu/stop", {
method: "POST",
headers: {
"X-API-Key": "ak_...",
"Content-Type": "application/json",
},
body: JSON.stringify({ order_code: "131126GPUABCDEFGHJK" }),
});
console.log(res.status, await res.json());// cm_api(): xem mục "Client mẫu" ở trang Tổng quan
$kq = cm_api('POST', '/v1/gpu/stop', ['order_code' => '131126GPUABCDEFGHJK']);
print_r($kq);{
"order_code": "131126GPUABCDEFGHJK"
}{
"status": "success",
"msg": "Đã nhận lệnh tạm dừng — máy sẽ dừng trong ít phút",
"data": {
"order_code": "131126GPUABCDEFGHJK",
"status": "stopping",
"pause": {
"supported": true,
"disk_price_hour": 350,
"paused_at": "2026-11-18T10:00:00+07:00",
"disk_paid_until": null,
"balance_covers_hours": null,
"delete_at": null,
"contract_end": "2026-12-13T09:17:40+07:00",
"pending_action": {
"action": "stop",
"since": "2026-11-18T10:00:00+07:00"
},
"last_action": null,
"cooldown_seconds": 0
},
"allowed_actions": [
"delete",
"note"
]
}
}/gpu/start
Toàn quyềnBẬT LẠI máy đang tạm dừng (status paused) — đúng máy ấy, đĩa còn nguyên. Giữ trước hold_hours giờ chạy theo giá máy (hold_amount) NGAY trong lệnh — cần số dư ≥ khoản giữ + số dư tối thiểu cho phí băng thông (thiếu ⇒ 402 INSUFFICIENT_BALANCE kèm data.amount_required). Máy bật ở nền (status resuming → running, thường dưới 1 phút — trả HTTP 202); giờ chạy tính từ lúc máy chạy lại, phần giữ đĩa chưa dùng hoàn về số dư. IP / cổng ngoài có thể đổi sau khi bật — đọc lại connection ở /gpu/info khi running. Máy chủ không còn card trống ⇒ khoảng 90 giây sau lệnh bật bị huỷ, hoàn ĐỦ khoản giữ, máy về paused với pause.last_action.result = no_capacity (thử lại sau ít phút hoặc trả máy). Máy gần chạm hạn mức chi tiêu ⇒ 409 LIMIT_REACHED (nâng / bỏ hạn mức bằng /gpu/limits rồi bật lại). Bắt buộc Idempotency-Key — gửi lại cùng khoá ⇒ kết quả cũ, không giữ tiền lần hai; gọi khi đang bật lại ⇒ 202 như cũ. Chạy thử: kiểm như lệnh thật (gồm số dư) rồi trả kết quả mô phỏng.
POST https://cloudmoon.net/api/v1/gpu/start| Tham số | Vị trí | Bắt buộc | Mô tả |
|---|---|---|---|
Idempotency-Key |
header | có | BẮT BUỘC (lệnh giữ tiền) — gửi lại cùng khoá ⇒ kết quả cũ, không giữ thêm hai lần |
order_code |
body | có | Mã đơn (order_code) — lấy từ lệnh mua hoặc /list |
Chạy thử Gửi kèm X-Sandbox: 1: máy chủ kiểm như lượt thật rồi trả kết quả mô phỏng cùng khuôn — không trừ tiền, không đổi gì. Nhận cả mã SANDBOX… của lệnh mua chạy thử ⇒ trả máy mẫu. Kịch bản lỗi (X-Sandbox-Scenario): NOT_SUPPORTED (400) · NOT_PAUSED (409) · CONTRACT_ENDING (409) · LIMIT_REACHED (409) · INSUFFICIENT_BALANCE (402) · COOLDOWN (429) · IN_PROGRESS (429) · RATE_LIMITED (429) · IDEMPOTENCY_PENDING (409) · MAINTENANCE (503).
curl -X POST 'https://cloudmoon.net/api/v1/gpu/start' \
-H 'X-API-Key: ak_...' \
-H 'Idempotency-Key: 7f9c2e4b-1a2b-4c3d-9e8f-0123456789ab' \
-H 'Content-Type: application/json' \
-d '{"order_code":"131126GPUABCDEFGHJK"}'import uuid
import requests
r = requests.post(
"https://cloudmoon.net/api/v1/gpu/start",
headers={"X-API-Key": "ak_...", "Idempotency-Key": str(uuid.uuid4())},
json={"order_code": "131126GPUABCDEFGHJK"},
timeout=30,
)
print(r.status_code, r.json())// Node.js 18+ — lưu thành tệp .mjs
import { randomUUID } from "node:crypto";
const res = await fetch("https://cloudmoon.net/api/v1/gpu/start", {
method: "POST",
headers: {
"X-API-Key": "ak_...",
"Content-Type": "application/json",
"Idempotency-Key": randomUUID(),
},
body: JSON.stringify({ order_code: "131126GPUABCDEFGHJK" }),
});
console.log(res.status, await res.json());// cm_api(): xem mục "Client mẫu" ở trang Tổng quan
$kq = cm_api('POST', '/v1/gpu/start', ['order_code' => '131126GPUABCDEFGHJK'], bin2hex(random_bytes(16)));
print_r($kq);{
"order_code": "131126GPUABCDEFGHJK"
}{
"status": "success",
"msg": "Đã nhận lệnh bật lại — máy sẽ chạy trong ít phút",
"data": {
"order_code": "131126GPUABCDEFGHJK",
"status": "resuming",
"pause": {
"supported": true,
"disk_price_hour": 350,
"paused_at": "2026-11-18T10:00:00+07:00",
"disk_paid_until": "2026-11-18T12:00:00+07:00",
"balance_covers_hours": null,
"delete_at": null,
"contract_end": "2026-12-13T09:17:40+07:00",
"pending_action": {
"action": "start",
"since": "2026-11-18T11:20:00+07:00"
},
"last_action": {
"action": "stop",
"result": "done",
"at": "2026-11-18T10:01:30+07:00"
},
"cooldown_seconds": 0
},
"hold_amount": 4500,
"hold_hours": 1,
"allowed_actions": [
"delete",
"note"
]
}
}/gpu/delete
Toàn quyềnTRẢ MÁY = DỪNG TÍNH TIỀN ngay (máy bị gỡ cùng dữ liệu, không khôi phục — máy kèm ổ lưu trữ: dữ liệu trong /workspace nằm trên ổ, còn nguyên). Bắt buộc confirm = đúng order_code. Máy gỡ ở nền (status releasing → settling), quyết toán ít phút sau (Linux tròn phút · Windows tròn giờ; phí băng thông chốt theo số cuối sau khi máy gỡ xong — đọc số cuối hỏng quá lâu thì chốt theo phần đã thu) — phần giữ trước chưa dùng hoàn về số dư (xem /gpu/charges). Gọi lại khi đã trả ⇒ 200. Đơn đang tìm máy ⇒ 409 PROVISIONING (huỷ bằng /gpu/cancel). Máy đang tạm dừng · đang dừng · đang bật lại cũng trả được ngay (đĩa bị xoá; quyết toán gồm phần giữ đĩa đã dùng, phần giữ dư hoàn về số dư).
POST https://cloudmoon.net/api/v1/gpu/delete| Tham số | Vị trí | Bắt buộc | Mô tả |
|---|---|---|---|
order_code |
body | có | Mã đơn (order_code) — lấy từ lệnh mua hoặc /list |
confirm |
body | có | gõ lại đúng order_code |
Chạy thử Gửi kèm X-Sandbox: 1: máy chủ kiểm như lượt thật rồi trả kết quả mô phỏng cùng khuôn — không trừ tiền, không đổi gì. Nhận cả mã SANDBOX… của lệnh mua chạy thử ⇒ trả máy mẫu. Kịch bản lỗi (X-Sandbox-Scenario): PROVISIONING (409) · IN_PROGRESS (429) · UNAVAILABLE (503).
curl -X POST 'https://cloudmoon.net/api/v1/gpu/delete' \
-H 'X-API-Key: ak_...' \
-H 'Content-Type: application/json' \
-d '{"order_code":"131126GPUABCDEFGHJK","confirm":"131126GPUABCDEFGHJK"}'import requests
r = requests.post(
"https://cloudmoon.net/api/v1/gpu/delete",
headers={"X-API-Key": "ak_..."},
json={"order_code": "131126GPUABCDEFGHJK", "confirm": "131126GPUABCDEFGHJK"},
timeout=30,
)
print(r.status_code, r.json())// Node.js 18+ — lưu thành tệp .mjs
const res = await fetch("https://cloudmoon.net/api/v1/gpu/delete", {
method: "POST",
headers: {
"X-API-Key": "ak_...",
"Content-Type": "application/json",
},
body: JSON.stringify({ order_code: "131126GPUABCDEFGHJK", confirm: "131126GPUABCDEFGHJK" }),
});
console.log(res.status, await res.json());// cm_api(): xem mục "Client mẫu" ở trang Tổng quan
$kq = cm_api('POST', '/v1/gpu/delete', ['order_code' => '131126GPUABCDEFGHJK', 'confirm' => '131126GPUABCDEFGHJK']);
print_r($kq);{
"order_code": "131126GPUABCDEFGHJK",
"confirm": "131126GPUABCDEFGHJK"
}{
"status": "success",
"msg": "Đã ngừng tính tiền — máy đang được gỡ, phần dư sẽ hoàn về số dư sau ít phút",
"data": {
"order_code": "131126GPUABCDEFGHJK",
"status": "releasing",
"billing_stopped": true,
"fee": null,
"refunded": null
}
}/gpu/limits
Toàn quyềnHạn mức chi tiêu của máy đang chạy: max_amount (tổng tiền tối đa, đ) · max_hours (số giờ chạy tối đa) — 0 = bỏ mức ấy, chỉ gửi một trường thì trường kia giữ nguyên. Chạm mức ⇒ báo trước ~10 phút rồi TỰ TRẢ máy (end_reason max_amount | max_hours). Mức mới phải ≥ limits.min_max_amount / min_max_hours (≈ tạm tính sau thêm khoảng 10 phút chạy; máy tròn giờ không thấp hơn số giờ đã trả — thấp hơn ⇒ 400 kèm hai số ấy). Trả về khối limits như /gpu/info. Máy đang tạm dừng cũng đặt được (giờ chạy đứng yên; giờ giữ đĩa kế làm vượt max_amount ⇒ máy bị trả, end_reason max_amount).
POST https://cloudmoon.net/api/v1/gpu/limits| Tham số | Vị trí | Bắt buộc | Mô tả |
|---|---|---|---|
order_code |
body | có | Mã đơn (order_code) — lấy từ lệnh mua hoặc /list |
max_amount |
body | không | đ — 0 = bỏ |
max_hours |
body | không | giờ — 0 = bỏ |
Chạy thử Gửi kèm X-Sandbox: 1: máy chủ kiểm như lượt thật rồi trả kết quả mô phỏng cùng khuôn — không trừ tiền, không đổi gì. Nhận cả mã SANDBOX… của lệnh mua chạy thử ⇒ trả máy mẫu. Kịch bản lỗi (X-Sandbox-Scenario): NOT_RUNNING (409) · IN_PROGRESS (429) · RATE_LIMITED (429).
curl -X POST 'https://cloudmoon.net/api/v1/gpu/limits' \
-H 'X-API-Key: ak_...' \
-H 'Content-Type: application/json' \
-d '{"order_code":"131126GPUABCDEFGHJK","max_amount":20000}'import requests
r = requests.post(
"https://cloudmoon.net/api/v1/gpu/limits",
headers={"X-API-Key": "ak_..."},
json={"order_code": "131126GPUABCDEFGHJK", "max_amount": 20000},
timeout=30,
)
print(r.status_code, r.json())// Node.js 18+ — lưu thành tệp .mjs
const res = await fetch("https://cloudmoon.net/api/v1/gpu/limits", {
method: "POST",
headers: {
"X-API-Key": "ak_...",
"Content-Type": "application/json",
},
body: JSON.stringify({ order_code: "131126GPUABCDEFGHJK", max_amount: 20000 }),
});
console.log(res.status, await res.json());// cm_api(): xem mục "Client mẫu" ở trang Tổng quan
$kq = cm_api('POST', '/v1/gpu/limits', ['order_code' => '131126GPUABCDEFGHJK', 'max_amount' => 20000]);
print_r($kq);{
"order_code": "131126GPUABCDEFGHJK",
"max_amount": 20000
}{
"status": "success",
"msg": "Đã lưu hạn mức",
"data": {
"order_code": "131126GPUABCDEFGHJK",
"max_amount": 20000,
"max_hours": 0,
"auto_release_at": "2026-11-13T14:44:25+07:00",
"warning": false,
"min_max_amount": 1575,
"min_max_hours": 1
}
}/gpu/note
Toàn quyềnGhi chú máy (nhãn cho script): ≤ 100 ký tự một dòng, khoảng trắng gộp lại; chuỗi rỗng = bỏ ghi chú. Ghi được ở mọi trạng thái, kể cả máy đã trả.
POST https://cloudmoon.net/api/v1/gpu/note| Tham số | Vị trí | Bắt buộc | Mô tả |
|---|---|---|---|
order_code |
body | có | Mã đơn (order_code) — lấy từ lệnh mua hoặc /list |
note |
body | có | chuỗi — "" để bỏ |
Chạy thử Gửi kèm X-Sandbox: 1: máy chủ kiểm như lượt thật rồi trả kết quả mô phỏng cùng khuôn — không trừ tiền, không đổi gì. Nhận cả mã SANDBOX… của lệnh mua chạy thử ⇒ trả máy mẫu. Kịch bản lỗi (X-Sandbox-Scenario): RATE_LIMITED (429).
curl -X POST 'https://cloudmoon.net/api/v1/gpu/note' \
-H 'X-API-Key: ak_...' \
-H 'Content-Type: application/json' \
-d '{"order_code":"131126GPUABCDEFGHJK","note":"train-01"}'import requests
r = requests.post(
"https://cloudmoon.net/api/v1/gpu/note",
headers={"X-API-Key": "ak_..."},
json={"order_code": "131126GPUABCDEFGHJK", "note": "train-01"},
timeout=30,
)
print(r.status_code, r.json())// Node.js 18+ — lưu thành tệp .mjs
const res = await fetch("https://cloudmoon.net/api/v1/gpu/note", {
method: "POST",
headers: {
"X-API-Key": "ak_...",
"Content-Type": "application/json",
},
body: JSON.stringify({ order_code: "131126GPUABCDEFGHJK", note: "train-01" }),
});
console.log(res.status, await res.json());// cm_api(): xem mục "Client mẫu" ở trang Tổng quan
$kq = cm_api('POST', '/v1/gpu/note', ['order_code' => '131126GPUABCDEFGHJK', 'note' => 'train-01']);
print_r($kq);{
"order_code": "131126GPUABCDEFGHJK",
"note": "train-01"
}{
"status": "success",
"msg": "Đã lưu ghi chú",
"data": {
"order_code": "131126GPUABCDEFGHJK",
"note": "train-01"
}
}/gpu/volumes
Chỉ đọcỔ lưu trữ của tài khoản, mới nhất trước — CÙNG số khối ổ trên trang Thuê GPU. Ổ gắn vào máy GPU / CPU kèm ổ ở /workspace, dữ liệu giữ qua các lần thuê máy; thu tiền theo NGÀY, trừ trước từng ngày. ?status=active (mặc định: đang tạo · đang chạy · đang nợ · đang xoá) | closed (đã xoá · lỗi tạo — 30 ngày gần nhất) | all. Mỗi ổ: status (creating · active · overdue — thiếu tiền giữ ổ · deleting · deleted · failed) · size_gb · price_gb_day (giá đã chốt của ổ) · daily_amount · paid_until (đã thu tới — mốc thu ngày kế) · overdue_since · delete_at (quá mốc này ổ bị xoá cùng toàn bộ dữ liệu; máy đang gắn được tự trả trước) · amount_due (nạp ít nhất số này để hệ thống thu đủ các ngày nợ, ổ chạy lại) · resizing_to_gb (lệnh tăng dung lượng đang xử lý) · used_gb + used_measured_at (dung lượng đã dùng — số đo định kỳ, null = chưa đo) · attached_machines (máy đang gắn — còn máy thì chưa xoá được ổ) · deleted_at + end_reason (customer · insufficient_balance · support · infrastructure · system) · allowed_actions (rename · resize · delete — việc làm được NGAY). quota: max_volumes (trần số ổ của tài khoản) · remaining (còn tạo được — ổ đang xoá không tính). Danh mục cỡ ổ + máy kèm ổ: GET /gpu/products?type=volume · báo giá máy kèm ổ: POST /gpu/quote với type = volume.
GET https://cloudmoon.net/api/v1/gpu/volumes| Tham số | Vị trí | Bắt buộc | Mô tả |
|---|---|---|---|
status |
query | không | active (mặc định) · closed · all |
curl 'https://cloudmoon.net/api/v1/gpu/volumes' \
-H 'X-API-Key: ak_...'import requests
r = requests.get(
"https://cloudmoon.net/api/v1/gpu/volumes",
headers={"X-API-Key": "ak_..."},
timeout=30,
)
print(r.status_code, r.json())// Node.js 18+ — lưu thành tệp .mjs
const res = await fetch("https://cloudmoon.net/api/v1/gpu/volumes", {
headers: { "X-API-Key": "ak_..." },
});
console.log(res.status, await res.json());// cm_api(): xem mục "Client mẫu" ở trang Tổng quan
$kq = cm_api('GET', '/v1/gpu/volumes');
print_r($kq);{
"status": "success",
"msg": "OK",
"data": {
"items": [
{
"volume_code": "131126GPOABCDEFGHJK",
"name": "du-lieu-train",
"status": "active",
"size_gb": 50,
"location": "Châu Âu (Romania)",
"mount_path": "/workspace",
"price_gb_day": 98,
"daily_amount": 4900,
"paid_until": "2026-11-14T20:01:12+07:00",
"overdue_since": null,
"delete_at": null,
"amount_due": 0,
"resizing_to_gb": null,
"used_gb": 12.48,
"used_measured_at": "2026-11-13T21:00:05+07:00",
"attached_machines": [
{
"order_code": "131126GPUABCDEFGHJK",
"status": "running",
"machine": "rtx4090",
"kind": "gpu"
}
],
"channel": "api",
"created_at": "2026-11-13T20:01:12+07:00",
"deleted_at": null,
"end_reason": null,
"allowed_actions": [
"rename",
"resize"
]
}
],
"total": 1,
"quota": {
"max_volumes": 10,
"remaining": 9
}
}
}/gpu/volumes/info
Chỉ đọcChi tiết MỘT ổ lưu trữ — cùng khối của /gpu/volumes + charges_summary (tổng trừ · tổng hoàn · ròng của ổ). Ổ của tài khoản khác ⇒ 404 cùng câu với mã không có.
GET https://cloudmoon.net/api/v1/gpu/volumes/info| Tham số | Vị trí | Bắt buộc | Mô tả |
|---|---|---|---|
volume_code |
query | có | Mã ổ lưu trữ (volume_code) — lấy từ /gpu/volumes |
curl 'https://cloudmoon.net/api/v1/gpu/volumes/info?volume_code=131126GPOABCDEFGHJK' \
-H 'X-API-Key: ak_...'import requests
r = requests.get(
"https://cloudmoon.net/api/v1/gpu/volumes/info",
headers={"X-API-Key": "ak_..."},
params={"volume_code": "131126GPOABCDEFGHJK"},
timeout=30,
)
print(r.status_code, r.json())// Node.js 18+ — lưu thành tệp .mjs
const res = await fetch("https://cloudmoon.net/api/v1/gpu/volumes/info?volume_code=131126GPOABCDEFGHJK", {
headers: { "X-API-Key": "ak_..." },
});
console.log(res.status, await res.json());// cm_api(): xem mục "Client mẫu" ở trang Tổng quan
$kq = cm_api('GET', '/v1/gpu/volumes/info?volume_code=131126GPOABCDEFGHJK');
print_r($kq);{
"status": "success",
"msg": "OK",
"data": {
"volume_code": "131126GPOABCDEFGHJK",
"name": "du-lieu-train",
"status": "active",
"size_gb": 50,
"location": "Châu Âu (Romania)",
"mount_path": "/workspace",
"price_gb_day": 98,
"daily_amount": 4900,
"paid_until": "2026-11-14T20:01:12+07:00",
"overdue_since": null,
"delete_at": null,
"amount_due": 0,
"resizing_to_gb": null,
"used_gb": 12.48,
"used_measured_at": "2026-11-13T21:00:05+07:00",
"attached_machines": [
{
"order_code": "131126GPUABCDEFGHJK",
"status": "running",
"machine": "rtx4090",
"kind": "gpu"
}
],
"channel": "api",
"created_at": "2026-11-13T20:01:12+07:00",
"deleted_at": null,
"end_reason": null,
"allowed_actions": [
"rename",
"resize"
],
"charges_summary": {
"charged": 4900,
"refunded": 0,
"net": 4900
}
}
}/gpu/volumes/charges
Chỉ đọcSổ tiền từng khoản của một ổ, mới nhất trước. amount có dấu: dương = trừ ví · âm = hoàn về ví. type: daily (thu một ngày — gồm ngày đầu lúc tạo ổ) · daily_catch_up (thu bù các ngày nợ sau khi bạn nạp tiền) · resize (phần chênh khi tăng dung lượng — tới mốc thu ngày kế) · refund_create (hoàn đủ — ổ không tạo được) · refund_resize (hoàn phần chênh — tăng không thực hiện được) · manual_refund (hỗ trợ hoàn) · adjustment. from / to = khoảng thời gian của khoản; created_at = lúc ghi. summary: tổng trừ · tổng hoàn · ròng. Xoá ổ là ngừng tính tiền ngay, không hoàn ngày đang dở.
GET https://cloudmoon.net/api/v1/gpu/volumes/charges| Tham số | Vị trí | Bắt buộc | Mô tả |
|---|---|---|---|
volume_code |
query | có | Mã ổ lưu trữ (volume_code) — lấy từ /gpu/volumes |
limit |
query | không | 1-200, mặc định 100 |
curl 'https://cloudmoon.net/api/v1/gpu/volumes/charges?volume_code=131126GPOABCDEFGHJK' \
-H 'X-API-Key: ak_...'import requests
r = requests.get(
"https://cloudmoon.net/api/v1/gpu/volumes/charges",
headers={"X-API-Key": "ak_..."},
params={"volume_code": "131126GPOABCDEFGHJK"},
timeout=30,
)
print(r.status_code, r.json())// Node.js 18+ — lưu thành tệp .mjs
const res = await fetch("https://cloudmoon.net/api/v1/gpu/volumes/charges?volume_code=131126GPOABCDEFGHJK", {
headers: { "X-API-Key": "ak_..." },
});
console.log(res.status, await res.json());// cm_api(): xem mục "Client mẫu" ở trang Tổng quan
$kq = cm_api('GET', '/v1/gpu/volumes/charges?volume_code=131126GPOABCDEFGHJK');
print_r($kq);{
"status": "success",
"msg": "OK",
"data": {
"volume_code": "131126GPOABCDEFGHJK",
"items": [
{
"type": "resize",
"amount": 2940,
"from": "2026-11-13T20:05:30+07:00",
"to": "2026-11-14T20:01:12+07:00",
"created_at": "2026-11-13T20:05:30+07:00"
},
{
"type": "daily",
"amount": 1960,
"from": "2026-11-13T20:01:12+07:00",
"to": "2026-11-14T20:01:12+07:00",
"created_at": "2026-11-13T20:01:12+07:00"
}
],
"total": 2,
"summary": {
"charged": 4900,
"refunded": 0,
"net": 4900
}
}
}/gpu/volumes/create
Toàn quyềnTạo ổ lưu trữ — trừ NGAY tiền ngày đầu (size_gb × price_gb_day) từ số dư, rồi thu trước từng ngày theo giá chốt lúc tạo (thiếu tiền ⇒ ổ chuyển overdue, giữ grace_days ngày rồi xoá — xem /gpu/products?type=volume). Ổ gắn vào máy GPU / CPU thuê kèm ổ (POST /gpu/buy với type = volume) ở /workspace, dữ liệu giữ qua các lần thuê máy. Kết quả: status active (đã tạo) · creating (hệ thống đang hoàn tất — không tạo được thì hoàn đủ, ổ thành failed). charged = số tiền lệnh này đã trừ. Trần số ổ của tài khoản ⇒ 429 VOLUME_LIMIT (quota ở /gpu/volumes). Thử miễn phí: header X-Sandbox: 1 ⇒ mã ổ mẫu SANDBOX… dùng được với /gpu/volumes/* và /gpu/buy type=volume kèm header (ổ mẫu tính giá hiện hành, đọc lại không mang tên; kịch bản VOLUME_UNPAID ⇒ ổ mẫu nợ từ ngày thứ hai).
POST https://cloudmoon.net/api/v1/gpu/volumes/create| Tham số | Vị trí | Bắt buộc | Mô tả |
|---|---|---|---|
Idempotency-Key |
header | có | BẮT BUỘC (lệnh trừ tiền) — gửi lại cùng khoá ⇒ kết quả cũ, không tạo hai ổ |
size_gb |
body | có | cỡ ổ (GB) — một cỡ trong volume.sizes_gb ở /gpu/products?type=volume |
name |
body | không | tên ổ ≤ 40 ký tự (chữ · số · khoảng trắng và . _ - ( ) # +) — đặt / đổi sau bằng /gpu/volumes/rename |
Chạy thử Gửi kèm X-Sandbox: 1: máy chủ kiểm như lượt thật rồi trả kết quả mô phỏng cùng khuôn — không trừ tiền, không đổi gì. Kịch bản lỗi (X-Sandbox-Scenario): INSUFFICIENT_BALANCE (402) · VOLUME_LIMIT (429) · RATE_LIMITED (429) · BUSY (429) · IDEMPOTENCY_PENDING (409) · SERVICE_DISABLED (503) · MAINTENANCE (503) · UNAVAILABLE (503) · VOLUME_UNPAID (lệnh vẫn nhận, info về sau báo failed).
curl -X POST 'https://cloudmoon.net/api/v1/gpu/volumes/create' \
-H 'X-API-Key: ak_...' \
-H 'Idempotency-Key: 7f9c2e4b-1a2b-4c3d-9e8f-0123456789ab' \
-H 'Content-Type: application/json' \
-d '{"size_gb":20,"name":"du-lieu-train"}'import uuid
import requests
r = requests.post(
"https://cloudmoon.net/api/v1/gpu/volumes/create",
headers={"X-API-Key": "ak_...", "Idempotency-Key": str(uuid.uuid4())},
json={"size_gb": 20, "name": "du-lieu-train"},
timeout=30,
)
print(r.status_code, r.json())// Node.js 18+ — lưu thành tệp .mjs
import { randomUUID } from "node:crypto";
const res = await fetch("https://cloudmoon.net/api/v1/gpu/volumes/create", {
method: "POST",
headers: {
"X-API-Key": "ak_...",
"Content-Type": "application/json",
"Idempotency-Key": randomUUID(),
},
body: JSON.stringify({ size_gb: 20, name: "du-lieu-train" }),
});
console.log(res.status, await res.json());// cm_api(): xem mục "Client mẫu" ở trang Tổng quan
$kq = cm_api('POST', '/v1/gpu/volumes/create', ['size_gb' => 20, 'name' => 'du-lieu-train'], bin2hex(random_bytes(16)));
print_r($kq);{
"size_gb": 20,
"name": "du-lieu-train"
}{
"status": "success",
"msg": "Đã tạo ổ lưu trữ 20 GB",
"data": {
"volume_code": "131126GPOABCDEFGHJK",
"name": "du-lieu-train",
"status": "active",
"size_gb": 20,
"location": "Châu Âu (Romania)",
"mount_path": "/workspace",
"price_gb_day": 98,
"daily_amount": 1960,
"paid_until": "2026-11-14T20:01:12+07:00",
"overdue_since": null,
"delete_at": null,
"amount_due": 0,
"resizing_to_gb": null,
"used_gb": null,
"used_measured_at": null,
"attached_machines": [],
"channel": "api",
"created_at": "2026-11-13T20:01:12+07:00",
"deleted_at": null,
"end_reason": null,
"allowed_actions": [
"rename",
"resize",
"delete"
],
"charged": 1960
}
}/gpu/volumes/rename
Toàn quyềnĐặt / bỏ tên ổ lưu trữ (nhãn để phân biệt nhiều ổ): ≤ 40 ký tự — chữ · số (mọi thứ tiếng) · khoảng trắng và . _ - ( ) # +, khoảng trắng gộp lại; name = "" ⇒ bỏ tên. Đổi được khi ổ creating · active · overdue (đang / đã xoá ⇒ 409 INVALID_STATE). Trả khối ổ như /gpu/volumes/info.
POST https://cloudmoon.net/api/v1/gpu/volumes/rename| Tham số | Vị trí | Bắt buộc | Mô tả |
|---|---|---|---|
volume_code |
body | có | Mã ổ lưu trữ (volume_code) — lấy từ /gpu/volumes |
name |
body | có | chuỗi — "" để bỏ tên |
Chạy thử Gửi kèm X-Sandbox: 1: máy chủ kiểm như lượt thật rồi trả kết quả mô phỏng cùng khuôn — không trừ tiền, không đổi gì. Kịch bản lỗi (X-Sandbox-Scenario): INVALID_STATE (409) · RATE_LIMITED (429) · BUSY (429).
curl -X POST 'https://cloudmoon.net/api/v1/gpu/volumes/rename' \
-H 'X-API-Key: ak_...' \
-H 'Content-Type: application/json' \
-d '{"volume_code":"131126GPOABCDEFGHJK","name":"du-lieu-train"}'import requests
r = requests.post(
"https://cloudmoon.net/api/v1/gpu/volumes/rename",
headers={"X-API-Key": "ak_..."},
json={"volume_code": "131126GPOABCDEFGHJK", "name": "du-lieu-train"},
timeout=30,
)
print(r.status_code, r.json())// Node.js 18+ — lưu thành tệp .mjs
const res = await fetch("https://cloudmoon.net/api/v1/gpu/volumes/rename", {
method: "POST",
headers: {
"X-API-Key": "ak_...",
"Content-Type": "application/json",
},
body: JSON.stringify({ volume_code: "131126GPOABCDEFGHJK", name: "du-lieu-train" }),
});
console.log(res.status, await res.json());// cm_api(): xem mục "Client mẫu" ở trang Tổng quan
$kq = cm_api('POST', '/v1/gpu/volumes/rename', ['volume_code' => '131126GPOABCDEFGHJK', 'name' => 'du-lieu-train']);
print_r($kq);{
"volume_code": "131126GPOABCDEFGHJK",
"name": "du-lieu-train"
}{
"status": "success",
"msg": "Đã đặt tên ổ",
"data": {
"volume_code": "131126GPOABCDEFGHJK",
"name": "du-lieu-train",
"status": "active",
"size_gb": 20,
"location": "Châu Âu (Romania)",
"mount_path": "/workspace",
"price_gb_day": 98,
"daily_amount": 1960,
"paid_until": "2026-11-14T20:01:12+07:00",
"overdue_since": null,
"delete_at": null,
"amount_due": 0,
"resizing_to_gb": null,
"used_gb": null,
"used_measured_at": null,
"attached_machines": [],
"channel": "api",
"created_at": "2026-11-13T20:01:12+07:00",
"deleted_at": null,
"end_reason": null,
"allowed_actions": [
"rename",
"resize",
"delete"
]
}
}/gpu/volumes/resize
Toàn quyềnTăng dung lượng ổ lưu trữ (chỉ TĂNG, không giảm): trừ NGAY phần chênh (size_gb mới − cũ) × price_gb_day tính tới mốc thu ngày kế (paid_until), từ mốc ấy tiền ngày theo cỡ mới. Chỉ ổ active, không có lệnh tăng đang xử lý; sát mốc thu ngày (≤ 1 phút) ⇒ 429 IN_PROGRESS · ổ overdue ⇒ 402 VOLUME_UNPAID. Kết quả: size_gb mới · hoặc resizing_to_gb khi hệ thống đang hoàn tất (không tăng được thì hoàn phần chênh). charged = số tiền lệnh này đã trừ.
POST https://cloudmoon.net/api/v1/gpu/volumes/resize| Tham số | Vị trí | Bắt buộc | Mô tả |
|---|---|---|---|
Idempotency-Key |
header | có | BẮT BUỘC (lệnh trừ tiền) — gửi lại cùng khoá ⇒ kết quả cũ, không trừ hai lần |
volume_code |
body | có | Mã ổ lưu trữ (volume_code) — lấy từ /gpu/volumes |
size_gb |
body | có | dung lượng MỚI (GB) — lớn hơn size_gb hiện tại, một cỡ trong volume.sizes_gb |
Chạy thử Gửi kèm X-Sandbox: 1: máy chủ kiểm như lượt thật rồi trả kết quả mô phỏng cùng khuôn — không trừ tiền, không đổi gì. Kịch bản lỗi (X-Sandbox-Scenario): INSUFFICIENT_BALANCE (402) · VOLUME_UNPAID (402) · IN_PROGRESS (429) · RATE_LIMITED (429) · BUSY (429) · IDEMPOTENCY_PENDING (409) · SERVICE_DISABLED (503) · MAINTENANCE (503) · UNAVAILABLE (503).
curl -X POST 'https://cloudmoon.net/api/v1/gpu/volumes/resize' \
-H 'X-API-Key: ak_...' \
-H 'Idempotency-Key: 7f9c2e4b-1a2b-4c3d-9e8f-0123456789ab' \
-H 'Content-Type: application/json' \
-d '{"volume_code":"131126GPOABCDEFGHJK","size_gb":50}'import uuid
import requests
r = requests.post(
"https://cloudmoon.net/api/v1/gpu/volumes/resize",
headers={"X-API-Key": "ak_...", "Idempotency-Key": str(uuid.uuid4())},
json={"volume_code": "131126GPOABCDEFGHJK", "size_gb": 50},
timeout=30,
)
print(r.status_code, r.json())// Node.js 18+ — lưu thành tệp .mjs
import { randomUUID } from "node:crypto";
const res = await fetch("https://cloudmoon.net/api/v1/gpu/volumes/resize", {
method: "POST",
headers: {
"X-API-Key": "ak_...",
"Content-Type": "application/json",
"Idempotency-Key": randomUUID(),
},
body: JSON.stringify({ volume_code: "131126GPOABCDEFGHJK", size_gb: 50 }),
});
console.log(res.status, await res.json());// cm_api(): xem mục "Client mẫu" ở trang Tổng quan
$kq = cm_api('POST', '/v1/gpu/volumes/resize', ['volume_code' => '131126GPOABCDEFGHJK', 'size_gb' => 50], bin2hex(random_bytes(16)));
print_r($kq);{
"volume_code": "131126GPOABCDEFGHJK",
"size_gb": 50
}{
"status": "success",
"msg": "Đã tăng dung lượng ổ lên 50 GB",
"data": {
"volume_code": "131126GPOABCDEFGHJK",
"name": "du-lieu-train",
"status": "active",
"size_gb": 50,
"location": "Châu Âu (Romania)",
"mount_path": "/workspace",
"price_gb_day": 98,
"daily_amount": 4900,
"paid_until": "2026-11-14T20:01:12+07:00",
"overdue_since": null,
"delete_at": null,
"amount_due": 0,
"resizing_to_gb": null,
"used_gb": null,
"used_measured_at": null,
"attached_machines": [],
"channel": "api",
"created_at": "2026-11-13T20:01:12+07:00",
"deleted_at": null,
"end_reason": null,
"allowed_actions": [
"rename",
"resize",
"delete"
],
"charged": 2940
}
}/gpu/volumes/delete
Toàn quyềnXOÁ ổ lưu trữ = NGỪNG TÍNH TIỀN ngay — ổ bị xoá cùng TOÀN BỘ dữ liệu /workspace, không khôi phục được; KHÔNG hoàn ngày đang dở. Bắt buộc confirm = đúng volume_code. Còn máy đang gắn ⇒ 409 VOLUME_IN_USE kèm data.attached_machines (trả máy bằng /gpu/delete trước). Ổ vừa tạo vài phút có thể ở deleting một lúc — hệ thống tự xoá tiếp. Gọi lại khi đã / đang xoá ⇒ 200.
POST https://cloudmoon.net/api/v1/gpu/volumes/delete| Tham số | Vị trí | Bắt buộc | Mô tả |
|---|---|---|---|
volume_code |
body | có | Mã ổ lưu trữ (volume_code) — lấy từ /gpu/volumes |
confirm |
body | có | gõ lại đúng volume_code |
Chạy thử Gửi kèm X-Sandbox: 1: máy chủ kiểm như lượt thật rồi trả kết quả mô phỏng cùng khuôn — không trừ tiền, không đổi gì. Kịch bản lỗi (X-Sandbox-Scenario): VOLUME_IN_USE (409) · IN_PROGRESS (429) · RATE_LIMITED (429) · BUSY (429).
curl -X POST 'https://cloudmoon.net/api/v1/gpu/volumes/delete' \
-H 'X-API-Key: ak_...' \
-H 'Content-Type: application/json' \
-d '{"volume_code":"131126GPOABCDEFGHJK","confirm":"131126GPOABCDEFGHJK"}'import requests
r = requests.post(
"https://cloudmoon.net/api/v1/gpu/volumes/delete",
headers={"X-API-Key": "ak_..."},
json={"volume_code": "131126GPOABCDEFGHJK", "confirm": "131126GPOABCDEFGHJK"},
timeout=30,
)
print(r.status_code, r.json())// Node.js 18+ — lưu thành tệp .mjs
const res = await fetch("https://cloudmoon.net/api/v1/gpu/volumes/delete", {
method: "POST",
headers: {
"X-API-Key": "ak_...",
"Content-Type": "application/json",
},
body: JSON.stringify({ volume_code: "131126GPOABCDEFGHJK", confirm: "131126GPOABCDEFGHJK" }),
});
console.log(res.status, await res.json());// cm_api(): xem mục "Client mẫu" ở trang Tổng quan
$kq = cm_api('POST', '/v1/gpu/volumes/delete', ['volume_code' => '131126GPOABCDEFGHJK', 'confirm' => '131126GPOABCDEFGHJK']);
print_r($kq);{
"volume_code": "131126GPOABCDEFGHJK",
"confirm": "131126GPOABCDEFGHJK"
}{
"status": "success",
"msg": "Đã ngừng tính tiền — ổ đang được xoá, hệ thống tự hoàn tất trong ít phút",
"data": {
"volume_code": "131126GPOABCDEFGHJK",
"name": "du-lieu-train",
"status": "deleting",
"size_gb": 20,
"location": "Châu Âu (Romania)",
"mount_path": "/workspace",
"price_gb_day": 98,
"daily_amount": 1960,
"paid_until": null,
"overdue_since": null,
"delete_at": null,
"amount_due": 0,
"resizing_to_gb": null,
"used_gb": null,
"used_measured_at": null,
"attached_machines": [],
"channel": "api",
"created_at": "2026-11-13T20:01:12+07:00",
"deleted_at": "2026-11-13T21:10:00+07:00",
"end_reason": "customer",
"allowed_actions": []
}
}