---
title: "V1 Generate Singing Photo Maker"
method: POST
path: "/v1/singing/generate"
tags: ["AI-Singing-Photo-Maker"]
---

# V1 Generate Singing Photo Maker

`POST /v1/singing/generate`

Synthesize audio files (songs/human voices) with photos to generate a lip-sync singing video. The system will automatically drive the mouth shapes, expressions and movements of the characters in the pictures based on the audio content, achieving a natural singing effect.

## Headers

- `x-api-key` string

## Request body

- SingingGenerateRequest
  - `audio_url` string, required — URL of the audio file. Supported: MP3/WAV/M4A. Quality: clear voice, minimal noise. Duration must be between 2–30 seconds (business validation will enforce).
  - `image_url` string, required — URL of the photo. Supported: JPG/PNG/JFIF. Recommended: clear, frontal face. Max size 4.7 MB (business validation will enforce).

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/topmediai/apis/topmediai-api-documentation.md) · [All operations](https://skmtc.net/topmediai/apis/topmediai-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/topmediai/topmediai-api-documentation/versions/5d9205965da7/schema)