API Documentation

If your key is leaked, rotate it to get a fresh one. Authenticate with your current API key plus your wallet address — the old key stops working the instant the new one is issued.

curl -X POST https://cutedsl.cc/api/auth/rotate-api-key \
  -H "Content-Type: application/json" \
  -d '{
    "wallet_address": "YOUR_WALLET_ADDRESS",
    "api_key": "YOUR_API_KEY"
  }'

The response contains your new key — store it securely:

{
  "success": true,
  "api_key": "cutedsl_xxxxxxxxxxxxxxxxxxxxxxxx",  // your new key
  "user": { ... }
}

Your wallet address is public and safe to share; your API key is secret. You can also rotate with one click on the Account page.

All services share a single endpoint: POST /api/service

curl -X POST https://cutedsl.cc/api/service \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "service": "<service_name>",
    ...service-specific parameters
  }'

All responses follow this envelope:

{
  "result": { ... },        // Service-specific response data
  "credits_used": 1000,     // $CUTEDSL tokens deducted
  "credits_remain": 49000,  // Remaining balance
  "usd_equivalent": 1.00    // USD value of credits used
}

Services take public URLs for audio, image and video inputs. Ask for a presigned URL and PUT the bytes straight to CuteDSL object storage — nothing large passes through the API.

# 1. Presign (expires in 15 minutes)
curl "https://cutedsl.cc/api/uploads/presign?filename=speech.wav&content_type=audio/wav&dataset=stt" \
  -H "Authorization: Bearer YOUR_API_KEY"

# 2. Upload the bytes directly
curl -X PUT "PRESIGNED_UPLOAD_URL" -H "Content-Type: audio/wav" --data-binary @speech.wav

# 3. Use the returned public_url with any service
curl -X POST https://cutedsl.cc/api/service \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"service": "stt", "audio_url": "PUBLIC_URL"}'

Presign response:

{
  "upload_url": "https://<account>.r2.cloudflarestorage.com/...",
  "public_url": "https://appstatic.app.nz/cutedsl/uploads/<user>/<dataset>/<id>-speech.wav",
  "object_key": "cutedsl/uploads/<user>/<dataset>/<id>-speech.wav",
  "expires_in": 900
}

Browsers can do the same PUT from the page — the Speech-to-Text playground records from your mic, uploads, and transcribes without leaving the docs.