Use AiWings in your AI agent

Connect once, then ask Claude, ChatGPT, Cursor or any MCP client for images and videos. Results show up right in the chat.

Updated October 31, 2026

Overview

AiWings adds image and video generation to your AI agent. You describe what you want in plain words, the agent calls AiWings, and the result appears in the conversation. Everything you make is also saved in your library.

  • Images: GPT Image 2.5, 2 and 1.5, Nano Banana, Nano Banana 2 and Pro, Imagen 4 (Fast, standard and Ultra), Seedream 5 Lite, Grok Imagine and Flux Fast.
  • Videos with sound: Seedance 2.0 and 2.5, from text, from an image, or guided by reference images and clips.
  • Edits: change a result, combine your own photos, or animate an image into a video, all in the same chat.

Before you start

You need two things:

  • An AiWings account. Sign in with Google. You can also create it during the connect step.
  • The AiWings server URL. Every agent uses the same one:
Server URLhttps://aiwings.io/api/mcp

Connect your agent

Pick your agent. Every agent uses the same server URL and your AiWings sign-in.

Works on claude.ai, the Claude desktop app and Claude mobile (once added on the web or desktop).

  1. 1

    Open the custom connector window

    The button opens Claude with the window already up. Or go to Settings → Connectors and click Add custom connector.
  2. 2

    Name it AiWings and paste the server URL

    Leave the advanced settings empty, then click Add.
    https://aiwings.io/api/mcp
  3. 3

    Connect and sign in

    Click Connect next to AiWings. A browser window opens: sign in to AiWings and approve access. You're sent back to Claude.
  4. 4

    Turn it on in a chat

    In a new chat, open the tools menu and make sure AiWings is switched on. Then ask for an image or video.
On a Claude Team or Enterprise plan, an owner may need to add the connector for the organization first, in the organization's connector settings. Members then connect it from their own Settings → Connectors.

Check it works

Ask your agent:

What's my AiWings credit balance?

If it answers with your balance, you're connected. If it says it has no such tool, make sure AiWings is switched on for the chat, or reconnect it (see Troubleshooting).

Example prompts

Talk to it the way you'd brief a designer. You rarely need to name models or settings.

A product photo of a ceramic mug on a wooden table, soft morning light.

New image

Make the background blue and add a sprig of mint.

Edits the last image, no re-upload

Do it again with Nano Banana Pro in 4K, 16:9.

Choose model and quality

Animate that: slow push-in, steam rising from the mug.

Image to video

A 5 second vertical video of a barista saying “Your order is ready” with café sounds.

Video with dialogue

Your own files

Three ways to start from your own images or footage:

HowWhen to use it
Upload boxFor files on your device. Ask to upload a reference and an upload box opens in the chat (up to 50 MB per file). For video it has separate slots for first frame, last frame, reference images and reference videos. If the box doesn't show, the agent gives you an upload link that works the same.
Public linksPaste direct links to images, for example the product photos on your shop. The agent uses them as references.
An earlier resultSay “edit that” or “animate that” and the agent reuses the AiWings result without uploading it again.
Imagen 4 (all three) and Flux Fast make images from text only. To edit your photos or use references, pick GPT Image, Nano Banana, Seedream or Grok Imagine (Grok takes one reference image).
Files you attach straight to the chat can't be passed on to AiWings. Instead, ask your agent to open the upload box, for example “Open the AiWings upload widget so I can add my product photos”, then drop your files in there.

Videos

Videos take about 1 to 5 minutes. The agent starts the job and a player in the chat updates until it's ready. You can leave the chat: finished videos are in your library. If a video fails, its credits are refunded automatically.

Seedance 2.0Seedance 2.5
Length4–15s4–30s
Resolutions480p, 720p, 1080p, 4k480p, 720p
Reference imagesup to 9up to 30
Reference videosup to 3up to 10
  • Sound is on by default. Put spoken lines in double quotes in your prompt.
  • First and last frames can't be combined with reference images. Use one or the other.
  • Reference videos guide motion and camera, and use a higher per-second price.

Defaults

Save the model and settings you use most so you don't have to repeat them. Set them on the Defaults page, from the result card in the chat (“Change defaults”), or just tell your agent:

Always use Seedance 2.5 for videos, 720p, 8 seconds.

A one-off request like “this time in 9:16” doesn't change your defaults.

Tools

Your agent picks the right tool from your request. These are listed for reference.

ToolWhat it does
generate_imageGenerate or edit an image and show it in the chat.
generate_videoGenerate a video with sound and play it in the chat.
get_image / get_videoCheck a generation that was still rendering. Failed generations are refunded.
create_reference_uploadOpen an upload box for up to 4 reference images from your device.
create_video_reference_uploadOpen an upload box with slots for first frame, last frame, reference images and reference videos.
get_reference_uploadConfirm which files you uploaded before generating.
list_modelsList image and video models with their credit costs.
get_preferencesShow your saved image and video defaults.
set_generation_defaultsSave your default image model and quality.
set_video_defaultsSave your default video model, resolution, length, aspect ratio and audio.
get_creditsShow your credit balance.

Two internal tools used by the upload box also appear in the list. They aren't meant to be called directly.

Credits and pricing

Images have a fixed price per quality level. Videos are billed per second. Credits per image:

ModelCredits per image
GPT Image 2.5 FlareLow 2 · Medium 6 · High 16 · Xhigh 31 · Max 63
GPT Image 2.5 SunburstLow 2 · Medium 6 · High 16 · Xhigh 31 · Max 63
GPT Image 2Low 2 · Medium 6 · High 16
GPT Image 1.5Low 2 · Medium 7 · High 17
Nano Banana1K 5
Nano Banana 21K 8 · 2K 13 · 4K 19
Nano Banana Pro1K 19 · 2K 19 · 4K 38
Imagen 4 Ultra1K 8 · 2K 8
Imagen 41K 5 · 2K 5
Imagen 4 Fast1K 3
Seedream 5 Lite2K 5 · 3K 5
Grok Imagine1K 3
Flux Fast1K 1

Credits per second of video:

ModelResolutionPer secondWith reference video
Seedance 2.0480p1013
Seedance 2.0720p2328
Seedance 2.01080p5769
Seedance 2.04K125157
Seedance 2.5480p1354
Seedance 2.5720p29121

Plans: Basic $9/month for 1,000 credits; Pro $19/month for 2,000 credits; Scale $39/month for 4,000 credits. Top up anytime (100 credits per $1, from $5) on the billing page. Failed generations are refunded automatically.

Disconnect

Remove AiWings in your agent's connector or plugin settings. To cut off access from our side too, open your dashboard and click Revoke access under Connected apps. You can reconnect anytime.

Your data

Your uploads and results are stored by AiWings and available through your account. Prompts and reference files are only used to make your result. See the Privacy Policy.

Troubleshooting

ProblemFix
The agent says it can't make imagesMake sure AiWings is switched on for the chat (tools menu), or start a new chat after connecting.
It keeps asking me to sign inRemove and add AiWings again, and sign in with the same account.
Not enough creditsTop up or subscribe on the billing page, or ask for a lower quality or shorter video.
The upload box doesn't appearOpen the upload link the agent gives you. It works the same way.
A video is taking longMost finish in 1 to 5 minutes. It appears in your library when done, and is refunded if it fails.

Still stuck? See Support or email Mejed@templyo.io.