Douyin Xingtu Get Sign Image
Resolve an encrypted Xingtu image URI to obtain an accessible image URL. Inputs: - uri (required string): Image URI, usually obtained from another Xingtu response. Example: tos-cn-i-0813c000-ce/oMKzDA3A9QGAuebfsDIAwlDoAfCFEEzSEw8FQZ. - durationTS (optional integer): URL validity period in seconds; defaults to 86400 (24 hours). - format (optional string): Image format; defaults to webp. Documented formats include webp, jpg, and png. Returns: A JSON response containing image data with an accessible image URL. The exact fields within the image data are not specified. This tool resolves an existing image URI rather than searching for or generating images.
Pricing
| Condition | Charge |
|---|---|
| Each call | 2.07 credits/call |
2.07 credits/call Charges are per query. A successful query is billed even if it returns no results.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
uri | string | Yes | 图片的uri/Image URI | — |
format | string | No | 图片格式/Image format | webp |
durationTS | integer | No | 有效期时长(秒)/Duration in seconds | 86400 |
Invocation example
Copy the request and explore its response example.
/agent-api/v1/tool/executeX-Api-Keycurl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_douyin_xingtu_get_sign_image' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"durationTS": 86400,
"format": "jpg",
"uri": "tos-cn-i-0813c001/o0DEecCAEI8ANj6CtpODfAA9ADAFAAXgAsIqID"
}
}'{
"code": 200,
"data": {
"backupURL": "https://p3-star-fe-sign.byteimg.com/tos-cn-i-0813c001/o0DEecCAEI8ANj6CtpODfAA9ADAFAAXgAsIqID~tplv-9hvokabxw2-image.jpg?rk3s=5ec46d44&x-expires=1794197190&x-signature=Y8nTITPlg1KLulsSzWXgRSuqxls%3D",
"img": {
"format": "jpg",
"tpl": "tplv-9hvokabxw2-image",
"uri": "tos-cn-i-0813c001/o0DEecCAEI8ANj6CtpODfAA9ADAFAAXgAsIqID"
},
"mainURL": "https://p9-star-fe-sign.byteimg.com/tos-cn-i-0813c001/o0DEecCAEI8ANj6CtpODfAA9ADAFAAXgAsIqID~tplv-9hvokabxw2-image.jpg?rk3s=5ec46d44&x-expires=1794197190&x-signature=mIaz4pd7mR0UBk3Qe1rYxDKro64%3D"
},
"docs": "https://api.tikhub.io/#/Douyin-Xingtu-API/get_sign_image_api_v1_douyin_xingtu_get_sign_image_get",
"message": "Request successful. This request will incur a charge."
}This example shows part of the response. Copied content is valid JSON.

