KreadoAI—API V3.0

API Support Documentation

1. Quick Start Guide

Welcome to the KreadoAI API Documentation! 🙌KreadoAI's API empowers you to programmatically create digital avatar videos and seamlessly integrate KreadoAI's advanced AI capabilities into your applications. Unlock the full potential of KreadoAI to bring creativity and efficiency to your projects.This guide will help you get started quickly, covering everything from authentication methods and API structures to detailed interface descriptions and usage examples. Let’s explore the possibilities together! 🚀

1.1 Create an Account

Sign up for a KreadoAI account. Once your account is created, upgrade to the Pro membership to unlock the powerful AI features that allow you to create professional-grade digital avatar videos.

1.2 Access your API key

After logging into your KreadoAI account, navigate to Account Overview -> API Settings to retrieve your API key.

1.3 Additional Notes

• Our services are hosted in a Singapore-based data center. Users in China may experience slower network speeds.

• During service upgrades, requests may fail. Please implement retry strategies to handle such cases effectively.

• Manage concurrent requests carefully. If rate-limiting is triggered, avoid continuous retries, as this will only prolong the cooldown period.

2. Authentication

To access KreadoAI's API and perform operations, you must authenticate and authorize your requests using HTTP headers. Here's an example:

curl --request GET \
  --url "https://api.kreadoai.com/apis/open/user/v3/getInfo" \
  --header "apiToken: 61FDB6A8A14FE77EE2DF893058572EE3" \
  --header "Content-Type: application/json"

3. Digital Avatars

3.1 Retrieve Digital Avatar List

Use Case

This endpoint allows you to fetch a list of digital avatars, including realistic avatars, talking photo avatars, and cloned avatars.

Important Notes

This is a paginated endpoint. Please fetch the required avatars accordingly.Request Rate Limit: Supports up to 30 concurrent queries per second. Exceeding this limit will trigger rate-limiting policies.Usage Restrictions: Requests will fail if the membership expires.

Request Details

Request URL	https://api.kreadoai.com/apis/open/avatar/v3/list
Request Method	post

Request Parameters

Header

Parameter Name	Required	Example Value
Content-Type	YES	application/json
apiToken	YES	61FDB6A8A14FE77EE2DF893058572EE3

Body

Parameter Name	Type	Required	Description
cloneDigitalHuman	Integer	YES	Query Digital Human Clone List: 0 - Do not query, 1 - Query
supportTypeId	Integer	YES	Digital Human Type: 100 - Photo, 101 - Video
digitalHumanId	Integer	NO	Digital Human ID
tagIds	List<Integer>	NO	Gender Tags： 211: Female 210: Male Style Tags： 137: Realistic 138: Featured 139: Premium
areaTypeIds	List<Integer>	NO	Digital Human Region Tag: 141: Western 140: Asian 142: Japanese/Korean 143: Southeast Asian 145: Indian 144: Middle Eastern 146: African
pageIndex	Integer	YES	Page Number
pageSize	Integer	YES	Data Per Page

Response Parameters

Parameter Name	Type	Description
digitalHumanId	Integer	Digital Human ID
supportTypeId	Integer	Digital Human Type: 100 - Photo, 101 - Video
digitalHumanThumbnailUrl	String	Thumbnail Avatar
digitalHumanPhotoUrl	String	Full-Body Image
digitalHumanPreviewVideoUrl	String	Preview Video

Example

Request Example

curl --location 'https://api.kreadoai.com/apis/open/avatar/v3/list' \
--header 'apiToken: 61FDB6A8A14FE77EE2DF893058572EE3' \
--header 'Content-Type: application/json' \
--data '{
    "cloneDigitalHuman": 0,
    "supportTypeId": 100,
    "digitalHumanId": null,
    "tagIds": null,
    "areaTypeIds": null,
    "pageIndex": 1,
    "pageSize": 1
}'

Response Example

{
    "code": "200",
    "message": "Success",
    "data": {
        "pageIndex": 1,
        "pageSize": 1,
        "totalCount": 68,
        "totalPages": 68,
        "data": [
            {
                "digitalHumanId": 4192,
                "supportTypeId": 100,
                "digitalHumanThumbnailUrl": "https://aigc-cdn.kreadoai.com/digitalhuman/talking_photo/results/face_detection/2024/11/19/3f4dd450a63e11efa60f0242ac110005_cover.jpg",
                "digitalHumanPhotoUrl": "https://aigc-cdn.kreadoai.com/digitalhuman/api/image/2024/11/eace2a4536ab41bd85a7fb728211862e.png",
                "digitalHumanPreviewVideoUrl": "https://aigc-cdn.kreadoai.com/digitalhuman/api/image/2024/11/eace2a4536ab41bd85a7fb728211862e.png"
            }
        ]
    },
    "requestId": "1862015410570563585"
}

3.2 Upload Custom Photo

Use Case

Allows users to upload any photo that meets the requirements. Once the photo passes facial verification, it can be used for digital avatar video generation.

Notes

• Usage Restrictions

  • Suggested front view of the character, as shown on the left

  • Clear character avatar, does not support multiple people

  • The face is unobstructed and the mouth is closed

  • It is recommended to use a half-length figure

  • The maximum image size you can upload is 10MB

  • I have agreed to the "User Terms of Service"

• Request Frequency: Supports a maximum of 30 concurrent uploads per second. Exceeding this limit will trigger rate-limiting policies.

Request Details

Request URL	https://api.kreadoai.com/apis/open/avatar/v3/uploadAvatar
Request Method	post

Request Parameters

Header

Parameter Name	Required	Example Value
Content-Type	YES	application/json
apiToken	YES	61F3336A8A14FE77EE2DF893058572666

Body

Parameter Name	Type	Required	Description
fileUrl	String	YES	Any publicly accessible image URL that meets the following requirements: Supported Formats: jpg, jpeg, png, webp Restrictions: Special characters, such as Chinese or other non-standard symbols, are not allowed in the URL.

Response Parameters

Parameter Name	Type	Description
jobId	Long	Upload photo task ID

Example

Request Example

curl --location 'https://api.kreadoai.com/apis/open/avatar/v3/uploadAvatar' \
--header 'apiToken: 61FDB6A8A14FE77EE2DF893058572EE3' \
--header 'Content-Type: application/json' \
--data '{
    "fileUrl": "https://cdn.pixabay.com/video/2021/06/24/78732-567321517_medium.jpg"
}'

Response Example

{
    "code": "200",
    "message": "Success",
    "data": {
        "jobId": 1862021310686838786
    },
    "requestId": "1862021310636507138"
}

3.3 Query Photo Upload Results

Use Case

This is used to check whether the uploaded photo passes the facial verification and, if successful, returns the digital avatar image information.

Notes

• Request Frequency: A maximum of 60 concurrent queries per second are supported. Exceeding this will trigger rate-limiting policies.

Request Details

Request URL	https://api.kreadoai.com/apis/open/avatar/v3/getUploadCustomAvatar
Request Method	post

Request Parameters

Header

Parameter Name	Required	Example Value
Content-Type	YES	application/json
apiToken	YES	61F3336A8A14FE77EE2DF893058572666

Body

Parameter Name	Type	Required	Description
jobId	Long	YES	Task ID returned after uploading the photo

Response Parameters

Parameter Name	Type	Nested Key	Type	Description
status	Integer			Status: 1 - Waiting for execution 2 - In progress 3 - Success 4 - Failure 5 - Timeout
digitalHuman	Object	digitalHumanId	Integer	Digital Human Image ID
		supportTypeId	Integer	Digital Human Type: 100 - Photo 101 - Video
		digitalHumanThumbnailUrl	String	Thumbnail Avatar
		digitalHumanPhotoUrl	String	Full-body Image of Digital Human
		digitalHumanPreviewVideoUrl	String	Digital Human Preview Video

Example

Request Example

curl --location 'https://api.kreadoai.com/apis/open/avatar/v3/getUploadCustomAvatar' \
--header 'apiToken: 61FDB6A8A14FE77EE2DF893058572EE3' \
--header 'Content-Type: application/json' \
--data '{
    "jobId": "1862021310686838786"
}'

Response Example

{
    "code": "200",
    "message": "Success",
    "data": {
        "status": 2,
        "digitalHuman": {
            "digitalHumanId": 4194,
            "supportTypeId": 100,
            "digitalHumanThumbnailUrl": "https://aigc-cdn.kreadoai.com/digitalhuman/talking_photo/results/face_detection/2024/11/28/531a2d1aad5211ef90a682df5622d5f4_cover.jpg",
            "digitalHumanPhotoUrl": "https://aigc-cdn.kreadoai.com/digitalhuman/api/image/2024/11/bfbc98da93404b2e8e07d7ed3ed8239e.jpg",
            "digitalHumanPreviewVideoUrl": "https://aigc-cdn.kreadoai.com/digitalhuman/api/image/2024/11/bfbc98da93404b2e8e07d7ed3ed8239e.jpg"
        }
    },
    "requestId": "1862022547222183937"
}

4. Digital Avatar Video Generation

4.1 Submit General Video Generation Task

Use Case

This is used for generating any video that meets the required criteria.

Notes

• Usage Restrictions

  • Videos must be in mp4 or mov format and use h264 encoding.

  • Videos cannot exceed 300MB in size.

  • Audio is supported, with durations ranging from 1 to 600 seconds, in mp3, wav, or m4a format.

  • Requests will fail after the membership expires.

• Request Frequency

  • A maximum of one concurrent video task submission is allowed per second. Exceeding this will trigger rate-limiting policies.

  • The server allows a maximum of 8 queued tasks. Submissions exceeding this limit will fail.

Request Details

Request URL	https://api.kreadoai.com/apis/open/video/v3/submitLipTask
Request Method	post

Request Parameters

Header

Parameter Name	Required	Example Value
Content-Type	YES	application/json
apiToken	YES	61F3336A8A14FE77EE2DF893058572666

Body

Parameter Name	Type	Required	Description
taskName	String	YES	Task Name
videoUrl	String	YES	Video file URL (Special characters like Chinese or other non-standard characters are not allowed).
audioUrl	String	YES	Audio file URL (Special characters like Chinese or other non-standard characters are not allowed).

Response Parameters

Parameter Name	Type	Description
jobId	Long	Task ID

Example

Request Example

curl --location 'https://api.kreadoai.com/apis/open/video/v3/submitLipTask' \
--header 'apiToken: 61FDB6A8A14FE77EE2DF893058572EE3' \
--header 'Content-Type: application/json' \
--data '{
    "taskName": "test",
    "videoUrl": "https://aigc-cdn.kreadoai.com/digitalhuman/upload_simple_clone_video/2024/11/ea634216760c4d87a0709a7d00eddc9e.mp4",
    "audioUrl": "https://aigc-cdn.kreadoai.com/digitalhuman/audio/2024/11/2b150387595c4efba35db553740cb47a.mp3"
}'

Response Example

{
    "code": "200",
    "message": "Success",
    "data": {
        "jobId": 1861664658419253250
    },
    "requestId": "1861664651620286466"
}

4.2 Submit Digital Human Video Generation Task

Use Case

This is applicable for video synthesis of real digital avatars, photo avatars, and cloned avatars within the KreadoAI system.

Notes

• Usage Restrictions

  • Audio is supported, with durations ranging from 1 to 600 seconds, in mp3, wav, or m4a format.

  • Requests will fail after the membership expires.

• Request Frequency

  • A maximum of one concurrent video task submission is allowed per second. Exceeding this will trigger rate-limiting policies.

  • The server allows a maximum of 8 queued tasks. Submissions exceeding this limit will fail.

Request Details

Request URL	https://api.kreadoai.com/apis/open/video/v3/submitSystemLipTask
Request Method	post

Request Parameters

Header

Parameter Name	Required	Example Value
Content-Type	YES	application/json
apiToken	YES	61F3336A8A14FE77EE2DF893058572666

Body

Parameter Name	Type	Nested Key	Type	Required	Description
taskName	String			YES	Status: 1 - Waiting for execution 2 - In progress 3 - Success 4 - Failure 5 - Timeout
videoRatio	Integer			YES	Video Aspect Ratio: 1 - Represents 16:9 aspect ratio 2 - Represents 9:16 aspect ratio
audio	Object	audioUrl	String	YES	Audio File URL (Special characters like Chinese or other non-standard characters are not allowed)
digitalHuman	Object	digitalHumanId	Integer	YES	Digital Human Image ID
		mask	Integer	NO	Mask Type: 0 - No mask 1 - Circular mask 2 - Rectangular mask (This field currently only applies to photo digital humans)
		x	Integer	NO	Digital Human Position X-axis Coordinate
		y	Integer	NO	Digital Human Position Y-axis Coordinate
background	Object	type	Integer	NO	Background Type:302 - Color background
		color	String	NO	Background Color:When type=302, this field is required. For example, green screen: rgb (0, 255, 0)

Response Parameters

Parameter Name	Type	Description
jobId	Long	Task ID

示例

Request Example

curl --location 'https://api.kreadoai.com/apis/open/video/v3/submitSystemLipTask' \
--header 'apiToken: 61FDB6A8A14FE77EE2DF893058572EE3' \
--header 'Content-Type: application/json' \
--data '{
    "taskName": "1-API测试-9",
    "videoRatio":2,
    "digitalHuman":{
        "digitalHumanId":9
    },
    "audio":{
        "audioUrl": "https://aigc-cdn.kreadoai.com/digitalhuman/audio/2024/11/2b150387595c4efba35db553740cb47a.mp3"
    }
    
}'

Response Example

{
    "code": "200",
    "message": "Success",
    "data": {
        "jobId": 1863824392856674305
    },
    "requestId": "1863824382987476993"
}

4.3 Query Video Task Generation Results

Use Case

This is used to query the results of video generation tasks.

Notes

• Usage Restrictions: Requests will fail after the membership expires.

• Request Frequency: A maximum of 60 concurrent queries per second are supported. Exceeding this will trigger rate-limiting policies.

Request Details

Request URL	https://api.kreadoai.com/apis/open/video/v3/getLipVideoResult
Request Method	post

Request Parameters

Header

Parameter Name	Required	Example Value
Content-Type	YES	application/json
apiToken	YES	61F3336A8A14FE77EE2DF893058572666

Body

Parameter Name	Type	Required	Description
jobId	String	YES	Task ID

Response Parameters

Parameter Name	Type	Nested Key	Type	Description
status	Integer			Status: 1 - Waiting for execution 2 - In progress 3 - Success 4 - Failure 5 - Timeout
videoTask	Object	taskId	Integer	Video ID
videoUrl	String	Video File URL

Example

Request Example

curl --location 'https://api.kreadoai.com/apis/open/video/v3/getLipVideoResult' \
--header 'apiToken: 61FDB6A8A14FE77EE2DF893058572EE3' \
--header 'Content-Type: application/json' \
--data '{
    "jobId": 1861664658419253250
}'

Response Example

{
    "code": "200",
    "message": "Success",
    "data": {
        "status": 3,
        "videoTask": {
            "taskId": 122164,
            "videoUrl": "https://aigc-cdn.kreadoai.com/digitalhuman/api/video/2024/11/e2e4a41b0fac4f0d99468d582ee3f850.mp4"
        }
    },
    "requestId": "1862378739852275713"
}

4.4 Get Video List

Use Case

This is used for paginated querying of the video list.

Notes

• Usage Restrictions: Requests will fail after the membership expires.

• Request Frequency: A maximum of 60 concurrent queries per second are supported. Exceeding this will trigger rate-limiting policies.

Request Details

Request URL	https://api.kreadoai.com/apis/open/video/v3/list
Request Method	post

Request Parameters

Header

Parameter Name	Required	Example Value
Content-Type	YES	application/json
apiToken	YES	61F3336A8A14FE77EE2DF893058572666

Body

Parameter Name	Type	Required	Description
status	Integer	NO	Video Status: 1 - Waiting for execution 2 - In progress 3 - Success 4 - Failure 5 - Timeout
pageIndex	Integer	YES	Page Number
pageSize	Integer	YES	Data per Page

Response Parameters

Parameter Name	Type	Description
taskId	Integer	Video ID
taskName	String	Video Name
status	Integer	Status: 1 - Waiting for execution 2 - In progress 3 - Success 4 - Failure 5 - Timeout
supportTypeId	Integer	Digital Human Image Type for Video:100 - Photo101 - Video
videoUrl	String	Video File URL
videoThumbnailUrl	String	Video Thumbnail URL
audioUrl	String	Audio File URL
audioDuration	String	Audio File Duration
createTime	String	Video Creation Time
successTime	String	Video Completion Time

Example

Request Example

curl --location 'https://api.kreadoai.com/apis/open/video/v3/list' \
--header 'apiToken: 61FDB6A8A14FE77EE2DF893058572EE3' \
--header 'Content-Type: application/json' \
--data '{
    "pageIndex": 1,
    "pageSize": 1
}'

Response Example

{
    "code": "200",
    "message": "Success",
    "data": {
        "pageIndex": 1,
        "pageSize": 1,
        "totalCount": 58,
        "totalPages": 58,
        "data": [
            {
                "taskName": "test",
                "taskId": 122164,
                "status": 3,
                "supportTypeId": 101,
                "videoUrl": "https://aigc-cdn.kreadoai.com/digitalhuman/api/video/2024/11/e2e4a41b0fac4f0d99468d582ee3f850.mp4",
                "videoThumbnailUrl": "https://aigc-cdn.kreadoai.com/digitalhuman/api/image/2024/11/181efa21c6e94860a964e78b352039bb.png",
                "audioUrl": "https://aigc-cdn.kreadoai.com/digitalhuman/api/audio/2024/11/c02750852051447e8bd7c105ff42c6dd.mp3",
                "audioDuration": "00:00:16",
                "createTime": "2024-11-27 14:53:50",
                "successTime": "2024-11-27 16:12:20"
            }
        ]
    },
    "requestId": "1862404294312996865"
}

4.5 Get Video Details

Use Case

This is used to retrieve detailed information about the video.

Notes

• Usage Restrictions: Requests will fail after the membership expires.

• Request Frequency: A maximum of 60 concurrent queries per second are supported. Exceeding this will trigger rate-limiting policies.

Request Details

Request URL	https://api.kreadoai.com/apis/open/video/v3/detail
Request Method	post

Request Parameters

Header

Parameter Name	Required	Example Value
Content-Type	YES	application/json
apiToken	YES	61F3336A8A14FE77EE2DF893058572666

Body

Parameter Name	Type	Required	Description
taskId	Integer	YES	Video ID

Response Parameters

Parameter Name	Type	Description
taskId	Integer	Video ID
taskName	String	Video Name
status	Integer	Status: 1 - Waiting for execution 2 - In progress 3 - Success 4 - Failure 5 - Timeout
supportTypeId	Integer	Digital Human Image Type for Video:100 - Photo101 - Video
videoUrl	String	Video File URL
videoThumbnailUrl	String	Video Thumbnail URL
audioUrl	String	Audio File URL
audioDuration	String	Audio File Duration
createTime	String	Video Creation Time
successTime	String	Video Completion Time

Example

Request Example

curl --location 'https://api.kreadoai.com/apis/open/video/v3/detail' \
--header 'apiToken: 61FDB6A8A14FE77EE2DF893058572EE3' \
--header 'Content-Type: application/json' \
--data '{
    "taskId": 122164
}'

Response Example

{
    "code": "200",
    "message": "Success",
    "data": {
        "taskName": "test",
        "taskId": 122164,
        "status": 3,
        "supportTypeId": 101,
        "videoUrl": "https://aigc-cdn.kreadoai.com/digitalhuman/api/video/2024/11/e2e4a41b0fac4f0d99468d582ee3f850.mp4",
        "videoThumbnailUrl": "https://aigc-cdn.kreadoai.com/digitalhuman/api/image/2024/11/181efa21c6e94860a964e78b352039bb.png",
        "audioUrl": "https://aigc-cdn.kreadoai.com/digitalhuman/api/audio/2024/11/c02750852051447e8bd7c105ff42c6dd.mp3",
        "audioDuration": "00:00:16",
        "createTime": "2024-11-27 14:53:50",
        "successTime": "2024-11-27 16:12:20"
    },
    "requestId": "1862408212865413122"
}

5. Instant Avatar Clone

5.1 Instant Avatar Clone Upload

Use Case

This is used for uploading cloned image videos.

Notes

• Usage Restrictions

  • Requests will fail after the membership expires.

  • Video orientation: Horizontal or vertical. If the video is rotated, it may affect the result.

  • Supported file formats: mp4, mov.

  • Video duration: 5 seconds to 10 minutes.

  • Resolution: 360p to 3840p. Recommended resolutions are 720p or 1080p.

  • File size: Less than 300MB.

• Request Frequency: A maximum of one concurrent upload is supported per second. Exceeding this will trigger rate-limiting policies.

Request Details

Request URL	https://api.kreadoai.com/apis/open/video/v3/uploadCloneVideo
Request Method	post

Request Parameters

Header

Parameter Name	Required	Example Value
Content-Type	YES	application/json
apiToken	YES	61F3336A8A14FE77EE2DF893058572666

Body

Parameter Name	Type	Required	Description
videoUrl	String	YES	Video File URL

Response Parameters

Parameter Name	Type	Description
jobId	Long	Task ID

Example

Request Example

curl --location 'https://api.kreadoai.com/apis/open/video/v3/uploadCloneVideo' \
--header 'apiToken: 61FDB6A8A14FE77EE2DF893058572EE3' \
--header 'Content-Type: application/json' \
--data '{
    "videoUrl": "https://aigc-cdn.kreadoai.com/digitalhuman/upload_simple_clone_video/2024/12/a3389d0323cb4f948a9d68f71062efeb.mp4"
}'

Response Example

{
    "code": "200",
    "message": "Success",
    "data": {
        "jobId": 1863777383505321985
    },
    "requestId": "1863777382259613697"
}

5.2 Instant Avatar Clone Video Upload Result Query

Use Case

This is used to query the results of the video upload.

Notes

• Usage RestrictionsRequests will fail after the membership expires.

• Request Frequency: A maximum of 60 concurrent queries per second are supported. Exceeding this will trigger rate-limiting policies.

Request Details

Request URL	https://api.kreadoai.com/apis/open/video/v3/getUploadCloneVideoStatus
Request Method	post

Request Parameters

Header

Parameter Name	Required	Example Value
Content-Type	YES	application/json
apiToken	YES	61F3336A8A14FE77EE2DF893058572666

Body

Parameter Name	Type	Required	Description
jobId	String	YES	Task ID

Response Parameters

Parameter Name	Type	Nested Key	Type	Description
status	Integer			Status: 1 - Waiting for execution 2 - In progress 3 - Success 4 - Failure 5 - Timeout
digitalHuman	Object	digitalHumanId	String	Cloned Digital Human ID
digitalHumanThumbnailUrl	String	Cloned Digital Human Image File URL
digitalHumanPhotoUrl	String	Cloned Digital Human Full-body Image File URL
digitalHumanPreviewVideoUrl	String	Cloned Digital Human Preview Video File URL

Example

Request Example

curl --location 'https://api.kreadoai.com/apis/open/video/v3/getUploadCloneVideoStatus' \
--header 'apiToken: 61FDB6A8A14FE77EE2DF893058572EE3' \
--header 'Content-Type: application/json' \
--data '{
    
    "jobId": 1866460383784169473
}'

Response Example

{
    "code": "200",
    "message": "Success",
    "data": {
        "status": 3,
        "digitalHuman": {
            "digitalHumanId": 4315,
            "digitalHumanThumbnailUrl": "https://aigc-cdn.kreadoai.com/digitalhuman/talking_photo/results/face_detection/2024/12/10/c6eeb126b6f211efa60f0242ac110005_cover.jpg",
            "digitalHumanPhotoUrl": "https://aigc-cdn.kreadoai.com/digitalhuman/api/image/2024/12/5e4858e0ed4c44d4af2ddcee1effb5d1.png",
            "digitalHumanPreviewVideoUrl": "https://aigc-cdn.kreadoai.com/digitalhuman/api/video/2024/12/4c61e72a680e424c833e542d6599a706.mp4"
        }
    },
    "requestId": "1866461169344892930"
}

6. Account Information Query

6.1 Membership Expiry Time and K Coin Balance Query

Use Case

This is used for querying membership expiry time and K coin balance information.

Notes

• Usage Restrictions: Requests will fail after the membership expires.

• Request Frequency: A maximum of 60 concurrent queries per second are supported. Exceeding this will trigger rate-limiting policies.

Request Details

Request URL	https://api.kreadoai.com/apis/open/user/v3/getInfo
Request Method	get

Request Parameters

Header

Parameter Name	Required	Example Value
Content-Type	YES	application/json
apiToken	YES	61F3336A8A14FE77EE2DF893058572666

Response Parameters

Parameter Name	Type	Description
balance	String	K-Coin Balance
vipExpireTime	String	Membership Expiration Time

Example

Request Example

curl --request GET \
--url 'https://api.kreadoai.com/apis/open/user/v3/getInfo' \
--header 'apiToken: 61FDB6A8A14FE77EE2DF893058572EE3' \
--header 'Content-Type: application/json' \
--data ''

Response Example

{
    "code": "200",
    "message": "Success",
    "data": {
        "balance": "138744.00",
        "vipExpireTime": "2026-09-04 15:11:51"
    },
    "requestId": "1862062557001207809"

7. Common Status Codes

Status Code	Error Message
200	Success
400	Failed
405	To ensure account security, login has expired. Please log in again
429	Too many requests, please try again later.
10001	Internal system exception.
10002	Request parameter error.
10003	Audio file download failed.
10004	The audio length must be between 1 and 600 seconds.
10005	Video file download failed.
10006	File download failed.
10007	File size is too large.
10008	The file content is illegal.
10009	Data does not exist.
10010	Face check failed.
10011	Processing timeout, please try again later.
10012	User information does not exist.
10013	Failed to generate thumbnail for the video file.
10014	The query condition is not supported.
10015	Client connection terminated.
10016	Order payment failed.
10017	Your balance is insufficient. Please recharge and try again.
10018	Digital Human video download failed.
10019	There are too many tasks queued. Please submit the task later.
10020	Digital human information does not exist.
10021	The query result is empty. Please contact the administrator.
10022	Please upgrade to Pro Membership.
10999	Unknown error.

8. Contact Us

If you need technical support or wish to learn more about the KreadoAI API, feel free to contact our team!

📧 Email: [e-mail]

🌐 Website: www.kreadoai.com

💬 Whatsapp: [phone]

💬 Skype: https://join.skype.com/invite/qLThmI6f1RcK