Tham chiếu API

API Thuê GPU

Thuê nguyên card GPU: Linux theo MỨC giá cố định (saving — có thể chờ máy tới 3 giờ · fast — thường có máy ngay; tính theo PHÚT dùng) và Windows (tính tròn giờ, bạn chọn giá tối đa). Giữ trước 1 giờ từ số dư ở bước đầu của đơn (Linux theo mức: ngay sau lệnh thuê · Windows: khi đã thấy máy hợp giá tối đa), trả máy thì quyết toán theo thời gian dùng thật và hoàn phần dư. Danh mục + ước số máy, báo giá, thuê (202 — theo dõi bằng info), huỷ chờ · chuyển nhanh · khởi động lại · trả máy · hạn mức · ghi chú, danh sách / chi tiết máy (kết nối SSH / RDP), số đo GPU, nhật ký hoạt động, sổ tiền từng khoản. Thử miễn phí mọi lệnh bằng header X-Sandbox: 1. Giá như nhau với mọi tài khoản. Giao dịch qua API không tính hoa hồng giới thiệu.

Trên trang này
  1. Tổng quan
  2. Tính tiền & quyết toán
  3. Mức thuê & hàng chờ
  4. Máy Windows
  5. Ổ lưu trữ & máy kèm ổ
  6. Khoá SSH
  7. Tuỳ chọn nâng cao
  8. Ảnh Docker riêng
  9. Mẫu đã lưu
  10. Tạm dừng & bật lại
  11. Băng thông & số dư tối thiểu
  12. Hạn mức chi tiêu
  13. Luật vắng mặt
  14. Trạng thái & việc làm được
  15. Giới hạn theo tài khoản
  16. Bảo trì & ngừng bán
  17. Chạy thử với máy mẫu
  18. Luật riêng của Thuê GPU
  19. Nhịp thao tác
  20. Mã lỗi riêng
  21. GET /gpu/products
  22. POST /gpu/quote
  23. POST /gpu/image-check
  24. GET /gpu/saved-templates
  25. GET /gpu/saved-templates/info
  26. POST /gpu/saved-templates/create
  27. POST /gpu/saved-templates/update
  28. POST /gpu/saved-templates/delete
  29. GET /gpu/list
  30. GET /gpu/info
  31. GET /gpu/metrics
  32. GET /gpu/logs
  33. GET /gpu/charges
  34. POST /gpu/buy
  35. POST /gpu/cancel
  36. POST /gpu/upgrade
  37. POST /gpu/restart
  38. POST /gpu/stop
  39. POST /gpu/start
  40. POST /gpu/delete
  41. POST /gpu/limits
  42. POST /gpu/note
  43. GET /gpu/volumes
  44. GET /gpu/volumes/info
  45. GET /gpu/volumes/charges
  46. POST /gpu/volumes/create
  47. POST /gpu/volumes/rename
  48. POST /gpu/volumes/resize
  49. POST /gpu/volumes/delete

Tổng quan

Địa chỉ gốc của các endpoint trên trang này:

Base URL
https://cloudmoon.net/api/v1
EndpointViệcQuyề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òng hold ở /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_reason insufficient_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ứcChờ máy tối đa (wait_minutes)Nghĩa
fast10 phútGiá cao hơn, thường có máy ngay.
saving30 · 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ỏi GET /gpu/info tới khi running (có khối connection) — hoặc expired (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ờ, info có khối waiting: 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: đợi running rồi trả bằng /gpu/delete (trong lúc khởi tạo delete trả 409 PROVISIONING), chỉ tính thời gian đã dùng.
  • Chuyển tiết kiệm → nhanh (POST /gpu/upgrade với price_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-Key bắt buộc.
  • region chỉ 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 · nvme là 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_CHANGED kè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ới Idempotency-Key MỚI. Gửi kèm bandwidth_price_gb (tuỳ chọn — giá băng thông đã xem ở quote; với upgrade là waiting.fast_bandwidth_price_gb) để chốt cả giá băng thông: lệch giá hiện hành ⇒ cũng 409 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 đa max_price_hour — POST /gpu/quote (báo giá sống) gợi ý ba mức ở suggested_max_prices kè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ả hai failed · out_of_capacity; can_order của quote chỉ 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ùng Administrator; 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ận 409 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 GB1.960đ
50 GB4.900đ
100 GB9.800đ
200 GB19.600đ
500 GB49.000đ
  • POST /gpu/volumes/create trừ ngay tiền ngày đầu; sau đó cứ 24 giờ tính từ lúc tạo (mốc paid_until) hệ thống tự thu ngày kế. Giá chốt lúc tạo (price_gb_day của từng ổ) — đổi giá về sau không áp cho ổ đã có.
  • POST /gpu/volumes/resize chỉ tăng: trừ ngay phần chênh (cỡ mới − cỡ cũ) × giá tính tới paid_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/delete ngừng tính tiền ngay, không hoàn ngày đang dở, xoá cùng toàn bộ dữ liệu (confirm = đúng volume_code). Còn máy đang gắn ⇒ 409 VOLUME_IN_USE kè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-Key bắ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ành failed · 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òng daily_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 ổ

statusNghĩ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.
overdueThiếu tiền giữ ổ — xem amount_due · delete_at.
deleting · deletedĐã ngừng tính tiền, đang xoá · đã xoá (deleted_at · end_reason).
failedKhô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 CPU kind: cpu), báo giá bằng POST /gpu/quote và thuê bằng POST /gpu/buy với type: "volume" + volume_code (ổ active củ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 ⇒ đơn failed (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/list như máy thường: khối machine {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_key củ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ửi ssh_key_ids thì 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ối 400.
  • 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_keys trong máy.
  • quote · buy trả ssh_keys = các khoá SẼ được cài (xem trước được); info · list trả ssh_keys = các khoá đã cài vào máy: id · name theo khoá đã lưu cùng vân tay (null khi 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_keys rỗng; phản hồi buy chạ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ườngKiểuNghĩa
env · env_gzobject · chuỗiBiế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.
portsmảng sốCổng TCP trong máy mở ra Internet, vd [8000, 7860].
start_command · start_command_gzchuỗiLệ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ải 127.0.0.1). Địa chỉ từ Internet là public_host:public_port ở info / list khi máy running — hệ thống cấp, có thể khác cổng trong máy; khởi động lại có thể đổi ⇒ đọc lại info.
  • Lệnh khởi động: ≤ 4.096 byte; chạy nền bằng bash -l ngay 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.log trong 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ả ở info với khoá Toàn quyền (start_command), không có trong quote · 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.

Báo giá kèm tuỳ chọn — bản nén
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"'"}'
Báo giá kèm tuỳ chọn — bản nén
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())
Báo giá kèm tuỳ chọn — bản nén
// 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());
Báo giá kèm tuỳ chọn — bản nén
<?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 (null khi không có lệnh).
  • info · list: như trên, địa chỉ ngoài có khi máy running; info với khoá Toàn quyền thêm start_command.
  • Gửi lại cùng Idempotency-Key mà đổ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_names rỗng); quote · buy chạ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.registries củ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 khai USER khác root bị chối ngay lúc kiểm — vd python:3.12-slim mặc định là Debian 13, dùng python: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ửi card cho image-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_reasonNghĩa
invalid_referenceTên ảnh sai cú pháp (chữ thường, [miền/]đường[:tag][@sha256:…], tối đa 255 ký tự).
registry_not_allowedRegistry không nằm trong danh sách nhận.
not_foundKhô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_osNền ảnh chưa hỗ trợ — message nói nền đã thấy và cách đổi.
gpu_incompatibleBả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 failed với end_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 EXPOSE của ảnh tự được mở ra Internet — địa chỉ ngoài ở image.exposed_ports (public_host:public_port khi máy running); thêm cổng khác bằng ports.

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ối image {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_REQUEST kèm data.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 theo Retry-After).
  • Gửi lại cùng Idempotency-Key mà đổi image ⇒ 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ệnhViệc
GET /gpu/saved-templatesDanh 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/createLư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/updateSửa mẫu — cần version đang xem.
POST /gpu/saved-templates/deleteXoá mẫu.

Lưu mẫu

  • Thân create = name (≤ 60 ký tự, được trùng — mẫu gọi bằng id) + CÙNG các trường phần mềm của quote / buy, kiểm y như lệnh thuê: mẫu cài sẵn + bản CUDA còn bán, cỡ ổ trong disk_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ống disk_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_ids vắ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ằng POST /account/ssh-keys/create trướ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-Key tuỳ 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á

  • update cần id + 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ặc image). 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: null về «tự gắn».
  • Mỗi lần sửa, version tăng 1. Mẫu vừa được sửa ở nơi khác (web, script khác) ⇒ 409 TEMPLATE_CHANGED kèm data.version hiện tại, mẫu không đổi — đọc lại rồi gửi lại.
  • delete nhận id + version tuỳ 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).
  • quote trả saved_template {id · name · version} — gửi đúng version ấy ở buy (saved_template_version BẮT BUỘC khi buy bằ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 ⇒ 400 nói rõ chỗ cần sửa — warnings của mẫu báo trước điều đó.
  • info · list củ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 đó); đổi saved_template_version mà giữ khoá ⇒ 422 IDEMPOTENCY_MISMATCH.
Thuê bằng mẫu đã lưu
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}'
Thuê bằng mẫu đã lưu
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())
Thuê bằng mẫu đã lưu
// 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());
Thuê bằng mẫu đã lưu
// 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ệnhViệc
POST /gpu/stopTạ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/startBậ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òng pause_refund), rồi hệ thống thu trước một giờ giữ đĩa (dòng disk_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ệnh stop đòi số dư — cộng phần giờ chạy sẽ được hoàn — đủ một giờ giữ đĩa đầu (thiếu ⇒ 402 INSUFFICIENT_BALANCE kèm data.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_at có 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_fee và tách riêng ở billing.disk_fee (billing.settlement.disk_fee khi đã 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ức max_amount tí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

  • start giữ trước hold_hours giờ chạy theo giá máy (hold_amount, dòng hold) 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). 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òng disk_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ề paused với pause.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/info khi status = 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/limits rồ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.

Bật lại máy
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"}'
Bật lại máy
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())
Bật lại máy
// 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());
Bật lại máy
// 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_affordable tí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ặc max_hours (số giờ chạy tối đa) — đặt lúc thuê (thân lệnh buy) hoặc khi máy đang chạy bằng POST /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ào max_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_reason max_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_amount mộ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òng period ngắ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 ⇒ 400 kè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 (ở info và 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 / list bằ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ỏi info đị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

statusNghĩ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ị.
runningSẵ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ỡ.
settlingMá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 · expiredBạn huỷ khi còn chờ · hết thời gian chờ mà chưa có máy — đã hoàn đủ.
failedKhô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, quote cho biết trước qua can_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ùng Idempotency-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ệnhTố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 — cancel20 lượt / phút
Chuyển sang thuê nhanh — upgrade10 lượt / phút
Đặt hạn mức — limits20 lượt / phút
Ghi chú — note20 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/create6 lượt / phút
Tăng dung lượng ổ — volumes/resize6 lượt / phút
Đổi tên ổ — volumes/rename10 lượt / phút
Xoá ổ — volumes/delete10 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êng6 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/delete30 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 · buy trả 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 · start vẫ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 mang orderable: 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ỏi products, thuê / báo giá nhận 404 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 / buy type=volume · volumes/create · volumes/resize nhận 503 SERVICE_DISABLED; tạm ngừng bán riêng nhánh kèm ổ ⇒ danh mục vẫn bày với orderable: false, tạo / tăng ổ và thuê máy kèm ổ nhận 503 SERVICE_DISABLED; kèm ổ tạm bảo trì ⇒ orderable: false, các lệnh ấy nhận 503 MAINTENANCE; kèm ổ tạm ngưng nhận lệnh ⇒ orderable: false, nhận 503 UNAVAILABLE; ngừng bán một loại máy kèm ổ ⇒ loại ấy biến khỏi danh mục, quote / buy loại ấy nhận 404 NOT_FOUND. Cỡ ổ không có trong volume.sizes_gb ⇒ 400.
  • Ảnh Docker riêng tạm ngưng ⇒ lệnh MỚI kèm image và image-check nhận 503 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 stop MỚI nhận 503 MAINTENANCE; máy đang tạm dừng vẫn start · delete được. Loại máy tạm bảo trì ⇒ stop / start nhận 503 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: searching khoảng 10 giây đầu (đã giữ trước), provisioning tới khoảng 40 giây, rồi running — IP mẫu thuộc dải tài liệu 203.0.113.0/24, mật khẩu mẫu Sandbox-…. Kịch bản PROVISION_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 header X-Sandbox ⇒ mã SANDBOX… nhận 404.
  • Với order_code thậ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/create kèm X-Sandbox: 1 kiể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 / buy type=volume; kịch bản VOLUME_UNPAID lú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ì.
  • buy type=volume chạ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ản PROVISION_FAILED ⇒ failed.
  • Ảnh Docker riêng: chạy thử không hỏi registry — image-check · quote · buy dù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ọi image-check khô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ự) ⇒ info của máy mẫu có khối image; kịch bản IMAGE_LIMIT thử được lời chối hết lượt.
  • Tạm dừng: stop / start kèm X-Sandbox: 1 kiể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; stop chạy thử 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; máy mẫu không bao giờ paused nên start trên máy mẫu nhận 409 NOT_PAUSED — thử start trên máy thật đang tạm dừng (kèm header).
  • Mẫu đã lưu: saved-templates/create · update · delete kèm X-Sandbox: 1 kiể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 — create có 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 · buy chạy thử bằng mẫu giải mẫu như thật nhưng không ghi last_used_at; máy mẫu SANDBOX… mang nền · ổ · ảnh của mẫu nhưng saved_template: null (không mang dấu mẫu, khoá, tuỳ chọn). Kịch bản TEMPLATE_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 = đúng order_code). Lưu dữ liệu ra ngoài trước khi trả (máy kèm ổ lưu trữ: dữ liệu trong /workspace nằ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ộc Idempotency-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ả 200 vớ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ận credentials_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ằng POST /gpu/note (cả máy đã trả).
  • Máy đã trả vẫn đọc được thông tin + sổ tiền ở /gpu/info và /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ệnhCách lệnh trước trên cùng máy
Khởi động lại3 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ứckhô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.

HTTPcodeÝ nghĩaNê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.
GET

/gpu/products

Chỉ đọc

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Ờ 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ộcMô 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 ổ
Yêu cầu
curl 'https://cloudmoon.net/api/v1/gpu/products' \
  -H 'X-API-Key: ak_...'
Yêu cầu
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())
Yêu cầu
// 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());
Yêu cầu
// cm_api(): xem mục "Client mẫu" ở trang Tổng quan
$kq = cm_api('GET', '/v1/gpu/products');
print_r($kq);
Phản hồi
{
    "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
        }
    }
}
POST

/gpu/quote

Chỉ đọc

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 · ổ · 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ộcMô 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ì).

Yêu cầu
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"}'
Yêu cầu
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())
Yêu cầu
// 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());
Yêu cầu
// 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);
Thân yêu cầu
{
    "type": "linux",
    "card": "gtx1080ti",
    "tier": "fast",
    "template": "pytorch",
    "cuda": "12.4"
}
Phản hồi
{
    "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
        }
    }
}
POST

/gpu/image-check

Chỉ đọc

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: ả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ộcMô 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ì).

Yêu cầu
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"}'
Yêu cầu
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())
Yêu cầu
// 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());
Yêu cầu
// 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);
Thân yêu cầu
{
    "image": "ollama/ollama:latest",
    "card": "rtx4090"
}
Phản hồi
{
    "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
        }
    }
}
GET

/gpu/saved-templates

Chỉ đọc

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 + Ổ 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-templates

Không có tham số — chỉ cần header X-API-Key.

Yêu cầu
curl 'https://cloudmoon.net/api/v1/gpu/saved-templates' \
  -H 'X-API-Key: ak_...'
Yêu cầu
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())
Yêu cầu
// 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());
Yêu cầu
// cm_api(): xem mục "Client mẫu" ở trang Tổng quan
$kq = cm_api('GET', '/v1/gpu/saved-templates');
print_r($kq);
Phản hồi
{
    "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
    }
}
GET

/gpu/saved-templates/info

Chỉ đọc

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 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ộcMô tả
id query có mã mẫu (items[].id ở /gpu/saved-templates)
Yêu cầu
curl 'https://cloudmoon.net/api/v1/gpu/saved-templates/info?id=45' \
  -H 'X-API-Key: ak_...'
Yêu cầu
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())
Yêu cầu
// 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());
Yêu cầu
// 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);
Phản hồi
{
    "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"
    }
}
POST

/gpu/saved-templates/create

Toàn quyền

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 + 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ộcMô 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).

Yêu cầu
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"}'
Yêu cầu
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())
Yêu cầu
// 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());
Yêu cầu
// 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);
Thân yêu cầu
{
    "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"
}
Phản hồi
{
    "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
    }
}
POST

/gpu/saved-templates/update

Toàn quyền

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 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ộcMô 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).

Yêu cầu
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]}'
Yêu cầu
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())
Yêu cầu
// 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());
Yêu cầu
// 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);
Thân yêu cầu
{
    "id": 45,
    "version": 3,
    "env": {
        "MODEL": "Qwen/Qwen3-14B",
        "OLD_VAR": null
    },
    "ports": [
        8000,
        7860
    ]
}
Phản hồi
{
    "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"
    }
}
POST

/gpu/saved-templates/delete

Toàn quyền

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 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ộcMô 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).

Yêu cầu
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}'
Yêu cầu
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())
Yêu cầu
// 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());
Yêu cầu
// 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);
Thân yêu cầu
{
    "id": 45,
    "version": 4
}
Phản hồi
{
    "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
    }
}
GET

/gpu/list

Chỉ đọc

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 · đ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ộcMô 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
Yêu cầu
curl 'https://cloudmoon.net/api/v1/gpu/list' \
  -H 'X-API-Key: ak_...'
Yêu cầu
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())
Yêu cầu
// 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());
Yêu cầu
// cm_api(): xem mục "Client mẫu" ở trang Tổng quan
$kq = cm_api('GET', '/v1/gpu/list');
print_r($kq);
Phản hồi
{
    "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
    }
}
GET

/gpu/info

Chỉ đọc

Chi 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ộcMô 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.

Yêu cầu
curl 'https://cloudmoon.net/api/v1/gpu/info?order_code=131126GPUABCDEFGHJK' \
  -H 'X-API-Key: ak_...'
Yêu cầu
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())
Yêu cầu
// 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());
Yêu cầu
// 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);
Phản hồi
{
    "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
    }
}
GET

/gpu/metrics

Chỉ đọc

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 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ộcMô 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.

Yêu cầu
curl 'https://cloudmoon.net/api/v1/gpu/metrics?order_code=131126GPUABCDEFGHJK' \
  -H 'X-API-Key: ak_...'
Yêu cầu
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())
Yêu cầu
// 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());
Yêu cầu
// 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);
Phản hồi
{
    "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
            }
        ]
    }
}
GET

/gpu/logs

Chỉ đọc

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ạ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ộcMô 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.

Yêu cầu
curl 'https://cloudmoon.net/api/v1/gpu/logs?order_code=131126GPUABCDEFGHJK' \
  -H 'X-API-Key: ak_...'
Yêu cầu
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())
Yêu cầu
// 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());
Yêu cầu
// 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);
Phản hồi
{
    "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
    }
}
GET

/gpu/charges

Chỉ đọc

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 — 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ộcMô 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.

Yêu cầu
curl 'https://cloudmoon.net/api/v1/gpu/charges?order_code=131126GPUABCDEFGHJK' \
  -H 'X-API-Key: ak_...'
Yêu cầu
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())
Yêu cầu
// 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());
Yêu cầu
// 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);
Phản hồi
{
    "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
        }
    }
}
POST

/gpu/buy

Toàn quyền

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 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ộcMô 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).

Yêu cầu
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"}'
Yêu cầu
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())
Yêu cầu
// 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());
Yêu cầu
// 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);
Thân yêu cầu
{
    "type": "linux",
    "card": "gtx1080ti",
    "tier": "fast",
    "template": "pytorch",
    "cuda": "12.4",
    "disk_gb": 30,
    "price_hour": 4500,
    "max_hours": 2,
    "note": "train-01"
}
Phản hồi
{
    "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"
    }
}
POST

/gpu/cancel

Toàn quyền

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_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ộcMô 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).

Yêu cầu
curl -X POST 'https://cloudmoon.net/api/v1/gpu/cancel' \
  -H 'X-API-Key: ak_...' \
  -H 'Content-Type: application/json' \
  -d '{"order_code":"131126GPUABCDEFGHJK"}'
Yêu cầu
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())
Yêu cầu
// 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());
Yêu cầu
// 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);
Thân yêu cầu
{
    "order_code": "131126GPUABCDEFGHJK"
}
Phản hồi
{
    "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
    }
}
POST

/gpu/upgrade

Toàn quyền

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 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ộcMô 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).

Yêu cầu
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}'
Yêu cầu
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())
Yêu cầu
// 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());
Yêu cầu
// 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);
Thân yêu cầu
{
    "order_code": "131126GPUABCDEFGHJK",
    "price_hour": 4500
}
Phản hồi
{
    "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"
    }
}
POST

/gpu/restart

Toàn quyền

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 độ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ộcMô 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).

Yêu cầu
curl -X POST 'https://cloudmoon.net/api/v1/gpu/restart' \
  -H 'X-API-Key: ak_...' \
  -H 'Content-Type: application/json' \
  -d '{"order_code":"131126GPUABCDEFGHJK"}'
Yêu cầu
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())
Yêu cầu
// 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());
Yêu cầu
// 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);
Thân yêu cầu
{
    "order_code": "131126GPUABCDEFGHJK"
}
Phản hồi
{
    "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
    }
}
POST

/gpu/stop

Toàn quyền

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.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ộcMô 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).

Yêu cầu
curl -X POST 'https://cloudmoon.net/api/v1/gpu/stop' \
  -H 'X-API-Key: ak_...' \
  -H 'Content-Type: application/json' \
  -d '{"order_code":"131126GPUABCDEFGHJK"}'
Yêu cầu
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())
Yêu cầu
// 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());
Yêu cầu
// 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);
Thân yêu cầu
{
    "order_code": "131126GPUABCDEFGHJK"
}
Phản hồi
{
    "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"
        ]
    }
}
POST

/gpu/start

Toàn quyền

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 (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ộcMô 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).

Yêu cầu
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"}'
Yêu cầu
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())
Yêu cầu
// 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());
Yêu cầu
// 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);
Thân yêu cầu
{
    "order_code": "131126GPUABCDEFGHJK"
}
Phản hồi
{
    "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"
        ]
    }
}
POST

/gpu/delete

Toàn quyền

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ằ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ộcMô 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).

Yêu cầu
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"}'
Yêu cầu
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())
Yêu cầu
// 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());
Yêu cầu
// 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);
Thân yêu cầu
{
    "order_code": "131126GPUABCDEFGHJK",
    "confirm": "131126GPUABCDEFGHJK"
}
Phản hồi
{
    "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
    }
}
POST

/gpu/limits

Toàn quyền

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, 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ộcMô 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).

Yêu cầu
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}'
Yêu cầu
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())
Yêu cầu
// 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());
Yêu cầu
// 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);
Thân yêu cầu
{
    "order_code": "131126GPUABCDEFGHJK",
    "max_amount": 20000
}
Phản hồi
{
    "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
    }
}
POST

/gpu/note

Toàn quyền

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ạng thái, kể cả máy đã trả.

POST https://cloudmoon.net/api/v1/gpu/note
Tham sốVị tríBắt buộcMô 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).

Yêu cầu
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"}'
Yêu cầu
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())
Yêu cầu
// 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());
Yêu cầu
// 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);
Thân yêu cầu
{
    "order_code": "131126GPUABCDEFGHJK",
    "note": "train-01"
}
Phản hồi
{
    "status": "success",
    "msg": "Đã lưu ghi chú",
    "data": {
        "order_code": "131126GPUABCDEFGHJK",
        "note": "train-01"
    }
}
GET

/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ộcMô tả
status query không active (mặc định) · closed · all
Yêu cầu
curl 'https://cloudmoon.net/api/v1/gpu/volumes' \
  -H 'X-API-Key: ak_...'
Yêu cầu
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())
Yêu cầu
// 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());
Yêu cầu
// cm_api(): xem mục "Client mẫu" ở trang Tổng quan
$kq = cm_api('GET', '/v1/gpu/volumes');
print_r($kq);
Phản hồi
{
    "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
        }
    }
}
GET

/gpu/volumes/info

Chỉ đọc

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 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ộcMô tả
volume_code query có Mã ổ lưu trữ (volume_code) — lấy từ /gpu/volumes
Yêu cầu
curl 'https://cloudmoon.net/api/v1/gpu/volumes/info?volume_code=131126GPOABCDEFGHJK' \
  -H 'X-API-Key: ak_...'
Yêu cầu
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())
Yêu cầu
// 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());
Yêu cầu
// 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);
Phản hồi
{
    "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
        }
    }
}
GET

/gpu/volumes/charges

Chỉ đọc

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à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ộcMô 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
Yêu cầu
curl 'https://cloudmoon.net/api/v1/gpu/volumes/charges?volume_code=131126GPOABCDEFGHJK' \
  -H 'X-API-Key: ak_...'
Yêu cầu
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())
Yêu cầu
// 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());
Yêu cầu
// 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);
Phản hồi
{
    "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
        }
    }
}
POST

/gpu/volumes/create

Toàn quyền

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 (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ộcMô 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).

Yêu cầu
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"}'
Yêu cầu
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())
Yêu cầu
// 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());
Yêu cầu
// 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);
Thân yêu cầu
{
    "size_gb": 20,
    "name": "du-lieu-train"
}
Phản hồi
{
    "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
    }
}
POST

/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ộcMô 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).

Yêu cầu
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"}'
Yêu cầu
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())
Yêu cầu
// 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());
Yêu cầu
// 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);
Thân yêu cầu
{
    "volume_code": "131126GPOABCDEFGHJK",
    "name": "du-lieu-train"
}
Phản hồi
{
    "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"
        ]
    }
}
POST

/gpu/volumes/resize

Toàn quyền

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 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ộcMô 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).

Yêu cầu
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}'
Yêu cầu
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())
Yêu cầu
// 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());
Yêu cầu
// 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);
Thân yêu cầu
{
    "volume_code": "131126GPOABCDEFGHJK",
    "size_gb": 50
}
Phản hồi
{
    "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
    }
}
POST

/gpu/volumes/delete

Toàn quyền

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 đ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ộcMô 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).

Yêu cầu
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"}'
Yêu cầu
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())
Yêu cầu
// 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());
Yêu cầu
// 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);
Thân yêu cầu
{
    "volume_code": "131126GPOABCDEFGHJK",
    "confirm": "131126GPOABCDEFGHJK"
}
Phản hồi
{
    "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": []
    }
}
Zalo