API reference

digital man

POST/kling/v1/videos/avatar/image2video

Body Parametersapplication/json

audio_id* string

Audio ID from preview API. Only last-30-day audio lasting 2–300s. Exactly one of audio_id or sound_file

callback_url* string

Callback URL invoked on task completion

external_task_id* string

Custom external task ID for business-side correlation

image* string

Digital-human reference image. Base64 or reachable URL; .jpg/.jpeg/.png; max 10MB; min side 300px; aspect 1:2.5–2.5:1

mode* string

video generation mode

prompt* string

positive text prompt

sound_file* string

Audio file. Base64 or reachable URL; .mp3/.wav/.m4a/.aac; ≤5MB; duration 2–300s. Exactly one of audio_id or sound_file. Invalid format/size or content issues return errors

Responses

200 application/json

response-200 object

400 Bad request or validation failed application/json

response-400 object

properties

error* object

401 Missing or invalid API Key application/json

response-401 object

Request Body Example

2"audio_id": "825455158141661278",

3"callback_url": "",

4"external_task_id": "",

5"image": "https://h2.inkwai.com/bs2/upload-ylab-stunt/se/ai_portal_queue_mmu_image_upscale_aiweb/3214b798-e1b4-4b00-b7af-72b5b0417420_raw_image_0.jpg",

6"mode": "std",

7"prompt": "",

8"sound_file": ""

Code Sample cURL

1curl -X POST "https://api.digislash.com/kling/v1/videos/avatar/image2video" \

2-H "Authorization: Bearer <API Key>" \

3-H "Content-Type: application/json" \

4-d '{

5"audio_id": "825455158141661278",

6"callback_url": "",

7"external_task_id": "",

8"image": "https://h2.inkwai.com/bs2/upload-ylab-stunt/se/ai_portal_queue_mmu_image_upscale_aiweb/3214b798-e1b4-4b00-b7af-72b5b0417420_raw_image_0.jpg",

9"mode": "std",

10"prompt": "",

11"sound_file": ""

12}'

Response

1▼{

2"code": 0,

3▼"data": {

4"task_id": "task_example_001"

5},

6"message": "success"