Topview-api

query task

Developing

GET

/v1/video_avatar/task/query

Request

Query Params

taskId

string

required

任务id。
task id.

needCloudFrontUrl

boolean

optional

是否需要返回CloudFront的url，true-返回cf的url；false-会返回s3的url

Whether to return a CloudFront URL: true - returns the CloudFront URL; false - will return the S3 URL

Header Params

Topview-Uid

string

required

Authorization

string

required

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET 'https://api.topview.ai/v1/video_avatar/task/query?taskId&needCloudFrontUrl' \
--header 'Topview-Uid;' \
--header 'Authorization;'

Responses

🟢200OK

application/json

Body

code

string

required

message

string

required

result

object

required

taskId

string

required

status

string

required

任务状态 init/running/success/fail

errorMsg

string

required

inputVideoFileId

string

required

输入的视频文件id

inputAudioFileId

string

required

输入音频文件id

outputVideoUrl

string

required

输出的视频文件url

Example

{
    "code": "string",
    "message": "string",
    "result": {
        "taskId": "string",
        "status": "string",
        "errorMsg": "string",
        "inputVideoFileId": "string",
        "inputAudioFileId": "string",
        "outputVideoUrl": "string"
    }
}

Modified at 2025-04-30 11:15:29

submit task

Product Avatar API Usage