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://lemonslice.com/api/v2/generate \
  --header 'accept: application/json' \
  --header 'authorization: Bearer YOUR_API_TOKEN' \
  --header 'content-type: application/json' \
  --data '
{
  "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.
model	string	No	The desired model to use. Available options: 'V2', 'V2.5'. Defaults to 'V2.5'.
resolution	string	No	The desired resolution of the output video. Available options: '320', '512', or '640' for V2; '256' or '512' for V2.5. Defaults to '512'.
crop_head	boolean	No	If true, the video will be cropped to focus on the head region. Defaults to False.
whole_body_mode	boolean	No	[V2.5 model only] If true, the model will only inpaint the head. This is the same as using 'Animate face only' in Studio. Overrides 'crop_head' value. Defaults to False.
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

1920s Radioman	41534e16-2966-4c6b-9670-111411def906
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
Cartoon Kid	PDJZDHevWkwdKwWFKj34
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
Griffin	c99d36f3-5ffd-4253-803a-535c1bc9c306
Indian - Female	BY77WcifAQZkoI7EftFd
Indian - Male	siw1N9V8LmYeEWKyWBxv
Italian - Female	BZc8d1MPTdZkyGbE9Sin
Italian - Male	t3hJ92dgZhDVtsff084B
Ivan the Mighty	pO3rCaEbT3xVc0h3pPoG
Ivy - American female	i4CzbCVWoqvD0P1QJCUL
Julian - British male	7p1Ofvcwsv7UBPoFNcpI
Little Gaming Girl	cccc21e8-5bcf-4ff0-bc7f-be4e40afc544
Maribeth - American female	JEAgwU0JZFGxl2KjC3if
Merchant	50d6beb4-80ea-4802-8387-6c948fe84208
Mia - Raspy American female	rCuVrCHOUMY3OwyJBJym
Neil - British male	FMQtISLdv5RvjpHBgf60
Nigerian - Female	A8rwEcJwudjohY1gjPfa
Old Timey Radioman	236bb1fb-dc41-4a2b-84d6-d22d2a2aaae1
Old Wizard	JoYo65swyP8hH6fVMeTO
Overlord	224126de-034c-429b-9fde-71031fba9a59
Princess	8f091740-3df1-4795-8bd9-dc62d88e5131
Robotic Male	185c2177-de10-4848-9c0a-ae6315ac1493
Romanian - Female	gbLy9ep70G3JW53cTzFC
Rosie - Young girl	LT7npgnEogysurF7U8GR
Sam - American male	ZRwrL4id6j1HPGFkeCzO
Sophia - Female	LtPsVjX1k0Kl4StEMZPK
Sophie	bf0a246a-8642-498a-9950-80c35e9276b5
Southern Accent - Male	sTgjlXyTKe3nwbzzjDAZ
Tex - American male	hKUnzqLzU3P9IVhYHREu
The Oracle	d7862948-75c3-4c7c-ae28-2959fe166f49
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://lemonslice.com/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://lemonslice.com/api/v2/generations?limit=10&offset=10 \
  --header 'authorization: Bearer YOUR_API_TOKEN'