Open API wire server-side tools into your own system

1. Authentication

Send the key with every request:

Authorization: Bearer tdd_xxxxxxxxxxxxxxxx

Keys are issued to signed-in users only (giving them to anonymous visitors would be a way around per-page rate limits). The plaintext is shown once, on the creation screen; the server stores only its sha256, so a forgotten key has to be regenerated.

2. Request flow

1. Create a task: POST /api/v1/tasks, using the multipart fields tool (tool code), file (use files[]), params (JSON string)
2. Check status: GET /api/v1/tasks?no=task number; when status is done it returns result.url
3. Download the result: GET /api/v1/results?no=task number, with the same Bearer header
4. Check usage: GET /api/v1/usage; returns today's quota and the calls used this minute

Example (HEIC to JPG):

curl -X POST https://www.tdd8.cn/api/v1/tasks \
  -H "Authorization: Bearer tdd_xxx" \
  -F "tool=convert_heic" \
  -F "params={\"format\":\"jpg\"}" \
  -F "file=@photo.heic"

# returns {"ok":true,"task_no":"T2026...","status":"pending","left":19,"ttl":7200}

curl -H "Authorization: Bearer tdd_xxx" \
  "https://www.tdd8.cn/api/v1/tasks?no=T2026..."        # Check status
curl -H "Authorization: Bearer tdd_xxx" -o out.jpg \
  "https://www.tdd8.cn/api/v1/results?no=T2026..."      # Download

The tool code is the code shown on each tool page, for example convert_heic, pdf_to_jpg, video_convert, gif_reverse, denoise. Only tools that cannot run in the browser and must be processed server-side are exposed through the API; passing a local tool code returns 404.

3. Quota and rate limits

• Quota: shared with the website—20 runs per day for free users, more on VIP plans (from 200), resetting at 00:00 daily. One file counts as one run.
• Rate limit: each key may create at most the per-minute value you chose at creation tasks per minute; exceeding it returns 429 with Retry-After: 60.
• Concurrency: a single key may have at most 3 tasks queued or processing; beyond that returns 429.
• Result retention: follows the account—2 hours for free users, 24 hours / 72 hours / 7 days for VIP. Expired files are removed and the API returns 410.
• Billing: no separate charge for now; the API shares the website quota. If usage-based pricing is introduced later it will be announced in advance—we will not change the rules quietly.

4. Error codes

5. My keys

API keys are available to signed-in users only. Sign in to create one on this page, or sign up.

FAQ