获取实时转录翻译任务的状态

更新时间不可用

获取实时转录翻译任务状态。

GET
https://api.agora.io/api/speech-to-text/v1/projects/{appid}/agents/{agentId}

鉴权

Basic Auth

HTTP 基本认证:每次发送 HTTP 请求时,都必须在请求 Header 部填入 Authorization 字段。关于如何生成该字段的值,请参考实现 HTTP 基本认证。

路径参数

appidstring
必填

你的项目的 App ID,可在声网控制台获取。

agentIdstring
必填

服务的 ID。通过 join 方法中的响应包体获取。

响应

如果返回的状态码为 200,表示请求成功。

响应 Body

messagestring

请求结果的详细信息。

agent_idstring

服务的 ID。

create_tsinteger

服务创建时的 Unix 时间戳(秒)。

statusstring

服务的状态:

  • STARTING:服务开始启动。
  • RUNNING:服务进行中。
  • STOPPING:服务退出中。
  • STOPPED:服务退出成功。
  • RECOVERING:服务恢复中。
  • FAILED:服务退出失败。

请求示例

Example Request
curl --request GET \
  --url "https://api.agora.io/api/speech-to-text/v1/projects/:appid/agents/:agentId" \
  --header 'Authorization: Basic <credentials>'

响应示例

{
  "message": "ok",
  "agent_id": "1NT29X11GQSxxxxx80BEIN56XF",
  "create_ts": 1735035893,
  "status": "RUNNING"
}