XRToken API 文档

查询语音妙记任务状态

API Configuration
After saving, the Try It panel below sends real requests with this key.
Base: api.xrtoken.ai

轮询妙记任务。建议间隔 ≥30 秒。不要高频 GET:xrtoken-minutes 的总结由服务端 poller 完成,过密轮询不会更快出结果。

  • processing:计算中,继续轮询。
  • succeeded:xrtoken-minutes 含 report / transcription / summary / chapters / extraction。report.quality.status 为 complete 或 partial(需核对)。旧任务没有 report 时按旧字段读取;doubao-minutes 另可能有 extraction / translation。
  • failed:error 含原因。若转写成功但摘要失败,仍返回 report / transcription / usage,且 transcription_status=succeeded、summary_status=failed、report.quality.status=unavailable;只按已完成识别和已观测总结用量结算,释放剩余预冻。识别失败则释放预冻。

xrtoken-minutes 摘要模型独立最多等待 30 分钟,超时在 report.quality.issues 中标记 summary_timeout。查询及列表也会将历史 unavailable 摘要结果呈现为 failed,保留原文、账务及原时间,不自动重跑。可主动用 POST /v1/summaries 和该 task_id 单独重新生成摘要。

GET
/v1/audio/minutes/{taskId}

Authorization

BearerAuth
AuthorizationBearer <token>

API 密钥认证(OpenAI 格式)。在 Authorization 请求头中传入:

Authorization: Bearer tr-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

In: header

Path Parameters

taskId*string

任务 ID(POST /v1/audio/minutes 返回的 id)

Response Body

application/json

application/json

application/json

curl -X get "https://api.xrtoken.net/v1/audio/minutes/string"
{
  "id": "string",
  "model": "string",
  "status": "processing",
  "transcription_status": "succeeded",
  "summary_status": "succeeded",
  "report": {
    "version": 2,
    "metadata": {
      "title": "string",
      "recordedAt": "string",
      "timezone": "string",
      "durationMs": 0
    },
    "overview": {
      "content": [
        {
          "type": "text",
          "text": "string"
        }
      ],
      "sourceSegmentIds": [
        "string"
      ],
      "verification": "sourced"
    },
    "keyPoints": [
      {
        "content": [
          {
            "type": "text",
            "text": "string"
          }
        ],
        "sourceSegmentIds": [
          "string"
        ],
        "verification": "sourced"
      }
    ],
    "sections": [
      {
        "id": "string",
        "heading": {
          "content": [
            {
              "type": "text",
              "text": "string"
            }
          ],
          "sourceSegmentIds": [
            "string"
          ],
          "verification": "sourced"
        },
        "paragraphs": [
          {
            "content": [
              {
                "type": "text",
                "text": "string"
              }
            ],
            "sourceSegmentIds": [
              "string"
            ],
            "verification": "sourced"
          }
        ],
        "bullets": [
          {
            "content": [
              {
                "type": "text",
                "text": "string"
              }
            ],
            "sourceSegmentIds": [
              "string"
            ],
            "verification": "sourced"
          }
        ],
        "children": [
          {
            "id": "string",
            "heading": {
              "content": [
                {
                  "type": "text",
                  "text": "string"
                }
              ],
              "sourceSegmentIds": [
                "string"
              ],
              "verification": "sourced"
            },
            "paragraphs": [
              {
                "content": [
                  {
                    "type": "text",
                    "text": "string"
                  }
                ],
                "sourceSegmentIds": [
                  "string"
                ],
                "verification": "sourced"
              }
            ],
            "bullets": [
              {
                "content": [
                  {
                    "type": "text",
                    "text": "string"
                  }
                ],
                "sourceSegmentIds": [
                  "string"
                ],
                "verification": "sourced"
              }
            ],
            "children": []
          }
        ]
      }
    ],
    "chapters": [
      {
        "id": "string",
        "heading": {
          "content": [
            {
              "type": "text",
              "text": "string"
            }
          ],
          "sourceSegmentIds": [
            "string"
          ],
          "verification": "sourced"
        },
        "summary": {
          "content": [
            {
              "type": "text",
              "text": "string"
            }
          ],
          "sourceSegmentIds": [
            "string"
          ],
          "verification": "sourced"
        },
        "startSegmentId": "string",
        "endSegmentId": "string",
        "startMs": 0,
        "endMs": 0,
        "children": [
          {
            "id": "string",
            "heading": {
              "content": [
                {
                  "type": "text",
                  "text": "string"
                }
              ],
              "sourceSegmentIds": [
                "string"
              ],
              "verification": "sourced"
            },
            "summary": {
              "content": [
                {
                  "type": "text",
                  "text": "string"
                }
              ],
              "sourceSegmentIds": [
                "string"
              ],
              "verification": "sourced"
            },
            "startSegmentId": "string",
            "endSegmentId": "string",
            "startMs": 0,
            "endMs": 0,
            "children": []
          }
        ]
      }
    ],
    "todos": [
      {
        "id": "string",
        "action": {
          "content": [
            {
              "type": "text",
              "text": "string"
            }
          ],
          "sourceSegmentIds": [
            "string"
          ],
          "verification": "sourced"
        },
        "assigneeSpeakerId": "string",
        "assignmentQuote": "string",
        "deadline": "string",
        "status": "pending"
      }
    ],
    "decisions": [
      {
        "id": "string",
        "question": {
          "content": [
            {
              "type": "text",
              "text": "string"
            }
          ],
          "sourceSegmentIds": [
            "string"
          ],
          "verification": "sourced"
        },
        "options": [
          {
            "proposal": {
              "content": [
                {
                  "type": "text",
                  "text": "string"
                }
              ],
              "sourceSegmentIds": [
                "string"
              ],
              "verification": "sourced"
            },
            "proposerSpeakerId": "string"
          }
        ],
        "conclusion": {
          "content": [
            {
              "type": "text",
              "text": "string"
            }
          ],
          "sourceSegmentIds": [
            "string"
          ],
          "verification": "sourced"
        },
        "basis": [
          {
            "content": [
              {
                "type": "text",
                "text": "string"
              }
            ],
            "sourceSegmentIds": [
              "string"
            ],
            "verification": "sourced"
          }
        ],
        "status": "proposed",
        "confirmationQuote": "string"
      }
    ],
    "quotes": [
      {
        "id": "string",
        "text": "string",
        "speakerId": "string",
        "startMs": 0,
        "endMs": 0,
        "reason": {
          "content": [
            {
              "type": "text",
              "text": "string"
            }
          ],
          "sourceSegmentIds": [
            "string"
          ],
          "verification": "sourced"
        },
        "sourceSegmentIds": [
          "string"
        ]
      }
    ],
    "reviewItems": [
      {
        "id": "string",
        "kind": "proper_noun",
        "originalText": "string",
        "candidates": [
          "string"
        ],
        "sourceSegmentIds": [
          "string"
        ],
        "status": "pending"
      }
    ],
    "visuals": [
      {
        "id": "string",
        "type": "hierarchy",
        "origin": "summary_structure",
        "heading": {
          "content": [
            {
              "type": "text",
              "text": "string"
            }
          ],
          "sourceSegmentIds": [
            "string"
          ],
          "verification": "sourced"
        },
        "nodes": [
          {
            "id": "string",
            "label": {
              "content": [
                {
                  "type": "text",
                  "text": "string"
                }
              ],
              "sourceSegmentIds": [
                "string"
              ],
              "verification": "sourced"
            },
            "children": [
              {
                "id": "string",
                "label": {
                  "content": [
                    {
                      "type": "text",
                      "text": "string"
                    }
                  ],
                  "sourceSegmentIds": [
                    "string"
                  ],
                  "verification": "sourced"
                },
                "children": []
              }
            ]
          }
        ],
        "edges": [
          {
            "id": "string",
            "from": "string",
            "to": "string",
            "relation": {
              "content": [
                {
                  "type": "text",
                  "text": "string"
                }
              ],
              "sourceSegmentIds": [
                "string"
              ],
              "verification": "sourced"
            }
          }
        ],
        "columns": [
          {
            "id": "string",
            "label": {
              "content": [
                {
                  "type": "text",
                  "text": "string"
                }
              ],
              "sourceSegmentIds": [
                "string"
              ],
              "verification": "sourced"
            }
          }
        ],
        "rows": [
          {
            "id": "string",
            "cells": [
              {
                "content": [
                  {
                    "type": "text",
                    "text": "string"
                  }
                ],
                "sourceSegmentIds": [
                  "string"
                ],
                "verification": "sourced"
              }
            ]
          }
        ]
      }
    ],
    "speakers": [
      {
        "id": "string",
        "displayName": "string"
      }
    ],
    "segments": [
      {
        "id": "string",
        "text": "string",
        "startMs": 0,
        "endMs": 0,
        "speakerId": "string"
      }
    ],
    "quality": {
      "status": "complete",
      "issues": [
        {
          "code": "string",
          "path": "string"
        }
      ]
    }
  },
  "transcription": null,
  "summary": null,
  "chapters": null,
  "extraction": null,
  "translation": null,
  "usage": {
    "duration_ms": 0,
    "features": [
      "string"
    ],
    "all_activate": true,
    "engine": "string",
    "rate_per_hour": 0,
    "amount": 0,
    "asr_amount": 0,
    "flash_amount": 0,
    "flash_input_tokens": 0,
    "flash_output_tokens": 0
  },
  "error": "string",
  "created_at": "2019-08-24T14:15:22Z",
  "updated_at": "2019-08-24T14:15:22Z"
}
{
  "error": "invalid or missing API key",
  "type": "auth_error"
}
{
  "error": "string",
  "type": "invalid_request_error"
}