API Reference

1. Trial (5 free credits)

Auto-provisioned on first API call. No email needed. Generations are auto-public in the gallery.

2. Claim (bind email)

When trial credits run out, bind an email to unlock more credits. Verification sent via email.

3. BYOK (unlimited, zero credits)

Attach an OpenRouter API key for unlimited generations at zero credit cost. Key is encrypted (AES-256-GCM).

POST /v1/trial

Create a trial account. Body: { "token": "string" }

curl -X POST https://crevisto.com/v1/trial \
  -H "Content-Type: application/json" \
  -d '{"token":"my-agent-token-12345678"}'

GET /v1/whoami

Check credit balance and trial status. Requires bearer token.

curl -H "Authorization: Bearer TOKEN" \
  https://crevisto.com/v1/whoami

GET /v1/tools

List all 100 AI tools with inputs, credit costs, and descriptions.

curl -H "Authorization: Bearer TOKEN" \
  https://crevisto.com/v1/tools

POST /v1/tools/:slug/execute

Generate an image. Body: { "inputs": { ... }, "isPublic": false }

curl -X POST https://crevisto.com/v1/tools/logo-maker/execute \
  -H "Authorization: Bearer TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"inputs":{"description":"A tech startup logo","style":"minimal"}}'

POST /app/claim

Bind email to trial account. Body: { "token": "...", "email": "..." }

POST /v1/byok

Attach OpenRouter API key. Body: { "apiKey": "sk-or-v1-..." }

GET /v1/gallery

Browse public gallery. Query params: ?tool=slug&limit=24&skip=0

POST /v1/gallery/:id/toggle

Toggle your generation public/private. Requires bearer token.