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:
https://aiwings.io/api/mcpConnect 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
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
Name it AiWings and paste the server URL
Leave the advanced settings empty, then click Add.https://aiwings.io/api/mcp - 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
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.
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 imageMake the background blue and add a sprig of mint.
Edits the last image, no re-uploadDo it again with Nano Banana Pro in 4K, 16:9.
Choose model and qualityAnimate that: slow push-in, steam rising from the mug.
Image to videoA 5 second vertical video of a barista saying “Your order is ready” with café sounds.
Video with dialogueYour own files
Three ways to start from your own images or footage:
| How | When to use it |
|---|---|
| Upload box | For 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 links | Paste direct links to images, for example the product photos on your shop. The agent uses them as references. |
| An earlier result | Say “edit that” or “animate that” and the agent reuses the AiWings result without uploading it again. |
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.0 | Seedance 2.5 | |
|---|---|---|
| Length | 4–15s | 4–30s |
| Resolutions | 480p, 720p, 1080p, 4k | 480p, 720p |
| Reference images | up to 9 | up to 30 |
| Reference videos | up to 3 | up 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.
| Tool | What it does |
|---|---|
generate_image | Generate or edit an image and show it in the chat. |
generate_video | Generate a video with sound and play it in the chat. |
get_image / get_video | Check a generation that was still rendering. Failed generations are refunded. |
create_reference_upload | Open an upload box for up to 4 reference images from your device. |
create_video_reference_upload | Open an upload box with slots for first frame, last frame, reference images and reference videos. |
get_reference_upload | Confirm which files you uploaded before generating. |
list_models | List image and video models with their credit costs. |
get_preferences | Show your saved image and video defaults. |
set_generation_defaults | Save your default image model and quality. |
set_video_defaults | Save your default video model, resolution, length, aspect ratio and audio. |
get_credits | Show 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:
| Model | Credits per image |
|---|---|
| GPT Image 2.5 Flare | Low 2 · Medium 6 · High 16 · Xhigh 31 · Max 63 |
| GPT Image 2.5 Sunburst | Low 2 · Medium 6 · High 16 · Xhigh 31 · Max 63 |
| GPT Image 2 | Low 2 · Medium 6 · High 16 |
| GPT Image 1.5 | Low 2 · Medium 7 · High 17 |
| Nano Banana | 1K 5 |
| Nano Banana 2 | 1K 8 · 2K 13 · 4K 19 |
| Nano Banana Pro | 1K 19 · 2K 19 · 4K 38 |
| Imagen 4 Ultra | 1K 8 · 2K 8 |
| Imagen 4 | 1K 5 · 2K 5 |
| Imagen 4 Fast | 1K 3 |
| Seedream 5 Lite | 2K 5 · 3K 5 |
| Grok Imagine | 1K 3 |
| Flux Fast | 1K 1 |
Credits per second of video:
| Model | Resolution | Per second | With reference video |
|---|---|---|---|
| Seedance 2.0 | 480p | 10 | 13 |
| Seedance 2.0 | 720p | 23 | 28 |
| Seedance 2.0 | 1080p | 57 | 69 |
| Seedance 2.0 | 4K | 125 | 157 |
| Seedance 2.5 | 480p | 13 | 54 |
| Seedance 2.5 | 720p | 29 | 121 |
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
| Problem | Fix |
|---|---|
| The agent says it can't make images | Make sure AiWings is switched on for the chat (tools menu), or start a new chat after connecting. |
| It keeps asking me to sign in | Remove and add AiWings again, and sign in with the same account. |
| Not enough credits | Top up or subscribe on the billing page, or ask for a lower quality or shorter video. |
| The upload box doesn't appear | Open the upload link the agent gives you. It works the same way. |
| A video is taking long | Most 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.