Background music for videos and gifts
Describe it.
Get the music.
Instrumental music for greeting videos, memories and product clips. Write a few lines, press make, listen and download.
- Grandparents’ birthday
- Birthday
- Wedding anniversary
- Class reunion
- Tet and holidays
- Product intro
Make music
Three steps: paste your key, describe the music, press make.
Where do I get a key?
A key is a long string of characters. It lets this page make music with your studio account.
Open the video studio
Go to video.ai-agent.io.vn and sign in. Open Developers.
Create a key that may run jobs
Create a key. Choose execute mode and the live environment. A read-only or sandbox key cannot make music.
Copy the key and paste it here
The key is shown once, so copy it right away. Keys expire; make a new one when yours does.
Open DevelopersOnly a workspace admin can create keys. Do not share your key with strangers.
How do I describe music well?
The clearer the description, the closer the music. Six things to remember:
Say what it is for
Mum’s birthday video, a class reunion clip, a food intro. The purpose sets the mood.
Name the instruments
Acoustic guitar, piano, bamboo flute, zither, strings, drums. Two or three is enough.
Describe mood and tempo
Warm, lively, deep, formal. Slow, medium or fast.
Add texture words
Warm, crisp, airy, punchy, lush. These words change the colour of the music.
Describe how it changes
Soft opening, rising in the middle, settling at the end. The music gets a beginning and an end.
No artist or song names
Describe the style instead of a name. Avoid mixing two styles that clash.
Compare two descriptions
Too little
Happy music.
Clear
Instrumental for grandma’s birthday video. Zither and piano, medium-slow tempo, warm and formal. Soft opening, rising in the middle, settling at the end.
Not happy with it? Change a word or two and make it again. Less detail gives more freedom, more detail stays closer to your idea.
These tips follow the prompt-writing guide of the open-source ACE-Step project (MIT licence).
For AI assistants and developers
With the same key, your AI can make music by itself. Every write needs an Idempotency-Key header.
Call the REST API
# 1. Get a quote (free)
curl -X POST https://music.ai-agent.io.vn/v1/media-tasks/quotes \
-H "Authorization: Bearer $RPT_KEY" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{"kind":"music","prompt":"Warm acoustic guitar, gentle and happy","duration_seconds":30}'
# 2. Generate (paid). TASK is the "id" from step 1
curl -X POST https://music.ai-agent.io.vn/v1/media-tasks/$TASK/generate \
-H "Authorization: Bearer $RPT_KEY" \
-H "Idempotency-Key: $(uuidgen)"
# 3. Poll every 2 seconds until "state" is READY
curl https://music.ai-agent.io.vn/v1/media-tasks/$TASK \
-H "Authorization: Bearer $RPT_KEY"
# 4. Download the file
curl -o music.mp3 https://music.ai-agent.io.vn/v1/media-tasks/$TASK/file \
-H "Authorization: Bearer $RPT_KEY"Connect over MCP
https://video.ai-agent.io.vn/api/v1/agent/mcpPoint your AI assistant at the address below and use the key as the Bearer token. Tools to use: get_workspace, quote_media_task, generate_media_task, get_media_task.
- kind: "music" or "sfx". prompt up to 1000 characters. duration_seconds from 10 to 60.
- The key must be in execute mode, live environment.
- States: QUOTED, QUEUED, SUBMITTING, READY, FAILED. Errors come back as {code, message, retryable, request_id}.