查询生成元数据

查询一次生成请求的请求、供应商、用量、耗时、Token 和费用元数据。只要平台已记录对应元数据，该接口可用于文本、视觉、多模态、图片、视频、音频和其他生成类型。

优先使用原始模型响应头中的 canonical X-Request-ID（br-*）作为 generation 查询 ID。接口也接受平台已记录的响应 ID（如 chatcmpl_*、img_*、video_*）和上游别名；X-Trace-ID 仅用于链路诊断。

认证

Authorization Bearer

在 Authorization 请求头中使用 API Key 作为 Bearer Token。

查询参数

idstringrequired

优先使用原始响应头中的 canonical X-Request-ID（br-*）；也可使用平台已记录的响应 ID 或上游别名。

Response

dataobject

生成元数据。

data.idstring

生成或请求 ID。

data.request_idstring | null

请求关联 ID（如果可用）。

data.api_typestring | null

生成使用的 API 类型，例如 completions、image、video、tts 或 stt。

data.modelstring | null

生成使用的模型。

data.model_typestring | null

内部模型分类，例如 llm、image、video 或 audio。

data.statusstring | null

记录的生成状态，例如 completed、failed、cancelled 或 processing。

data.created_atstring | null

ISO 8601 创建时间。

data.updated_atstring | null

ISO 8601 更新时间。

data.generation_timenumber | null

生成耗时，单位毫秒（如果可用）。

data.latencynumber | null

端到端请求延迟，单位毫秒（如果可用）。

data.provider_idstring | number | null

本次请求使用的路由 ID。

data.provider_request_idstring | null

上游请求或响应标识。

data.tokens_promptinteger | null

Prompt Token 数量（如果可用）。

data.tokens_completioninteger | null

Completion Token 数量（如果可用）。

data.total_costnumber | null

记录的生成总费用，单位 USD。

data.usagenumber | null

用量金额，单位 USD。

data.streamedboolean | null

原始响应是否为流式。

data.cancelledboolean | null

生成是否已取消。

data.finish_reasonstring | null

返回的结束原因（如果有）。

错误

400：缺少必填的 id 查询参数。
401：缺少或无效的 Authorization。
404：生成记录不存在，或当前认证 API Key 无权访问。

请求

Shell

1curl "https://api.token360.ai/v1/generation?id={request_id}" \
2  -H "Authorization: Bearer sk-your-api-key"

响应

JSON

1{
2  "data": {
3    "id": "550e8400-e29b-41d4-a716-446655440000",
4    "request_id": "br-550e8400-e29b-41d4-a716-446655440000",
5    "api_type": "completions",
6    "model": "claude-opus-5",
7    "model_type": "llm",
8    "status": "completed",
9    "created_at": "2026-06-02T08:00:00Z",
10    "updated_at": "2026-06-02T08:00:02Z",
11    "generation_time": 1820,
12    "latency": 1820,
13    "provider_id": "42",
14    "provider_request_id": "provider_resp_123",
15    "tokens_prompt": 128,
16    "tokens_completion": 256,
17    "total_cost": 0.00042,
18    "usage": 0.00042,
19    "streamed": false,
20    "cancelled": false,
21    "finish_reason": "stop"
22  }
23}