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 key402— Insufficient workspace credits (ERR_INSUFFICIENT_CREDITS)429— Rate limit exceeded (checkRetry-After)ERR_INVALID_EXISTING_CREDENTIALS— Blocked by Guardrail G3ERR_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);