Kling Avatar - Modellix

curl --request POST \ --url https://api.modellix.ai/api/v1/kling/kling-avatar \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "image": "https://example.com/avatar.jpg", "audio_id": "audio-abc123" } '

{ "code": 0, "message": "success", "data": { "status": "pending", "task_id": "task-avatar001", "model_id": "model-123", "get_result": { "method": "GET", "url": "https://api.modellix.ai/api/v1/tasks/task-avatar001" } } }

Authorizations

Authorization

string

header

required

API Key authentication. Format: Bearer YOUR_API_KEY.

Body

application/json

Option 1
Option 2

image

string

required

Reference image for digital human avatar. Supports URL or Base64 encoded string. Supported formats: JPG/JPEG/PNG. Maximum file size: 10MB. Minimum resolution: 300x300px. Aspect ratio should be between 1:2.5 and 2.5:1. Do not include Base64 prefix (e.g., 'data:image/png;base64,').

Minimum string length: 1

Example:

"https://example.com/avatar.jpg"

audio_id

string

required

Audio ID generated by TTS API. Mutually exclusive with sound_file - exactly one must be provided. Only supports audio generated within the last 30 days. Audio duration must be between 2-300 seconds.

Minimum string length: 1

Example:

"audio-abc123"

prompt

string

Prompt for defining avatar's actions, emotions, and camera movements (1-2500 characters). Optional.

Required string length: 1 - 2500

Example:

"Speaking with a smile, camera slowly zooms in"

sound_file

string

Audio file URL or Base64 encoded string. Mutually exclusive with audio_id - exactly one must be provided. Supported formats: mp3/wav/m4a/aac. Maximum file size: 5MB. Audio duration must be between 2-300 seconds.

Minimum string length: 1

Example:

"https://example.com/audio.mp3"

mode

enum<string>

default:std

Generation mode: std (standard, cost-effective) or pro (professional, higher quality but longer processing)

Available options:

std,

pro

Example:

"std"

Response

Task submitted successfully

code

integer

required

Response code, 0 indicates success

Example:

0

message

string

required

Response message

Example:

"success"

data

object

required

Detailed data about the submitted asynchronous task.

Show child attributes