Jingle Studio Tools

API & MCP Documentation

Authenticate every request with a workspace API key from /app/developers.

Authentication & Rate Limits

Pass Authorization: Bearer jst_... on all /api/v1/* and /api/mcp requests. Keys are stored as SHA-256 hashes and rate-limited to 60 requests per minute per key.

Common Error Codes

  • 401 — Missing, invalid, or revoked API key
  • 402 — Insufficient workspace credits (ERR_INSUFFICIENT_CREDITS)
  • 429 — Rate limit exceeded (check Retry-After)
  • ERR_INVALID_EXISTING_CREDENTIALS — Blocked by Guardrail G3
  • ERR_DISCLOSURE_CONFLICT — Blocked by Guardrail G4 (no_ai on AI ingredient)

curl Examples

# 1. Check workspace credit balance
curl -s https://jingle-studio-tools.vercel.app/api/v1/credits \
  -H "Authorization: Bearer jst_YOUR_KEY"

# 2. Check a file's Content Credentials (without storing it)
curl -s -X POST https://jingle-studio-tools.vercel.app/api/v1/check \
  -H "Authorization: Bearer jst_YOUR_KEY" \
  -F "file=@photo.png"

# 3. Create a signing job
curl -s -X POST https://jingle-studio-tools.vercel.app/api/v1/sign-jobs \
  -H "Authorization: Bearer jst_YOUR_KEY" \
  -F "files=@photo.png" \
  -F "creatorName=Studio Team" \
  -F "aiUse=full_ai" \
  -F "modelType=imageGeneration"

JavaScript Example

const res = await fetch("https://jingle-studio-tools.vercel.app/api/v1/credits", {
  headers: { Authorization: "Bearer jst_YOUR_KEY" },
});
const { balance } = await res.json();
console.log("Credits:", balance);