Need to turn images into videos in your own app, script or automation? This guide shows how to do it with the AiWings API, step by step. Give a model your image as the first frame, optionally a second image as the last frame, and describe the motion. One key covers five video models with sound, billed per second, and every finished video comes back as a permanent MP4 link.
What you need
- An AiWings account. Sign in with Google; new accounts get 10 free credits, enough for a 5-second MiniMax H3 Lite video at 480p.
- An AiWings API key, which you create in the next step.
- Somewhere to run code on a server: a script, a backend route, a serverless function or an automation tool that can send HTTP requests. Keys don’t work from browser or mobile app code, where anyone could read them.
Step 1: Create an API key
- 1Sign in to AiWings and open the API page in your dashboard.
- 2Click Create key, give it a name (for example “my-app production”) and, if you like, a monthly credit limit.
- 3Copy the key. It starts with aiw_live_ and is shown only once.
- 4Save it as an environment variable on the machine or service that will call the API.
export AIWINGS_API_KEY="aiw_live_your_key_here"The API uses the same credits as AiWings in ChatGPT, Claude and the dashboard, so there’s no separate plan to buy. Every request sends the key in the Authorization header as a Bearer token.
Step 2: Choose a video model
Every model here can start a video from your image and end it on a second one. They differ in how many extra references they take, and in price:
| Model | model value | Start and end image | Reference images | Reference videos | 5 seconds from |
|---|---|---|---|---|---|
| Seedance 2.0 | seedance-2.0 | Yes | Up to 9 | Up to 3 | 50 credits ($0.50) at 480p |
| Seedance 2.5 | seedance-2.5 | Yes | Up to 30 | Up to 10 | 65 credits ($0.65) at 480p |
| MiniMax H3 | minimax-h3 | Yes | Up to 9 | No | 50 credits ($0.50) at 768p |
| MiniMax H3 Highspeed | minimax-h3-highspeed | Yes | Up to 9 | No | 20 credits ($0.20) at 768p |
| MiniMax H3 Lite | minimax-h3-lite | Yes | Up to 9 | No | 10 credits ($0.10) at 480p |
Prices are at the top-up rate of $0.01 per credit, and plans include more credits per dollar. Each finished job reports exactly what it cost in its credits field, and GET /v1/models lists every price.
Step 3: Animate your first image
Pass a public image URL as first_frame and describe only the motion; the image already sets the look. Seedance 2.5 keeps the shape of your image, so you don’t need aspect_ratio. This 5-second clip at 720p costs 145 credits ($1.45):
1# 1. Start the job2curl https://aiwings.io/api/v1/videos \3-H "Authorization: Bearer $AIWINGS_API_KEY" \4-H "Content-Type: application/json" \5-d '{6"prompt": "The rocket lifts off slowly, smoke billowing across the launch pad, stars twinkling above",7"model": "seedance-2.5",8"resolution": "720p",9"duration": 5,10"first_frame": "https://example.com/rocket-poster.jpg"11}'1213# 2. Check it until status is "succeeded" (or "failed")14curl "https://aiwings.io/api/v1/videos/VIDEO_ID?wait=30" \15-H "Authorization: Bearer $AIWINGS_API_KEY"
Creating a video returns right away with an id and status "processing". Videos usually take one to a few minutes, so you check back with GET /v1/videos/{id}. Adding ?wait=30 holds each check open for up to 30 seconds and returns the moment the video is ready, so the loop above makes only a handful of requests.
When status is "succeeded", output.url is a permanent link to the MP4. If a video fails, status is "failed", error.message says why, and the credits are refunded automatically. Every video you make through the API also shows up in your AiWings library.
Step 4: Go from one image to another
Add last_frame and the model moves from the first picture to the second, which is great for reveals and before-and-after shots, like a sketch turning into the finished product:
1# 1. Start the job2curl https://aiwings.io/api/v1/videos \3-H "Authorization: Bearer $AIWINGS_API_KEY" \4-H "Content-Type: application/json" \5-d '{6"prompt": "The pen sketch fills in with color and texture and becomes the finished studio product shot, slow push-in",7"model": "minimax-h3",8"resolution": "768p",9"duration": 6,10"first_frame": "https://example.com/sneaker-sketch.jpg",11"last_frame": "https://example.com/sneaker-photo.jpg"12}'1314# 2. Check it until status is "succeeded" (or "failed")15curl "https://aiwings.io/api/v1/videos/VIDEO_ID?wait=30" \16-H "Authorization: Bearer $AIWINGS_API_KEY"
Start and end frames can’t be combined with reference images in the same request. If you want a model to match a look rather than start from an exact picture, send reference_images instead and describe the scene.
Step 5: Animate an image you made with AiWings
If the image came from the AiWings API, skip the URL and pass its id as source_generation_id. It becomes the first frame. This uses MiniMax H3 Lite at 480p, the lowest-cost option:
1# 1. Start the job2curl https://aiwings.io/api/v1/videos \3-H "Authorization: Bearer $AIWINGS_API_KEY" \4-H "Content-Type: application/json" \5-d '{6"prompt": "Gentle steam rises from the cup and the morning light shifts slowly across the table",7"model": "minimax-h3-lite",8"resolution": "480p",9"duration": 5,10"source_generation_id": "8f1c2a4e-5b7d-4e2f-9a31-0c6d8e7f1b22"11}'1213# 2. Check it until status is "succeeded" (or "failed")14curl "https://aiwings.io/api/v1/videos/VIDEO_ID?wait=30" \15-H "Authorization: Bearer $AIWINGS_API_KEY"
With a first frame, every MiniMax version and Seedance 2.5 take the shape of your image, so you can leave aspect_ratio out. On Seedance 2.0, set aspect_ratio to "adaptive" to do the same.
See it in action
Real, unedited results. Each original image is on the left, and the video Seedance 2.5 made from it is on the right. Seedance adds sound too; it is muted here.


More models with the same key
Your key isn’t limited to one model. The same key, balance and request format cover every video and image model on AiWings. To switch, change the model field: video models go to POST /v1/videos and image models to POST /v1/images.
| Model | model value | Endpoint | From |
|---|---|---|---|
| Seedance 2.0 | seedance-2.0 | /v1/videos | 50 credits ($0.50) for 5 seconds at 480p |
| Seedance 2.5 | seedance-2.5 | /v1/videos | 65 credits ($0.65) for 5 seconds at 480p |
| MiniMax H3 | minimax-h3 | /v1/videos | 50 credits ($0.50) for 5 seconds at 768p |
| MiniMax H3 Highspeed | minimax-h3-highspeed | /v1/videos | 20 credits ($0.20) for 5 seconds at 768p |
| MiniMax H3 Lite | minimax-h3-lite | /v1/videos | 10 credits ($0.10) for 5 seconds at 480p |
| GPT Image 2.6 Flare | gpt-image-2.6-flare | /v1/images | 7 credits ($0.07) per image |
| GPT Image 2.6 Sunburst | gpt-image-2.6-sunburst | /v1/images | 7 credits ($0.07) per image |
| GPT Image 2.5 Flare | gpt-image-2.5-flare | /v1/images | 2 credits ($0.02) per image |
| GPT Image 2.5 Sunburst | gpt-image-2.5-sunburst | /v1/images | 2 credits ($0.02) per image |
| GPT Image 2 | gpt-image-2 | /v1/images | 2 credits ($0.02) per image |
| GPT Image 1.5 | gpt-image-1.5 | /v1/images | 2 credits ($0.02) per image |
| Nano Banana | nano-banana | /v1/images | 5 credits ($0.05) per image |
| Nano Banana 2 | nano-banana-2 | /v1/images | 8 credits ($0.08) per image |
| Nano Banana Pro | nano-banana-pro | /v1/images | 19 credits ($0.19) per image |
| Seedream 5 Lite | seedream-5-lite | /v1/images | 5 credits ($0.05) per image |
| Grok Imagine | grok-imagine | /v1/images | 3 credits ($0.03) per image |
| Flux Fast | flux-fast | /v1/images | 1 credit ($0.01) per image |
GET /v1/models returns the same list with every price, size and option, so your code can check what’s available instead of hard-coding it.
Things to know
- Describe motion, not the picture. The image already sets the subject, colors and style, so a short line about movement and camera gives the cleanest result.
- Images must be public URLs. To use a file from your computer, upload it first with POST /v1/uploads and pass the url it returns.
- Only Seedance can also follow a reference video, a clip to copy the camera move from, at a higher per-second rate.
- Send an Idempotency-Key header with each new job (the JavaScript and Python examples do). If a request times out and you retry with the same key, you get the same job back instead of paying twice.
- Each key has its own rate limit, and you can give each key a monthly credit cap so a bug in one app can’t spend your whole balance.
- Output URLs are public but unguessable, like a share link. Download the file to your own storage if you need to control who can see it.
If something goes wrong
- 401 authentication_failed: the key is missing, mistyped or revoked. Check the Authorization header reads Bearer followed by your key.
- 400 invalid_request: a field isn’t allowed for that model, for example a resolution or length it doesn’t support. The error’s param names the field to fix.
- 402 insufficient_credits: your balance can’t cover the video. Top up in the dashboard and send the request again.
- 403 spend_limit_reached: this key hit its monthly credit limit. Raise or remove the limit on the API page.
- 429 rate_limited or too_many_jobs: you’re sending too fast or have too many jobs rendering at once. Wait for the Retry-After time, or for a video to finish.
- The video failed with a content error: the prompt or image was blocked by the model’s safety filter. Reword it; the credits were already refunded.
Bottom line
One AiWings key gives your code five image-to-video models with sound, with start and end frames, reference images and reference videos, billed per second from one balance, with permanent links and automatic refunds on failures. The same key can make the starting image too.
FAQ
What’s the cheapest way to animate an image?
MiniMax H3 Lite at 480p: a 5-second clip is 10 credits ($0.10).
Will the video keep the shape of my image?
Yes. Every MiniMax version and Seedance 2.5 match the image automatically. On Seedance 2.0, set aspect_ratio to "adaptive".
Can I give it an end image too?
Yes. Pass last_frame along with first_frame, and the video moves from one to the other.
Do the videos have sound?
Yes, every model adds sound. Seedance can turn it off with "audio": false; MiniMax always includes it.
