API Reference

Getting started

Authentication and credits

• Create a key at /dashboard/keys and send it on every request as Authorization: Bearer dd_live_....
• Metered endpoints spend universal credits from one shared balance. You are only charged when a call succeeds; provider failures never charge you.
• Success responses are plain JSON with the data directly (no envelope wrapper). Errors always use a single { error, message } shape; see Errors and rate limits.

curl -X POST https://www.developersdigest.tech/api/v1/images \
  -H "Authorization: Bearer dd_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "a minimal editorial illustration of an api"}'

Non-streaming text generation across the frontier chat models. The message is priced by the chosen model's credit tier; an unknown or absent model falls back to the default. Credits are deducted only after a successful generation.

Rate limit: 20 requests per 5 minutes

{
  "text": "...",
  "model": "moonshotai/kimi-k2.5",
  "creditsSpent": 1,
  "balance": 99
}

curl -X POST https://www.developersdigest.tech/api/v1/text \
  -H "Authorization: Bearer dd_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "Explain MCP in two sentences.", "model": "anthropic/claude-sonnet-5"}'

Generate an image from a text prompt. Models route through the AI Gateway and each model carries its own credit cost, resolved server-side. Credits are deducted only after a successful generation, so a provider failure never charges you.

Rate limit: 10 requests per 5 minutes

{
  "url": "https://.../image.png",
  "persisted": true,
  "model": "xai/grok-imagine-image",
  "creditsSpent": 1,
  "balance": 99
}

curl -X POST https://www.developersdigest.tech/api/v1/images \
  -H "Authorization: Bearer dd_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "isometric server room, editorial illustration", "size": "landscape"}'

Synthesize speech from text. The response is JSON (not a raw audio body) so credits and balance ride along with the audio; audioBase64 is a base64-encoded MP3 (audio/mpeg). You are only charged on success.

Rate limit: 10 requests per 5 minutes

{
  "audioBase64": "SUQzBAAAAAAA...",
  "model": "...",
  "voice": "...",
  "creditsSpent": 1,
  "balance": 99
}

curl -X POST https://www.developersdigest.tech/api/v1/voice \
  -H "Authorization: Bearer dd_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text": "Welcome to Developers Digest."}'

Generate a short video from a text prompt (plus an optional input image for image-to-video models). Each model carries its own credit cost, resolved server-side; credits are deducted only after a successful generation.

Rate limit: 5 requests per 5 minutes

{
  "url": "https://.../video.mp4",
  "model": "bytedance/seedance-2.0-fast",
  "creditsSpent": 8,
  "balance": 92
}

curl -X POST https://www.developersdigest.tech/api/v1/video \
  -H "Authorization: Bearer dd_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "slow pan across a workbench of developer tools"}'

Identity and credit balance for the authenticated caller. Useful for a CLI or agent to confirm the key works and show the remaining balance before spending.

{
  "clerkId": "user_...",
  "balance": 95,
  "isOwner": false,
  "plan": "plan-developer",
  "planRenewsAt": "2026-08-01T00:00:00.000Z"
}

curl https://www.developersdigest.tech/api/v1/me \
  -H "Authorization: Bearer dd_live_YOUR_KEY"

List your saved assets, newest first, with your folder list. Reading the gallery never spends credits. POST to the same path persists a just-generated asset (image via a provider sourceUrl, or voice via audioBase64) into durable storage; persisting is also free because the generating call already charged. PATCH moves an asset into a folder.

{
  "folders": ["Uncategorized", "Heroes"],
  "assets": [
    {
      "id": "…",
      "kind": "image",
      "url": "https://…",
      "name": null,
      "folder": null,
      "prompt": "…",
      "model": "…",
      "contentType": "image/png",
      "creditsSpent": 5,
      "createdAt": "2026-07-01T00:00:00.000Z"
    }
  ]
}

curl "https://www.developersdigest.tech/api/v1/gallery?limit=20" \
  -H "Authorization: Bearer dd_live_YOUR_KEY"

The lean index of the Developers Digest Skill Library: slug, one-line description, and category for every skill. The entry point for progressive disclosure - scan this cheap list, then fetch a single skill's manifest.

Public content - no API key required.

{
  "skills": [
    { "slug": "mcp-server-authoring", "description": "...", "category": "..." }
  ]
}

curl https://www.developersdigest.tech/api/v1/skills

A single skill's overview manifest: identity plus the file tree (paths and a one-line purpose, not contents) and a download link. The middle tier of progressive disclosure.

Public content - no API key required.

{
  "slug": "mcp-server-authoring",
  "name": "...",
  "description": "...",
  "category": "...",
  "files": [ { "path": "SKILL.md", "purpose": "..." } ],
  "downloadUrl": "https://www.developersdigest.tech/api/v1/skills/mcp-server-authoring/download"
}

curl https://www.developersdigest.tech/api/v1/skills/mcp-server-authoring

Download a skill as a .zip. The archive holds the full multi-file tree under a single top-level folder named after the slug, so it unpacks cleanly into a .claude/skills/ directory.

Public content - no API key required.

HTTP/1.1 200 OK
Content-Type: application/zip
Content-Disposition: attachment; filename="mcp-server-authoring.zip"

<zip bytes>

curl -L https://www.developersdigest.tech/api/v1/skills/mcp-server-authoring/download -o skill.zip

Shared semantics

Errors and rate limits

Every endpoint uses the same error envelope: a machine-readable error code plus a human message, with the matching HTTP status. Gating runs in order: auth (401), then rate limit (429), then validation (400), then credit balance (402).

Generation endpoints also return 503 not_configured when a provider is not set up for the deployment. The public skill endpoints are unauthenticated and return a plain 404 for an unknown slug rather than the auth or credit envelope.

{
  "error": "insufficient_credits",
  "message": "Not enough credits for this action. Add credits at /pricing.",
  "balance": 1
}

Agents

MCP server

The platform also ships as a Vercel-hosted Model Context Protocol server at https://www.developersdigest.tech/api/mcp (streamable HTTP). It exposes the same credit-metered capabilities as the REST API as MCP tools so agents can call them directly. A dd_live_ key is required via Authorization: Bearer on the transport; there is no session on MCP. See the MCP platform overview for the connect walkthrough.

{
  "mcpServers": {
    "developers-digest": {
      "type": "http",
      "url": "https://www.developersdigest.tech/api/mcp",
      "headers": {
        "Authorization": "Bearer dd_live_YOUR_KEY"
      }
    }
  }
}