Pular para o conteúdo
MZGrid

Desenvolvedores

Computação em GPU como uma chamada de API.

Crie jobs, financie a custódia e obtenha endpoints compatíveis com OpenAI de forma programática. Tudo o que você pode fazer no marketplace — e tudo de que um agente autônomo precisa — está disponível via REST e no SDK TypeScript.

Guia rápido

Implante o Llama 3.1 8B em uma dúzia de linhas.

O SDK cuida da criação do job, do permit EIP-2612 e da transação createJob e, em seguida, aguarda o provedor colocar seu endpoint no ar.

  • npm install @mzgrid/sdk viem — Instale o SDK e o viem
  • MZG na Base — Tenha MZG suficiente para preço × duração máxima
  • ETH na Base — Um pouco de ETH para o gas da transação de financiamento
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);

Compatível com OpenAI

Aponte seu cliente atual para o seu endpoint.

Os templates de inferência rodam vLLM e expõem /v1/chat/completions, /v1/completions e /v1/embeddings. Troque a URL base — LangChain, LlamaIndex e os SDKs da OpenAI funcionam sem alterações.

Ferramentas compatíveis
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)

Referência da API

Endpoints em resumo.

URL base https://api.mzgrid.io/v1. Autentique com Authorization: Bearer <token | key>.

Públicos

  • GET/v1/healthStatus do serviço, chain id e bloco indexado
  • GET/v1/catalog/gpusCatálogo de GPUs com disponibilidade e preços ao vivo
  • GET/v1/catalog/templatesTemplates de carga de trabalho e GPUs recomendadas
  • GET/v1/market/offersOfertas ao vivo — filtre por sku, região, VRAM, confiabilidade
  • GET/v1/market/offers/:idDetalhes da oferta com histórico de preços e jobs recentes
  • GET/v1/network/statsTotais da rede e números das últimas 24h
  • GET/v1/network/timeseriesSéries diárias de gpuHours, jobs, providers, mzgSettled…
  • GET/v1/network/regions · /sku-mix · /leaderboard · /activityGeografia, mix de GPUs, principais provedores, feed ao vivo

Autenticação e chaves

  • POST/v1/auth/nonceObtenha uma mensagem de login para um endereço de carteira
  • POST/v1/auth/verifyTroque uma assinatura EIP-191 por um token de sessão
  • POST/v1/keysCrie uma chave de API (mzg_live_…)
  • GET · DELETE/v1/keys · /v1/keys/:idListe ou revogue chaves de API

Jobs e conta

  • POST/v1/jobsCrie um job a partir de uma oferta ou com autoSelect; retorna os parâmetros da custódia
  • POST/v1/jobs/:id/fundedEnvie o hash da tx de financiamento; o coordenador verifica o JobFunded
  • GET/v1/jobs · /v1/jobs/:idListe jobs ou busque um com status, endpoint e txs
  • GET/v1/jobs/:id/logsLogs do contêiner a partir de um timestamp
  • POST/v1/jobs/:id/stopPare antes — liquida os segundos usados e reembolsa o restante
  • GET/v1/accountSaldo de MZG, valor em custódia, gastos dos últimos 30 dias

Smart contracts na Base

MZGToken, MZGridEscrow e ProviderRegistry são verificados no Basescan. Leia cada função, evento e constante na referência dos contratos.

Referência dos contratos