FAQ

New here? Start here.

What is Moondraft?

A tool for generating images and video with AI. Three ways to use it, all on one account: the free Mac app (a visual canvas), MCP (use it from Claude or Cursor by chatting), or the REST API (call it from your own code).

Do I need to be technical?

No. Download the Mac app and click around, or connect it to Claude with one command (see MCP Integration) and just ask — "make me 5 logo concepts." The REST API is there if you want to call it from code, but you don't have to.

How does pricing work?

The app is free and there is no monthly subscription. You only pay for what you generate, using credits. You get 50 free credits when you sign up (no card needed), then top up whenever you want.

App vs. MCP vs. API — what's the difference?

App: the visual canvas on your Mac. MCP: lets your AI assistant use Moondraft as a tool, so you generate by chatting. API: raw HTTP for your own code. One API key works across all three and they share the same credit balance.

What's MCP, exactly?

MCP (Model Context Protocol) is a standard way to give an AI assistant new abilities. Connect Moondraft once (setup here), restart your assistant, and it can make images and video for you on request.

What if a generation fails?

Your credits are automatically refunded. You're never charged for something that didn't come back.

Do you train AI models on my prompts or images?

No — see our Privacy Policy.

How do I get an API key?

Moondraft is in private beta. Request access, then grab your key from the sign-up flow once you're in.

Authentication

All API requests require a Bearer token in the Authorization header.

Authorization: Bearer md_your_api_key_here

To get an API key, create an account via the sign-up flow:

POST /v1/auth/send-code

Send a verification code to your email.

curl -X POST https://moondraft.ai/v1/auth/send-code \
  -H "Content-Type: application/json" \
  -d '{ "email": "you@example.com" }'

POST /v1/auth/verify

Verify the code and receive your API key. You get 50 free credits on signup.

curl -X POST https://moondraft.ai/v1/auth/verify \
  -H "Content-Type: application/json" \
  -d '{ "email": "you@example.com", "code": "123456" }'

Base URL

https://moondraft.ai

All endpoints are prefixed with /v1.

Generate Image

POST /v1/generate

Generate a single image from a text prompt. Optionally pass a style or character reference image.

Supported aspect ratios:

Response:

{
  "success": true,
  "quality": "standard",
  "image": "data:image/png;base64,..."
}

curl -X POST https://moondraft.ai/v1/generate \
  -H "Authorization: Bearer md_..." \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "product photo of sneakers on marble",
    "quality": "premium",
    "aspect_ratio": "1:1"
  }'

curl -X POST https://moondraft.ai/v1/generate \
  -H "Authorization: Bearer md_..." \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "hero illustration for a fintech landing page",
    "style_ref": "data:image/png;base64,..."
  }'

Batch Generate

POST /v1/generate/batch

Generate up to 10 images in a single request. Same options as /v1/generate, but with an array of prompts.

Response:

{
  "results": [
    { "prompt": "hero shot", "image": "data:image/png;base64,...", "success": true },
    { "prompt": "side angle", "image": "data:image/png;base64,...", "success": true }
  ],
  "quality": "premium"
}

curl -X POST https://moondraft.ai/v1/generate/batch \
  -H "Authorization: Bearer md_..." \
  -H "Content-Type: application/json" \
  -d '{
    "prompts": ["hero shot", "side angle", "close-up detail"],
    "quality": "premium",
    "style_ref": "data:image/png;base64,..."
  }'

Edit Image

POST /v1/edit

Edit an existing image with a text prompt. Describe the changes you want.

Response:

{
  "success": true,
  "image": "data:image/png;base64,..."
}

curl -X POST https://moondraft.ai/v1/edit \
  -H "Authorization: Bearer md_..." \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "change the background to a beach sunset",
    "image": "data:image/png;base64,..."
  }'

Video

POST /v1/video

Generate a 5-second MP4 video. The endpoint picks the mode based on what you send:

curl -X POST https://moondraft.ai/v1/video \
  -H "Authorization: Bearer md_..." \
  -H "Content-Type: application/json" \
  -d '{ "prompt": "slow pan across mountain lake, sunrise" }'

curl -X POST https://moondraft.ai/v1/video \
  -H "Authorization: Bearer md_..." \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "gentle push in with parallax",
    "image": "data:image/png;base64,..."
  }'

Enhance

POST /v1/enhance

Upscale an image to 2× resolution.

Response:

{
  "success": true,
  "image": "data:image/png;base64,..."
}

curl -X POST https://moondraft.ai/v1/enhance \
  -H "Authorization: Bearer md_..." \
  -H "Content-Type: application/json" \
  -d '{ "image": "data:image/png;base64,..." }'

Prompt Refinement

POST /v1/prompt/refine

Automatically rewrite a short prompt into a longer, more detailed one — adding composition, lighting, and camera detail.

Response:

{
  "refined_prompt": "A pair of white leather sneakers resting on a slab of Calacatta marble, soft directional lighting from upper left, shallow depth of field..."
}

curl -X POST https://moondraft.ai/v1/prompt/refine \
  -H "Authorization: Bearer md_..." \
  -H "Content-Type: application/json" \
  -d '{ "prompt": "sneakers on marble", "mode": "image" }'

Check Balance

GET /v1/credits

Returns your current credit balance.

curl https://moondraft.ai/v1/credits \
  -H "Authorization: Bearer md_..."

Usage History

GET /v1/usage

Returns your last 100 actions with timestamps, types, and credit costs.

curl https://moondraft.ai/v1/usage \
  -H "Authorization: Bearer md_..."

Buy Credits

POST /v1/credits/buy

Purchase a credit pack. Returns a Stripe checkout URL.

Response:

{
  "checkout_url": "https://checkout.stripe.com/..."
}

curl -X POST https://moondraft.ai/v1/credits/buy \
  -H "Authorization: Bearer md_..." \
  -H "Content-Type: application/json" \
  -d '{ "pack": "pack_300" }'

Auto-Reload

Set a threshold and your balance tops up automatically when it drops low, so you are less likely to run out mid-project.

POST /v1/credits/auto-reload

Enable or update auto-reload settings.

curl -X POST https://moondraft.ai/v1/credits/auto-reload \
  -H "Authorization: Bearer md_..." \
  -H "Content-Type: application/json" \
  -d '{ "threshold": 50, "pack": "pack_1000" }'

GET /v1/credits/auto-reload

Check current auto-reload settings.

curl https://moondraft.ai/v1/credits/auto-reload \
  -H "Authorization: Bearer md_..."

DELETE /v1/credits/auto-reload

Disable auto-reload.

curl -X DELETE https://moondraft.ai/v1/credits/auto-reload \
  -H "Authorization: Bearer md_..."

Rate Limits

Per-minute limits per API key. Exceeding these returns 429 Too Many Requests.

Error Handling

All errors return JSON with an error string.

{
  "error": "Insufficient credits"
}

HTTP status codes:

Common errors:

Input Limits

MCP Integration

POST /mcp

Moondraft exposes all generation tools via the Model Context Protocol. This means you can generate images and video directly from Claude Code, Cursor, Windsurf, or any MCP-compatible client.

Add this to your MCP client's config. In Claude Code that's .mcp.json at your project root (Cursor and Windsurf use their own config files — paste the moondraft entry into theirs):

{
  "mcpServers": {
    "moondraft": {
      "type": "http",
      "url": "https://moondraft.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Once configured, your AI coding assistant can generate images, create videos, enhance assets, and manage credits -- all from natural language in your terminal or editor.

# In your terminal, just ask:
"Generate a hero illustration for the landing page and save it to assets/"
"Create 5 onboarding illustrations matching the app's color scheme"
"Animate this product photo with a slow zoom"