GetTask - Query the status and result of a car buyer portrait task

Updated at:

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.

tingwu-automotive-customer-profile

input

object

Yes

Specify the relevant business parameters.

input.task

string

Yes

The task type. Set the value to getTask to get the task result.

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: The task is successful.

  • 1: The task is in progress.

  • 2: The task failed.

0

output.errorCode

string

The error code returned when the task is submitted but fails to run. This parameter is returned only when status is 2.

"TSC.FileError"

output.errorMessage

string

The error message returned when the task is submitted but fails to run. This parameter is returned only when status is 2.

"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"
}