Chuyển đến nội dung
MZGrid

Nhà phát triển

Tài nguyên GPU chỉ bằng một lệnh gọi API.

Tạo tác vụ, nạp ký quỹ và nhận endpoint tương thích OpenAI theo chương trình. Mọi thứ bạn có thể làm trên chợ GPU — và mọi thứ một agent tự hành cần — đều có qua REST và SDK TypeScript.

Bắt đầu nhanh

Triển khai Llama 3.1 8B chỉ với chục dòng mã.

SDK xử lý việc tạo tác vụ, permit EIP-2612 và giao dịch createJob, sau đó chờ nhà cung cấp khởi chạy endpoint cho bạn.

  • npm install @mzgrid/sdk viem — Cài đặt SDK và viem
  • MZG trên Base — Có đủ MZG cho giá × thời lượng tối đa
  • ETH trên Base — Một ít ETH để trả gas cho giao dịch nạp tiền
deploy.ts
import { CURRENT_TERMS_VERSION, MZGridClient } from "@mzgrid/sdk";
import { createWalletClient, custom } from "viem";
import { base } from "viem/chains";

const wallet = createWalletClient({ chain: base, transport: custom(window.ethereum!) });
// Wallet sign-in requires the Terms of Service version the user has explicitly accepted
const mzg = new MZGridClient({ apiUrl: "https://api.mzgrid.io", walletClient: wallet, termsVersion: CURRENT_TERMS_VERSION });

// 1. Let the scheduler pick the best RTX 4090 by price, reliability and proximity
const created = await mzg.jobs.create({
  sku: "rtx4090",
  autoSelect: true,
  template: "llama-3.1-8b",
  maxDurationHours: 4,
});

// 2. Deposit into escrow (EIP-2612 permit + createJob) — deposit = price × 4 h
await mzg.jobs.fund(created, wallet);

// 3. Wait for the OpenAI-compatible endpoint
const { endpointUrl } = await mzg.jobs.waitForEndpoint(created.job.id);
console.log("Ready:", endpointUrl);

Tương thích OpenAI

Trỏ client hiện có của bạn tới endpoint của bạn.

Các mẫu suy luận chạy vLLM và cung cấp /v1/chat/completions, /v1/completions và /v1/embeddings. Chỉ cần đổi base URL — LangChain, LlamaIndex và các SDK OpenAI hoạt động mà không cần thay đổi.

Công cụ tương thích
chat.py
from openai import OpenAI

# endpointUrl from GET /v1/jobs/:id once status == "running"
client = OpenAI(base_url=f"{endpoint_url}/v1", api_key=os.environ["VLLM_API_KEY"])

resp = client.chat.completions.create(
    model="meta-llama/Llama-3.1-8B-Instruct",
    messages=[{"role": "user", "content": "Summarise how MZGrid escrow works in two sentences."}],
    max_tokens=200,
)
print(resp.choices[0].message.content)

Tham chiếu API

Tổng quan các endpoint.

Base URL https://api.mzgrid.io/v1. Xác thực bằng Authorization: Bearer <token | key>.

Công khai

  • GET/v1/healthTrạng thái dịch vụ, chain id và block đã lập chỉ mục
  • GET/v1/catalog/gpusDanh mục GPU kèm mức sẵn có và giá trực tiếp
  • GET/v1/catalog/templatesMẫu khối lượng công việc và GPU được khuyến nghị
  • GET/v1/market/offersGói chào thuê trực tiếp — lọc theo sku, khu vực, VRAM, độ tin cậy
  • GET/v1/market/offers/:idChi tiết gói chào thuê kèm lịch sử giá và tác vụ gần đây
  • GET/v1/network/statsTổng số liệu mạng lưới và số liệu 24 giờ
  • GET/v1/network/timeseriesChuỗi dữ liệu theo ngày cho gpuHours, jobs, providers, mzgSettled…
  • GET/v1/network/regions · /sku-mix · /leaderboard · /activityĐịa lý, cơ cấu GPU, nhà cung cấp hàng đầu, luồng trực tiếp

Xác thực & khóa

  • POST/v1/auth/nonceLấy thông điệp đăng nhập cho một địa chỉ ví
  • POST/v1/auth/verifyĐổi chữ ký EIP-191 lấy token phiên
  • POST/v1/keysTạo khóa API (mzg_live_…)
  • GET · DELETE/v1/keys · /v1/keys/:idLiệt kê hoặc thu hồi khóa API

Tác vụ & tài khoản

  • POST/v1/jobsTạo tác vụ từ một gói chào thuê hoặc với autoSelect; trả về tham số ký quỹ
  • POST/v1/jobs/:id/fundedGửi hash giao dịch nạp tiền; bộ điều phối xác minh JobFunded
  • GET/v1/jobs · /v1/jobs/:idLiệt kê tác vụ hoặc lấy một tác vụ kèm trạng thái, endpoint và các giao dịch
  • GET/v1/jobs/:id/logsLog container kể từ một mốc thời gian
  • POST/v1/jobs/:id/stopDừng sớm — quyết toán số giây đã dùng, hoàn lại phần còn lại
  • GET/v1/accountSố dư MZG, số tiền đang ký quỹ, chi tiêu 30 ngày

Hợp đồng thông minh trên Base

MZGToken, MZGridEscrow và ProviderRegistry đã được xác minh trên Basescan. Xem mọi hàm, sự kiện và hằng số trong tài liệu tham chiếu hợp đồng.

Tham chiếu hợp đồng