API Dashboard
Please log in to view your API dashboard.
API Documentation
Generate video
Generate a video from a single image and audio file (or text input). Image and audio files must be provided via a publicly accessible URL. Maximum video length is 1 hour.
Code Samples
curl --request POST \
--url https://studio.infinity.ai/api/v2/generate \
--header 'accept: application/json' \
--header 'authorization: Bearer YOUR_API_TOKEN' \
--header 'content-type: application/json' \
--data '
{
"resolution": "320",
"crop_head": false,
"expressiveness": 0.5,
"img_url": "https://6ammc3n5zzf5ljnz.public.blob.vercel-storage.com/inf2-defaults/cool_man-AZGi3AIjUGN47rGxA8xdHMBGr1Qqha.png",
"audio_url": "https://6ammc3n5zzf5ljnz.public.blob.vercel-storage.com/cool_man-eUP4h3ET8OHCP2ScZvei5CVnQUx2Mi.mp3"
}
'
Parameters
Name | Type | Required | Description |
---|---|---|---|
img_url | string | Yes | A publicly accessible URL to the input image file. |
audio_url | string | No | A publicly accessible URL to the input audio file. If not provided, user must provide both voice_id AND text. |
voice_id | string | No | Unique identifier to select the desired voice. Refer to table below for available options. |
text | string | No | The desired transcript for the character to speak. |
resolution | string | Yes | The desired resolution of the output video. Available options: '320', '512', '640'. |
crop_head | boolean | Yes | If true, the video will be cropped to focus on the head region. Set to false to use the original aspect ratio and zoom level of your input image. |
expressiveness | float | No | Float ranging from 0 to 1 (inclusive). Higher values result in more emotion / movement. Default value of 1. |
Available Voices for Text-to-Speech
Voice Name / Description | Voice ID | Preview |
---|
Adam - British male | NFG5qt843uXKj4pFvR7C | |
African American - Female | CBHdTdZwkV4jYoCyMV1B | |
African American - Male | gYr8yTP0q4RkX1HnzQfX | |
Alex - Male | LXVY607YcjqxFS3mcult | |
Amelia - British female | ZF6FPAbjXT4488VcRRnw | |
Announcer - British man | NYC9WEgkq1u4jiqBseQ9 | |
Archer - British male | L0Dsvb3SLTyegXwtm47J | |
Ava - American female | ZkXXWlhJO3CtSXof2ujN | |
Brittney - American female | kPzsL2i3teMYv0FxEYQ6 | |
Chinese American - Female | ngiiW8FFLIdMew1cqwSB | |
Chinese American - Male | gAMZphRyrWJnLMDnom6H | |
Cowboy | qNkzaJoHLLdpvgh5tISm | |
Danielle - American female | FVQMzxJGPUBtfz1Azdoy | |
Demon Bartholomeus | L5Oo1OjjHdbIvJDQFgmN | |
Demon Monster | vfaqCOvlrKi4Zp7C2IAm | |
Femme Fetale - Female | eVItLK1UvXctxuaRV2Oq | |
Frederick - British male | j9jfwdrw7BRfcR43Qohk | |
French - Female | txtf1EDouKke753vN8SL | |
French - Male | IHngRooVccHyPqB4uQkG | |
George - British male | JBFqnCBsd6RMkjVDRZzb | |
German - Female | AnvlJBAqSLDzEevYr9Ap | |
Grandpa - American | NOpBlnGInO9m6vDvFkFC | |
Indian - Female | BY77WcifAQZkoI7EftFd | |
Indian - Male | siw1N9V8LmYeEWKyWBxv | |
Italian - Female | BZc8d1MPTdZkyGbE9Sin | |
Italian - Male | t3hJ92dgZhDVtsff084B | |
Ivan the Mighty | pO3rCaEbT3xVc0h3pPoG | |
Ivy - American female | i4CzbCVWoqvD0P1QJCUL | |
Julian - British male | 7p1Ofvcwsv7UBPoFNcpI | |
Kade - Young girl | 0m2tDjDewtOfXrhxqgrJ | |
Maribeth - American female | JEAgwU0JZFGxl2KjC3if | |
Mia - Raspy American female | rCuVrCHOUMY3OwyJBJym | |
Neil - British male | FMQtISLdv5RvjpHBgf60 | |
Nigerian - Female | A8rwEcJwudjohY1gjPfa | |
Old Wizard | JoYo65swyP8hH6fVMeTO | |
Romanian - Female | gbLy9ep70G3JW53cTzFC | |
Rosie - Young girl | LT7npgnEogysurF7U8GR | |
Sam - American male | ZRwrL4id6j1HPGFkeCzO | |
Sophia - Female | LtPsVjX1k0Kl4StEMZPK | |
Southern Accent - Male | sTgjlXyTKe3nwbzzjDAZ | |
Tex - American male | hKUnzqLzU3P9IVhYHREu | |
Toddler | bn5HJAJ1igu4dFplCXkQ | |
Vallerie - Old British female | mLJVsC2pwqCmmrBUAzg6 | |
Villain - Female | flHkNRp1BlvT73UL6gyz | |
Villain - Male | INDKfphIpZiLCUiXae4o | |
Vivian - Australian Female | luVEyhT3CocLZaLBps8v | |
Whispering - Female | nbk2esDn4RRk4cVDdoiE |
Get generation with Job ID
Retrieve the status and video URL for a submitted generate job.
Code Samples
curl --request GET \
--url https://studio.infinity.ai/api/v2/generations/be32c40e-4fb5-4c62-8ba1-bce223e6bf42 \
--header 'authorization: Bearer YOUR_API_TOKEN'
List all video generations
Returns no more than 50 generations per request. Use limit and offset query parameters to paginate over results.
Code Samples
curl --request GET \
--url https://studio.infinity.ai/api/v2/generations?limit=10&offset=10 \
--header 'authorization: Bearer YOUR_API_TOKEN'