İçeriğe geç
MZGrid

Geliştiriciler

Bir API çağrısı kadar kolay GPU işlem gücü.

İş oluşturun, emaneti fonlayın ve OpenAI uyumlu uç noktaları programatik olarak edinin. Pazar yerinde yapabildiğiniz her şey — ve otonom bir ajanın ihtiyaç duyduğu her şey — REST ve TypeScript SDK üzerinden kullanılabilir.

Hızlı başlangıç

Llama 3.1 8B’yi bir düzine satırda dağıtın.

SDK iş oluşturmayı, EIP-2612 permit’i ve createJob işlemini yönetir, ardından sağlayıcının uç noktanızı ayağa kaldırmasını bekler.

  • npm install @mzgrid/sdk viem — SDK’yı ve viem’i kurun
  • Base üzerinde MZG — Fiyat × maksimum süre kadar MZG bulundurun
  • Base üzerinde ETH — Fonlama işleminin gas ücreti için biraz ETH
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);

OpenAI uyumlu

Mevcut istemcinizi uç noktanıza yönlendirin.

Çıkarım şablonları vLLM çalıştırır ve /v1/chat/completions, /v1/completions ve /v1/embeddings uç noktalarını sunar. Temel URL’yi değiştirin — LangChain, LlamaIndex ve OpenAI SDK’ları değişiklik olmadan çalışır.

Uyumlu araçlar
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)

API referansı

Uç noktalara hızlı bakış.

Temel URL https://api.mzgrid.io/v1. Kimlik doğrulaması için Authorization: Bearer <token | key> kullanın.

Herkese açık

  • GET/v1/healthHizmet durumu, zincir kimliği ve indekslenen blok
  • GET/v1/catalog/gpusCanlı müsaitlik ve fiyatlarla GPU kataloğu
  • GET/v1/catalog/templatesİş yükü şablonları ve önerilen GPU’lar
  • GET/v1/market/offersCanlı teklifler — sku, bölge, VRAM ve güvenilirliğe göre filtreleyin
  • GET/v1/market/offers/:idFiyat geçmişi ve son işlerle teklif ayrıntısı
  • GET/v1/network/statsAğ toplamları ve 24 saatlik veriler
  • GET/v1/network/timeseriesgpuHours, jobs, providers, mzgSettled… için günlük seriler
  • GET/v1/network/regions · /sku-mix · /leaderboard · /activityCoğrafya, GPU dağılımı, en iyi sağlayıcılar, canlı akış

Kimlik doğrulama ve anahtarlar

  • POST/v1/auth/nonceBir cüzdan adresi için giriş mesajı alın
  • POST/v1/auth/verifyEIP-191 imzasını bir oturum belirteciyle değiştirin
  • POST/v1/keysAPI anahtarı oluşturun (mzg_live_…)
  • GET · DELETE/v1/keys · /v1/keys/:idAPI anahtarlarını listeleyin veya iptal edin

İşler ve hesap

  • POST/v1/jobsBir tekliften veya autoSelect ile iş oluşturun; emanet parametrelerini döndürür
  • POST/v1/jobs/:id/fundedFonlama işlem hash’ini gönderin; koordinatör JobFunded olayını doğrular
  • GET/v1/jobs · /v1/jobs/:idİşleri listeleyin veya durum, uç nokta ve işlemlerle birlikte tek bir işi getirin
  • GET/v1/jobs/:id/logsBelirli bir zaman damgasından itibaren konteyner günlükleri
  • POST/v1/jobs/:id/stopErken durdurun — kullanılan saniyelerin mutabakatını yapar, kalanını iade eder
  • GET/v1/accountMZG bakiyesi, emanetteki tutar, 30 günlük harcama

Base üzerindeki akıllı sözleşmeler

MZGToken, MZGridEscrow ve ProviderRegistry, Basescan’de doğrulanmıştır. Her fonksiyonu, olayı ve sabiti sözleşme referansında okuyun.

Sözleşme referansı