Query: Task Results

Digital human task result query API for retrieving the generation status and output information of a specific task.

---

Overview

• Method: GET
• Path: /avatar/task/{task_id}
• Content-Type: application/json
• Category: Video Models (Video) / Digital Human

Authentication

• Header: Authorization: Bearer <token>

---

Path Parameters

Parameter	Type	Required	Description
task_id	string	Yes	Task ID of the generated video

---

Request Example

curl Example

curl -X GET "https://api.gpt.ge/avatar/task/your_task_id" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $YOUR_TOKEN"

JavaScript (fetch) Example

fetch('https://api.gpt.ge/avatar/task/your_task_id', {
  method: 'GET',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer YOUR_TOKEN'
  }
})
  .then(res => res.json())
  .then(console.log)

Python (requests) Example

import requests

resp = requests.get(
    'https://api.gpt.ge/avatar/task/your_task_id',
    headers={
        'Content-Type': 'application/json',
        'Authorization': 'Bearer YOUR_TOKEN'
    }
)
print(resp.json())

---

Response Fields

Field	Type	Description
id	string	Task ID
ext	object	Additional extension information
ext.sing_title	string	Generated audio file name
ext.track_info	string	Track information
ext.animate_channel	string	Animation channel type
singer	string	Singer name
file_type	string	File type
work_name	string	Work name
animate_id	string	Animation ID
play_types	array[string]	List of play types
vip_enable	boolean	VIP resource flag
create_time	integer	Creation timestamp
music_title	string	Music title
template_id	string	Template ID
user_image_url	string	User image URL
work_webp_path	string	Work WebP address
web_work_status	integer	Web work status
work_video_path	string	Video URL
share_magic_text	string	Share caption
example_image_url	array[string]	Example image URLs
picture_path_list	array[string]	List of picture paths
primary_play_type	string	Primary play type
tmp_online_enable	boolean	Temporary online enable flag
webp_aspect_ratio	integer	WebP aspect ratio
animate_params_str	string	Animation parameter string
video_aspect_ratio	integer	Video aspect ratio
wm_work_video_path	string	Watermarked video URL
template_create_time	integer	Template creation timestamp
no_wm_work_video_path	string	Non-watermarked video URL

---

Response Example (200)

{
  "id": "67930a6f8d5ac20007a77b1c",
  "ext": {
    "sing_title": "1737689681056.mp3",
    "track_info": "{}",
    "animate_channel": "dynamic"
  },
  "singer": "DreamFace",
  "file_type": "VIDEO",
  "work_name": "1737689681056.mp3",
  "animate_id": "264c5fb9449e4c31a7ea0f392696431b",
  "play_types": [
    "PT",
    "",
    "ANIMATE"
  ],
  "vip_enable": false,
  "create_time": 1737689710890,
  "music_title": "Talking avatar",
  "template_id": "655b213cccd1db0007e1d977",
  "user_image_url": "",
  "work_webp_path": "https://cdn.gptbest.vip/file/cdn/20250124/zQBRDI6pT3Bcxs5F9iShAWf05jio0F.jpg",
  "web_work_status": 200,
  "work_video_path": "https://cdn.gptbest.vip/file/cdn/20250124/hfulzDLGgiDg3EQsdYZse3em2f3peS.mp4",
  "share_magic_text": "13.4K users shared moments",
  "example_image_url": [
    "config/common/main/bd15932c14584ec2bd39f8fb46da47c7.jpg",
    "config/common/main/9ae535433a14496982017711be5a06ca.png",
    "config/common/main/70d3629c39094b33ac0359f017f1a963.jpg",
    "system/file/fdfs/c785a37a9bd64fe5b7bdefa9054cc8b6.png"
  ],
  "picture_path_list": [],
  "primary_play_type": "ANIMATE",
  "tmp_online_enable": false,
  "webp_aspect_ratio": 1,
  "animate_params_str": "{\"pt_infos\":[{\"context\":null,\"audio_url\":\"server%2Faudio%2Fmain%2F6d4f9a63efb94760866f600117d147bd.mp3\",\"voice_engine_id\":null,\"audio_id\":null,\"video_url\":\"server%2Fcommon%2Fmain%2Fcb599ba5-61f1-4648-bfbb-1e06299da48d.mp4\",\"video_pattern_url\":null,\"lan\":null,\"character_id\":null,\"pag_img_urls\":null,\"video_img_urls\":null}]}"
  ,
  "video_aspect_ratio": 1,
  "wm_work_video_path": "https://cdn.gptbest.vip/file/cdn/20250124/hfulzDLGgiDg3EQsdYZse3em2f3peS.mp4",
  "template_create_time": 1700471100257,
  "no_wm_work_video_path": "https://cdn.gptbest.vip/file/cdn/20250124/hfulzDLGgiDg3EQsdYZse3em2f3peS.mp4"
}