Skip to main content
POST
Create By Talking Photo
The resources (image, video, voice) generated by our API are valid for 7 days. Please save the relevant resources as soon as possible to prevent expiration.
Experience our talking photo technology in action by exploring our interactive demo on GitHub: AKool Talking Photo Demo.

Important Notes

  • Image Quality: Use high-resolution images with clearly visible faces for better results
  • Audio Format: Standard audio formats (MP3 recommended)
  • Prompt: Use the prompt parameter to control hand gestures for more natural and professional-looking videos
  • Resolution: Choose from 720p, 1080p based on your needs - higher resolution may take longer to process and costs more credits
  • Resource Expiration: Generated videos are valid for 7 days, save them promptly
  • Webhook: Use webhookUrl to receive notifications when video generation is complete
  • Save the _id from the response to check video status using the Get Video Info Result API

Authorizations

x-api-key
string
header
required

Your API Key used for request authorization. If both Authorization and x-api-key have values, Authorization will be used first and x-api-key will be discarded.

Body

application/json
talking_photo_url
string
required

Resource address of the talking picture

Example:

"https://drz0f01yeq1cx.cloudfront.net/1688098804494-e7ca71c3-4266-4ee4-bcbb-ddd1ea490e75-9907.jpg"

audio_url
string
required

Resource address of the talking audio

Example:

"https://drz0f01yeq1cx.cloudfront.net/1710752141387-e7867802-0a92-41d4-b899-9bfb23144929-4946.mp3"

prompt
string

Prompt words for controlling gestures and movements

Example:

"Throughout the entire video, maintain natural and smooth hand movements."

resolution
enum<string>

Output video resolution. Supported values: 720p, 1080p. Default: 720p

Available options:
720p,
1080p
Example:

"720p"

webhookUrl
string

Callback url address based on HTTP request

Example:

""

Response

200 - application/json

Video creation request submitted successfully

code
integer
required

Interface returns business status code (1000: success)

Example:

1000

msg
string
required

Interface returns status information

Example:

"OK"

data
object