GremioIA

API pública

La misma cola, la misma moderación y el mismo saldo de créditos que la web. Las llaves se crean en Ajustes → API y se muestran una sola vez.

Autenticación

Envía la llave en el header x-api-key o como Authorization: Bearer. Cada llave tiene scopes, un límite de peticiones por minuto y, si quieres, un webhook https por defecto.

REST /api/v1

GET /models lista solo modelos publicados con su precio en créditos. POST /jobs crea una generación (header Idempotency-Key opcional, 16–128 caracteres). GET /jobs y GET /jobs/{id} leen el estado y el resultado. DELETE /jobs/{id} cancela y libera el hold. GET /wallet devuelve el saldo.

Webhook

Al terminar el job hacemos POST a callback_url o al webhook de la llave. Verifica X-Gremio-Signature: v1=HMAC-SHA256(secreto, "<X-Gremio-Timestamp>.<cuerpo>"). El secreto (whsec_…) se muestra una sola vez al crear o rotar la llave.

MCP

POST /api/mcp es un servidor MCP por HTTP (streamable, sin sesión, pensado para funciones de Vercel). La misma llave va en Authorization: Bearer. Tools: list_models, generate, get_job, list_jobs, get_balance. generate devuelve un id; get_job consulta el estado. No espera a que termine un video largo.

Solo contenido apto. Un prompt bloqueado en la web también se bloquea en la API y en el MCP.

Especificación OpenAPI