GetTask - Query the status and result of a car buyer portrait task
This API reference describes how to query the status and result of a customer profile task.
Prerequisites
Activate the service and obtain and configure an API key. To prevent security risks from code leaks, configure the API key as an environment variable instead of hard coding it in your code.
NoteTo grant temporary access permissions to third-party applications or users, or want to strictly control risky operations such as accessing or deleting sensitive data, you can use a temporary authentication token.
Compared to a long-term API key, a temporary authentication token is valid for only a short period (60 seconds) and offers higher security. It is suitable for temporary call scenarios and can effectively reduce the risk of API key leaks.
Usage: In your code, replace the API key used for authentication with the obtained temporary authentication token.
Endpoint
https://dashscope.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation
Request method
POST
Request headers
Authorization: Bearer {api-key} // Replace {api-key} with your actual API key.
Content-Type: application/json
Get task result
Retrieves the result of a customer profile analysis task.
Request parameters
Name | Type | Required | Description | Example |
|---|---|---|---|---|
model | string | Yes | The business type. Set the value to | tingwu-automotive-customer-profile |
input | object | Yes | Specify the relevant business parameters. | |
input.task | string | Yes | The task type. Set the value to | |
input.dataId | string | Yes | The ID of the audio task to query. | wkb*** |
Response parameters
Name | Type | Description | Example/Parsing protocol |
|---|---|---|---|
code | string | The error code. | |
message | string | The error message. | |
request_id | string | The request ID. | f97ee37d-0f9c-9b93-b6bf-bd263a232bf9 |
usage | object | The usage. | {} |
output | object | The business response body. | |
output.status | string | The task status.
| 0 |
output.errorCode | string | The error code returned when the task is submitted but fails to run. This parameter is returned only when | "TSC.FileError" |
output.errorMessage | string | The error message returned when the task is submitted but fails to run. This parameter is returned only when | "File cannot be read." |
output.customerProfilePath | string | The OSS URL of the analysis result. For more information, see Parsing protocol for output.customerProfilePath. | For information about the parsing protocols for the content of the files corresponding to the OSS URLs, see: |
output.transcriptionPath | string | The OSS URL of the speech-to-text result. For more information, see Parsing protocol for output.transcriptionPath. | |
output.identityRecognitionPath | string | The OSS URL of the role recognition result. For more information, see Parsing protocol for output.identityRecognitionPath. | |
output.contentExtractionsPath | string | A collection of one or more OSS URLs for the extraction results of customer points of interest. For more information, see Parsing protocol for output.contentExtractionsPath. |
Parsing protocol for output.transcriptionPath
The root element is an object. The following table describes its fields:
Name | Type | Description | Example |
|---|---|---|---|
paragraphs | Array | A list of paragraphs. | |
paragraphs[0].paragraphId | String | The paragraph ID. | 16987422100275***** |
paragraphs[0].speakerId | String | The speaker ID. | 1 |
paragraphs[0].words | Array | A list of words. | |
paragraphs[0].words[0].id | Integer | The word number. | 10 |
paragraphs[0].words[0].sentenceId | Integer | The sentence ID. | 1 |
paragraphs[0].words[0].start | Integer | The start time in milliseconds. | 4970 |
paragraphs[0].words[0].end | Integer | The end time in milliseconds. | 5560 |
paragraphs[0].words[0].text | String | The word text. | Hello, |
The following is a JSON example:
{
"paragraphs": [
{
"paragraphId": "16987422100275*******",
"speakerId": "1",
"words": [
{
"id": 10,
"sentenceId": 1,
"start": 4970,
"end": 5560,
"text": "Hello,"
},
{
"id": 20,
"sentenceId": 1,
"start": 5730,
"end": 6176,
"text": "I am"
}
]
}
]
}
Parsing protocol for output.customerProfilePath
The root element is an object. The following table describes its fields:
Name | Type | Description | Example |
|---|---|---|---|
saleClueClassify | Object | The sales lead classification. | |
saleClueClassify.classify | String | The lead category. | B |
saleClueClassify.evidence | String | The basis for the classification. | The customer only expressed interest in learning about SUVs and had no clear intention to purchase a car. |
customerNotMentioned | Integer | The number of items not mentioned by the customer. | 46 |
tryDriveIntentionEvaluation | Object | The test drive intention assessment. | |
tryDriveIntentionEvaluation.score | Integer | The score. | 0 |
tryDriveIntentionEvaluation.evidence | String | The basis for the assessment. | The customer did not mention any intention to take a test drive and only asked about the price. |
customerConcerned | Integer | The number of customer points of interest. | 4 |
oneSentenceSumUp | String | A summary of the customer's points of interest. | Customer's points of interest: SUV model, exterior design, interior quality, specific configurations, battery range, and estimated time of arrival at the store. Concerns: Price transparency during the purchase process, after-sales service, and whether the actual vehicle performance matches the advertisement. |
The following is a JSON example:
{
"saleClueClassify": {
"classify": "B",
"evidence": "The customer only expressed interest in learning about SUVs and had no clear intention to purchase a car."
},
"customerNotMentioned": 46,
"tryDriveIntentionEvaluation": {
"score": 0,
"evidence": "The customer did not mention any intention to take a test drive and only asked about the price."
},
"customerConcerned": 4,
"oneSentenceSumUp": "Customer's points of interest: SUV model, exterior design, interior quality, specific configurations, battery range, and estimated time of arrival at the store.\nConcerns: Price transparency during the purchase process, after-sales service, and whether the actual vehicle performance matches the advertisement."
}
Parsing protocol for output.identityRecognitionPath
The outermost layer is an Object that contains the following fields:
Name | Type | Description | Example |
|---|---|---|---|
identityResults | Array | A list of identity recognition results. | |
identityResults[0].identity | String | The recognized identity. | Customer |
identityResults[0].speakerId | String | The speaker ID. | 1 |
The following is a JSON example:
{
"identityResults": [
{
"identity": "Customer",
"speakerId": "1"
},
{
"identity": "Salesperson",
"speakerId": "2"
}
]
}
Parsing protocol for output.contentExtractionsPath
The outermost layer is a JSONArray containing the following elements:
Name | Type | Description | Example |
|---|---|---|---|
result | String | The result description. | Car purchase cost |
matchedSentenceIds | Array<Integer> | A list of matched sentence IDs. | [1, 2] |
title | String | The title. | Cost of ownership |
remarks | String | The remarks. | The customer expressed concern about the car purchase cost during the conversation and asked about the price. |
The following is a JSON example:
[
{
"result": "Not mentioned",
"matchedSentenceIds": [],
"title": "Product configuration",
"remarks": "The conversation between the customer and the salesperson did not involve any specific product configuration details, such as AR-HUD, electric leg rests or foot mats, or panoramic sunroof."
},
{
"result": "Car purchase cost",
"matchedSentenceIds": [
1,
2
],
"title": "Cost of ownership",
"remarks": "The customer expressed concern about the car purchase cost during the conversation and asked about the price."
}
]
Request example
In the Authorization request header, replace sk-*** with your Alibaba Cloud Model Studio API key.
curl --location 'https://dashscope.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation' \
--header 'Authorization: Bearer sk-***' \
--header 'Content-Type: application/json' \
--data '{
"model": "tingwu-automotive-customer-profile",
"input": {
"dataId": "***",
"task": "getTask"
}
}'
Response example
{
"output": {
"identityRecognitionPath": "https://***.oss-cn-hangzhou.aliyuncs.com/agentic/prepub/CommonDataField/idRecog/1627865205776705/llm-3cx2a3o4n8y45iee/2025/07/09/2deb5d827f1548a88440b6a40836f239?Expires=***&OSSAccessKeyId=YOUR_ACCESS_KEY_ID&Signature=YOUR_SIGNATURE",
"customerProfilePath": "https://***.oss-cn-hangzhou.aliyuncs.com/agentic/prepub/CommonDataField/customerProfile/1627865205776705/llm-3cx2a3o4n8y45iee/2025/07/09/3880ad6e4b4e4f99a536ac472f083a04?Expires=***&OSSAccessKeyId=YOUR_ACCESS_KEY_ID&Signature=YOUR_SIGNATURE",
"contentExtractionsPath": "https://***.oss-cn-hangzhou.aliyuncs.com/agentic/prepub/CommonDataField/conExtract/1627865205776705/llm-3cx2a3o4n8y45iee/2025/07/09/e669817cb93c4a90869d1b733aec8267?Expires=***&OSSAccessKeyId=YOUR_ACCESS_KEY_ID&Signature=YOUR_SIGNATURE",
"status": 0,
"transcriptionPath": "https://***.oss-cn-hangzhou.aliyuncs.com/agentic/prepub/CommonDataField/transcription/1627865205776705/llm-3cx2a3o4n8y45iee/2025/07/09/e565ebbb891e4943a482bda4619081aa?Expires=***&OSSAccessKeyId=YOUR_ACCESS_KEY_ID&Signature=YOUR_SIGNATURE"
},
"usage": {},
"request_id": "fb9f5972-0dc0-9d7f-afe6-3120b46419f4"
}