# 查询转写任务

> 按 transcription_id 查询任务状态与结果。进行中持续轮询,SUCCESS 时 data 就绪。

GET
  `https://ikho.cn/developer/api/open/partner/ai/transcriptions/{transcription_id}`
  [试一试](/docs/embedded/playground/)

  
## 鉴权

  

  
    `X-Client-Id`
    string
    header
    必填
    
  

  你的 `client_id`。

  

  

  
    `X-Client-Api-Key`
    string
    header
    必填
    
  

  你的 `api_key`。

  

  
## 路径参数

  

  
    `transcription_id`
    string
    path
    必填
    
  

  提交音频时返回的 `transcription_id`。

  

  
## 响应

  

  
    `transcription_id`
    string
    
    
    
  

  任务标识。

  

  

  
    `status`
    string
    
    
    
  

  任务状态:`PENDING`、`RECEIVED`、`STARTED`、`PROGRESS` 表示进行中,继续轮询;`SUCCESS` 表示结果就绪;`FAILURE`、`REVOKED` 为终态失败。

  

  

  
    `data`
    object
    
    
    
  

  状态为 `SUCCESS` 时填充。

  子属性
    

  
    `text`
    string
    
    
    
  

  完整逐字稿文本。

  

    

  
    `language`
    string
    
    
    
  

  回显请求的 `language`;内测期 `auto` 按中文(`zh`)处理。

  

    

  
    `duration`
    integer
    
    
    
  

  音频时长,单位为秒。

  

    

  
    `segments`
    array
    
    
    
  

  按时间对齐的逐句片段。

  子属性
      

  
    `speaker`
    string
    
    
    
  

  说话人标签,始终返回;未开启说话人分离时恒为 `发言人 1`。

  

      

  
    `start_ms`
    integer
    
    
    
  

  片段起始时间,单位为毫秒。

  

      

  
    `end_ms`
    integer
    
    
    
  

  片段结束时间,单位为毫秒。

  

      

  
    `text`
    string
    
    
    
  

  该片段的文本。

  

  

  cURLPython
  

  

  bash
    
  

  
```
curl "https://ikho.cn/developer/api/open/partner/ai/transcriptions/$TRANSCRIPTION_ID" \
  -H "X-Client-Id: $CLIENT_ID" \
  -H "X-Client-Api-Key: $API_KEY"
```

  ts
    
  

  
```
import requests

resp = requests.get(
    "https://ikho.cn/developer/api/open/partner/ai/transcriptions/" + transcription_id,
    headers={
        "X-Client-Id": client_id,
        "X-Client-Api-Key": api_key,
    },
)
task = resp.json()
print(task["status"])
```

  

  200 响应示例
    
  

  
```
{
  "transcription_id": "task_exec_5c8a2f",
  "status": "PROGRESS",
  "data": {}
}
```

  

  SUCCESS 完整响应示例
    
  

  
```
{
  "transcription_id": "task_exec_5c8a2f",
  "status": "SUCCESS",
  "data": {
    "text": "各位下午好,我们先过一下这周的销售数据。华东区上周新增了三家门店,整体环比增长百分之十二。",
    "language": "zh",
    "duration": 1843,
    "segments": [
      { "speaker": "发言人 1", "start_ms": 0, "end_ms": 4200, "text": "各位下午好,我们先过一下这周的销售数据。" },
      { "speaker": "发言人 1", "start_ms": 4200, "end_ms": 9800, "text": "华东区上周新增了三家门店,整体环比增长百分之十二。" },
      { "speaker": "发言人 2", "start_ms": 9800, "end_ms": 15600, "text": "华南区的补货节奏要再快一点,这周有两家门店断了货。" },
      { "speaker": "发言人 1", "start_ms": 15600, "end_ms": 20400, "text": "好的,我记一下,让供应链那边优先排一下华南的单子。" }
    ]
  }
}
```