Saltar al contenido
MZGrid

Desarrolladores

Cómputo GPU con una llamada a la API.

Crea trabajos, financia el depósito en garantía y obtén endpoints compatibles con OpenAI de forma programática. Todo lo que puedes hacer en el marketplace, y todo lo que necesita un agente autónomo, está disponible mediante REST y el SDK de TypeScript.

Inicio rápido

Despliega Llama 3.1 8B en una docena de líneas.

El SDK se encarga de crear el trabajo, del permit EIP-2612 y de la transacción createJob, y después espera a que el proveedor levante tu endpoint.

  • npm install @mzgrid/sdk viem — Instala el SDK y viem
  • MZG en Base — Ten suficientes MZG para precio × duración máxima
  • ETH en Base — Un poco de ETH para el gas de la transacción de financiació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);

Compatible con OpenAI

Apunta tu cliente actual a tu endpoint.

Las plantillas de inferencia ejecutan vLLM y exponen /v1/chat/completions, /v1/completions y /v1/embeddings. Cambia la URL base: LangChain, LlamaIndex y los SDK de OpenAI funcionan sin cambios.

Herramientas compatibles
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)

Referencia de la API

Los endpoints de un vistazo.

URL base https://api.mzgrid.io/v1. Autentícate con Authorization: Bearer <token | key>.

Públicos

  • GET/v1/healthEstado del servicio, chain id y bloque indexado
  • GET/v1/catalog/gpusCatálogo de GPU con disponibilidad y precios en vivo
  • GET/v1/catalog/templatesPlantillas de cargas de trabajo y GPU recomendadas
  • GET/v1/market/offersOfertas en vivo: filtra por sku, región, VRAM y fiabilidad
  • GET/v1/market/offers/:idDetalle de la oferta con historial de precios y trabajos recientes
  • GET/v1/network/statsTotales de la red y cifras de 24 h
  • GET/v1/network/timeseriesSeries diarias de gpuHours, jobs, providers, mzgSettled…
  • GET/v1/network/regions · /sku-mix · /leaderboard · /activityGeografía, mezcla de GPU, mejores proveedores, feed en vivo

Autenticación y claves

  • POST/v1/auth/nonceObtén un mensaje de inicio de sesión para una dirección de billetera
  • POST/v1/auth/verifyIntercambia una firma EIP-191 por un token de sesión
  • POST/v1/keysCrea una clave de API (mzg_live_…)
  • GET · DELETE/v1/keys · /v1/keys/:idLista o revoca claves de API

Trabajos y cuenta

  • POST/v1/jobsCrea un trabajo a partir de una oferta o con autoSelect; devuelve los parámetros de la garantía
  • POST/v1/jobs/:id/fundedEnvía el hash de la tx de financiación; el coordinador verifica JobFunded
  • GET/v1/jobs · /v1/jobs/:idLista trabajos u obtén uno con su estado, endpoint y txs
  • GET/v1/jobs/:id/logsRegistros del contenedor desde una marca de tiempo
  • POST/v1/jobs/:id/stopDetén antes de tiempo: liquida los segundos usados y reembolsa el resto
  • GET/v1/accountSaldo de MZG, importe en garantía, gasto de 30 días

Contratos inteligentes en Base

MZGToken, MZGridEscrow y ProviderRegistry están verificados en Basescan. Consulta cada función, evento y constante en la referencia de contratos.

Referencia de contratos