Generate a standalone summary
API Configuration
After saving, the Try It panel below sends real requests with this key.
Base: api.xrtoken.ai
Submit plain text, transcript segments, or an existing minutes task ID in the same region. Exactly one input is required. Returns a complete structured report synchronously without uploading audio, running speech recognition, or charging ASR duration.
model defaults to deepseek-v4-flash and currently accepts only that model. The caller's visible channel and effective input/output/cache token prices apply. Funds are reserved before generation and observed usage is settled once, even if output is malformed or truncated. No automatic generation retry. If usable usage is absent, the reservation is released; usage.available=false means unknown usage. Use request_id to reconcile billing_status=pending instead of regenerating.
task_id must identify a readable minutes task with completed transcription: either status=succeeded, or status=failed with nonempty report v2 segments and quality.status=unavailable. Historical standard transcripts are supported. Summarizing again does not rerun ASR or change the original task. Running, cancelled or ASR-failed tasks return 409; inaccessible or missing tasks return 404.
report.version=2 includes overview, nested sections, chapters, todos, decisions, quotes, review items, visual semantics, speakers and source segments. Caller source IDs and speaker references remain stable; unknown timing is not invented. markdown exports the core summary only.
This is synchronous and creates no pollable summary task. Model generation has a 30-minute limit. Set a client timeout of at least 1920 seconds (32 minutes) and retain the result. Long requests send valid leading JSON whitespace after 45 seconds and every 15 seconds thereafter. A model timeout returns error.code=summary_timeout. After HTTP 200 has been committed, subsequent failure is indicated by status=failed, error and report.quality.status=unavailable; always inspect the response body. Client disconnection does not cancel observed-usage settlement.
Limits: 2 MiB request body, 524288 UTF-8 bytes of source text, 10000 segments, 1000 speakers. Body upload and preparation share a 30-second budget; upload timeouts return HTTP 408. Upstream context overflow fails explicitly without truncation or chunked retries.
AuthorizationBearer <token>
API key authentication (OpenAI format). Pass in the Authorization header:
Authorization: Bearer tr-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X post "https://api.xrtoken.ai/v1/summaries" \ -H "Content-Type: application/json" \ -d '{ "text": "先整理资料，再提交审核。\n我负责尽快准备服务清单。" }'{
"object": "summary",
"request_id": "string",
"model": "deepseek-v4-flash",
"status": "succeeded",
"created_at": "2019-08-24T14:15:22Z",
"source_task_id": "b35bfd1f-7440-4b82-b05a-344d469d1482",
"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"
}
]
}
},
"markdown": "string",
"usage": {
"prompt_tokens": 0,
"completion_tokens": 0,
"cached_tokens": 0,
"total_tokens": 0,
"available": true,
"billing_status": "settled"
},
"error": {
"type": "string",
"code": "string",
"message": "string"
}
}{
"error": "model field is required",
"type": "invalid_request_error"
}{
"error": "invalid or missing API key",
"type": "auth_error"
}{
"error": "insufficient balance -- please top up or upgrade your plan",
"type": "billing_error"
}{
"error": "string",
"type": "invalid_request_error"
}{
"error": "string",
"type": "invalid_request_error"
}{
"error": "string",
"type": "invalid_request_error"
}{
"error": "string",
"type": "invalid_request_error"
}{
"error": "rate limit exceeded",
"type": "rate_limit_error"
}{
"object": "summary",
"request_id": "string",
"model": "deepseek-v4-flash",
"status": "succeeded",
"created_at": "2019-08-24T14:15:22Z",
"source_task_id": "b35bfd1f-7440-4b82-b05a-344d469d1482",
"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"
}
]
}
},
"markdown": "string",
"usage": {
"prompt_tokens": 0,
"completion_tokens": 0,
"cached_tokens": 0,
"total_tokens": 0,
"available": true,
"billing_status": "settled"
},
"error": {
"type": "string",
"code": "string",
"message": "string"
}
}{
"error": "string",
"type": "invalid_request_error"
}