Generate images and videos from your AI agent

Connect your client

Replace fa_live_your_key with your own key. Keep the key out of shared files and repositories.

claude mcp add --transport http flyaigh https://www.flyaigh.com/api/mcp \
  --header "Authorization: Bearer fa_live_your_key"

[mcp_servers.flyaigh]
url = "https://www.flyaigh.com/api/mcp"
bearer_token_env_var = "FLYAIGH_API_KEY"

{
  "mcpServers": {
    "flyaigh": {
      "url": "https://www.flyaigh.com/api/mcp",
      "headers": { "Authorization": "Bearer fa_live_your_key" }
    }
  }
}

npx -y mcp-remote https://www.flyaigh.com/api/mcp \
  --header "Authorization: Bearer fa_live_your_key"

Tools

Agents see eight tools. Two of them spend credits; the rest only read.

list_models

Image or video models with their modes, durations, resolutions, aspect ratios, reference limits and an example price.

quote

The exact credits a request would cost, using the same checks and price as the real call. Nothing is charged.

generate_image

Start an image: text to image, or edit and follow your reference images. Spends credits.

generate_video

Start a video from text, a first frame, first and last frames, or reference images, videos and audio. Spends credits.

get_job

Status of a job. When it is done, a download link; failed jobs are refunded automatically.

list_my_generations

Your recent generations, to reuse one as a reference or download it again.

upload_file

Upload your own image, video or audio and get a file id to use as a reference.

get_balance

Credits left, your plan, and what this key spent today and this month.

What to ask

Use FlyAIgh to make a 5-second 9:16 video of a paper boat drifting down a rainy street at night. Show me the price first, then generate it and save the file to ./out.

A good agent calls quote, asks you to confirm, generates with expected_credits and an idempotency_key, then polls get_job until the file is ready.

Pricing and limits

• Same credits as the website for the same model and settings. No API surcharge, and no separate API bill.
• Spending is limited by your credit balance. You can also give a key its own daily cap on the MCP page; by default there is none. What each key spent, day by day, is on the same page.
• If a price changes between quote and generate, nothing is charged and the new price is returned (expected_credits).
• Each key may submit 10 jobs a minute, so a runaway loop stops quickly. Retries with the same idempotency_key within 24 hours never charge twice.
• Uploads: images up to 25 MB, videos up to 200 MB, audio up to 30 MB; inline base64 uploads up to 3 MB. Only your own files and generations can be used as references.
• Failed jobs are refunded automatically. Private originals come back as signed links that expire after one hour.

Questions