Insight

Insight extracts information from the transcript based on a selected perspective or instruction.

Insight requires an Enterprise license. Contact us via the Pricing page.

Configuration

Set the following parameters in the config object of the POST Request body.

Name	Type	Default	Description
use_insight	Boolean	false	Set to true to request insight generation from the transcript.
insight.prompt	String		Optional perspective or instruction for insight generation. It can be omitted and applies only when use_insight is true.

When keywords is set for keyword boosting, the same keywords are also used as hints during insight generation. See Keyword boosting for how to configure keywords.

Request example

{
  "use_insight": true,
  "insight": {
    "prompt": "Extract the customer's main requests and follow-up actions from the conversation."
  }
}

POST example: Batch STT sample code

Unified example (presets): Batch STT sample code

Result retrieval

After submitting a transcription job, use the existing Batch STT result API to get the result. When the base transcript is complete, insight results are returned in the results.insight field of the same response.

GET https://openapi.vito.ai/v1/transcribe/{TRANSCRIBE_ID}

Insight response example

The response uses an array format, and Batch STT insight returns one insight item per request.

Name	Description	Type	Value
results.insight[].title	Insight title	string
results.insight[].summary	Insight summary	string
results.insight[].category	Insight category	string	일상, 문의, 업무, 스팸

{
  "id": "{TRANSCRIBE_ID}",
  "status": "completed",
  "results": {
    "utterances": [
      {
        "start_at": 4737,
        "duration": 2360,
        "msg": "I am calling to check the delivery schedule.",
        "spk": 0,
        "lang": "en"
      },
      {
        "start_at": 8197,
        "duration": 3280,
        "msg": "I will check it and get back to you this afternoon.",
        "spk": 1,
        "lang": "en"
      }
    ],
+   "insight": [
+     {
+       "title": "Delivery schedule inquiry",
+       "summary": "The customer asked about the delivery schedule, and the agent will check it and follow up in the afternoon.",
+       "category": "문의"
+     }
+   ]
  }
}

Limitations

• Check insight results in the results.insight field of the base transcript response.