# 查询转写任务

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

GET
  https://platform.ikho.cn/developer/api/open/partner/ai/transcriptions/{transcription_id}
  试一试 

  
## 鉴权

  

  
    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
    
    
    
  

  识别到或指定的语言。

  

    

  
    duration
    integer
    
    
    
  

  音频时长,单位为秒。

  

    

  
    segments
    array
    
    
    
  

  按时间对齐的逐句片段。

  子属性
      

  
    speaker
    string
    
    
    
  

  说话人标签,开启说话人分离时返回。

  

      

  
    start_ms
    integer
    
    
    
  

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

  

      

  
    end_ms
    integer
    
    
    
  

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

  

      

  
    text
    string
    
    
    
  

  该片段的文本。

  

  

  cURLPython
  

  

  bash
    
  

  
```
curl "https://platform.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(
    class="tk-str">"https:class="tk-cmt">//platform.ikho.cn/developer/api/open/partner/ai/transcriptions/" + transcription_id,
    headers={
        class="tk-str">"X-Client-Id": client_id,
        class="tk-str">"X-Client-Api-Key": api_key,
    },
)
task = resp.json()
print(task[class="tk-str">"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": "好的,我记一下,让供应链那边优先排一下华南的单子。" }
    ]
  }
}
```