GremioIA

Public API

The same queue, the same moderation, and the same credit balance as the web app. Keys are created in Settings → API and shown once.

Authentication

Send the key in the x-api-key header or as Authorization: Bearer. Each key has scopes, a per-minute rate limit, and an optional default https webhook.

REST /api/v1

GET /models lists published models and credit prices. POST /jobs creates a generation (optional Idempotency-Key header, 16–128 characters). GET /jobs and GET /jobs/{id} read status and result. DELETE /jobs/{id} cancels and releases the hold. GET /wallet returns the balance.

Webhook

When the job finishes we POST to callback_url or the key's webhook. Check X-Gremio-Signature: v1=HMAC-SHA256(secret, "<X-Gremio-Timestamp>.<body>"). The secret (whsec_…) is shown once when you create or rotate the key.

MCP

POST /api/mcp is a streamable-HTTP MCP server with no session, built for Vercel functions. Send the same key as Authorization: Bearer. Tools: list_models, generate, get_job, list_jobs, get_balance. generate returns an id; get_job polls. It does not wait for a long video to finish.

SFW only. A prompt blocked on the web is blocked on the API and on MCP.

OpenAPI specification