ModelGo
ModelGo

单次调用

http
GET https://modelgo-web-api.modelgo.ai/api/openapi/v1/generations/{id}
GET https://modelgo-web-api.modelgo.ai/api/openapi/v1/requests/{id}      # 等价别名
GET https://modelgo-web-api.modelgo.ai/api/openapi/v1/generations/by-billing-session/{session_id}
Authorization: Bearer mgpat_xxxxxxxx

{id} 是网关响应头 X-Request-Id（gw_...）的值，不是响应体里的 chatcmpl-...。

调用日志由 observer 异步入库，通常在 15–60 秒内可查；入库前返回 401 unauthorized / not_visible，客户端应视为「尚未可查」并按退避重试。

字段

分组字段
标识id / request_id / generation_id / trace_id / created_at / completed_at
调用model_requested / vendor / protocol / streamed / status / http_status / finish_reason
错误error_class / error_reason
用量input_tokens / output_tokens / cached_tokens / cache_write_tokens / reasoning_tokens / total_tokens / media_units
延迟ttft_ms / generation_ms / total_latency_ms
计费billing_status / estimated_amount / settled_amount / currency / price_version / billing_items
归属workspace_id / api_key_id
重试provider_attempts / retry_count

billing_items 为 input / output / cache / addon / other 组件，合计等于 settled_amount。

route_summary 为脱敏的路由摘要：attempts / retries / failovers / final_status，不含供应商、实例或路由 ID。model_used 仅在服务开关 openapi.expose_model_used 打开时返回；默认不返回（qa#582 供应商身份收口）。

generation_id 是 billing 会话 id；如果只保留了它，可用 /generations/by-billing-session/{generation_id} 查回同一次调用。

原文（可选）

http
GET https://modelgo-web-api.modelgo.ai/api/openapi/v1/generations/{id}/content?kind=request
GET https://modelgo-web-api.modelgo.ai/api/openapi/v1/generations/{id}/content?kind=response

只有工作空间在调用时开启输入/输出采集才可读；否则返回 200 {"available":false,"reason":"not_stored"}。内容以 base64 返回。

不存在或不在可见范围的 id 统一返回 401 unauthorized / not_visible，不暴露存在性。