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.
API REST
JSON sobre HTTPS. Los importes son cadenas decimales en MZG; las marcas de tiempo, ISO-8601.
SDK de TypeScript
@mzgrid/sdk encapsula la API, la financiación de la garantía y las ABI, totalmente tipado.
Billetera y claves de API
Inicia sesión con cualquier billetera y emite claves mzg_live_ para tus servidores.
Listo para agentes
Los agentes pueden descubrir, financiar y ejecutar cómputo sin intervención humana.
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 viemMZG en Base— Ten suficientes MZG para precio × duración máximaETH en Base— Un poco de ETH para el gas de la transacción de financiación
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);# Sign in once with your wallet, then create an API key in the dashboard
export MZG_API_KEY="mzg_live_..."
# Browse live offers: cheapest H100 SXM with reliability >= 95
curl -s "https://api.mzgrid.io/v1/market/offers?sku=h100-sxm&minReliability=95&sort=price&limit=5"
# Create a job — returns the escrow parameters to fund on Base
curl -s -X POST "https://api.mzgrid.io/v1/jobs" \
-H "Authorization: Bearer $MZG_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"sku": "h100-sxm",
"autoSelect": true,
"template": "llama-3.3-70b",
"maxDurationHours": 6,
"config": {}
}'
# After funding, report the transaction so the job is dispatched
curl -s -X POST "https://api.mzgrid.io/v1/jobs/$JOB_ID/funded" \
-H "Authorization: Bearer $MZG_API_KEY" \
-H "Content-Type: application/json" \
-d '{"txHash": "0x..."}'import os, time, requests
API = "https://api.mzgrid.io/v1"
H = {"Authorization": f"Bearer {os.environ['MZG_API_KEY']}"}
# Live GPU catalogue with availability and prices in MZG
for g in requests.get(f"{API}/catalog/gpus").json():
print(f"{g['name']:<24} {g['availableGpus']:>5} free from {g['lowestPrice']} MZG/h")
# Poll a job until its endpoint is ready
job_id = os.environ["JOB_ID"]
while True:
job = requests.get(f"{API}/jobs/{job_id}", headers=H).json()
if job["status"] == "running":
print("Endpoint:", job["endpointUrl"])
break
time.sleep(3)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.
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)import OpenAI from "openai";
const client = new OpenAI({ baseURL: `${endpointUrl}/v1`, apiKey: process.env.VLLM_API_KEY });
const stream = await client.chat.completions.create({
model: "meta-llama/Llama-3.1-8B-Instruct",
messages: [{ role: "user", content: "Write a haiku about idle GPUs." }],
stream: true,
});
for await (const chunk of stream) process.stdout.write(chunk.choices[0]?.delta?.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.