跳到主要内容

查询模型响应

本接口用于通过响应 ID 获取指定的模型响应信息。您可以使用此接口查询已创建的响应的详细信息和状态。

开通服务​

  • 开发环境：直接创建 API Key 即可使用上下文缓存功能。
  • 生产环境：需要提交工单开通上下文缓存功能。
  • 使用前请确保您已获取 API Key。参见快速开始获取 API Key。

请求方法​

GET：<ai-api-base-url>/llm/v1/responses/{response_id}

其中，<ai-api-base-url> 为您的 API Key 所属数据中心的域名：

  • 北京数据中心：https://ai.rong-api.com
  • 北美数据中心：https://ai.us-light-api.com

请求头参数​

参数名类型必传默认值说明
Authorizationstring是-身份认证令牌，格式为 Bearer <your API key>，需替换为实际 API Key，用于验证用户权限。

路径参数​

参数名类型必传说明
response_idstring是待检索的响应 ID。

请求示例​

bash
curl --location '<ai-api-base-url>/llm/v1/responses/resp_123456' \
  --header 'Authorization: Bearer <token>'

返回结果​

响应已完成​

如果您调用的响应已完成，模型会返回对应的 Response 对象。

响应未完成​

如果您调用的响应未完成，模型会返回错误码。

返回结果示例​

JSON
{
    "created_at": 1754571515,
    "id": "resp_0217******",
    "max_output_tokens": 32768,
    "model": "Doubao/Doubao-seed-1.6",
    "object": "response",
    "output": [
        {
            "type": "message",
            "role": "assistant",
            "content": [
                {
                    "type": "output_text",
                    "text": "融云 AI API 的多轮对话功能让您可以轻松构建具有上下文记忆的智能应用。\n\n**实现方式**：\n\n1. **首次对话**：正常调用 API，系统会返回一个 `response_id`\n\n2. **后续对话**：在新请求中传入 `previous_response_id` 参数，引用上一轮的响应 ID\n\n3. **上下文保持**：模型会自动记住之前的对话内容，无需重复传入历史消息\n\n**核心参数**：\n- `previous_response_id`：上一个响应的唯一标识符\n- `store`：设置为 `true` 以存储对话历史（默认值）\n- `expire_at`：设置对话历史的过期时间，最长 3 天\n\n**使用建议**：\n- 在连续对话中，建议每次请求间隔约 100 毫秒\n- 配合缓存机制使用，可大幅降低 Token 消耗\n- 通过 `instructions` 参数可以为每轮对话设置特定指令\n\n**应用场景**：\n- 智能客服：记住用户问题，提供连贯服务\n- 内容创作：基于之前的内容持续创作\n- 代码助手：理解项目上下文，提供精准建议\n\n这样您就可以构建自然流畅的对话体验了。"
                }
            ],
            "status": "completed",
            "id": "msg_0217******"
        }
    ],
    "thinking": {
        "type": "disabled"
    },
    "status": "completed",
    "usage": {
        "input_tokens": 28,
        "output_tokens": 420,
        "total_tokens": 448,
        "input_tokens_details": {
            "cached_tokens": 0
        },
        "output_tokens_details": {
            "reasoning_tokens": 0
        }
    },
    "caching": {
        "type": "disabled"
    },
    "store": true,
    "expire_at": 1754830715
}
最后于 更新