从 Prompt 到 Agent：OpenAI API 演进路线

{
    "id": "cmpl-uqkvlQyYK7bGYrRHQ0eXlWi7", // 该补全的唯一标识符
    "object": "text_completion", // 始终是 "text_completion"
    "created": 1780188213, // 补全创建时的 Unix 时间戳（以秒为单位）
    "model": "model_id", // 补全内容的模型
    "system_fingerprint": "fp_44709d6fcb", // 模型运行时所依赖的后端配置信息，可与 seed 请求参数一起使用，以便了解后端发生了哪些可能影响系统确定性的更改
    "choices": [{
        "text": "\n\nThis is indeed a test", // 补全响应的文本内容，可通过 response.choices[0].text 访问
        "index": 0, // 响应索引
        "logprobs": null, 
        /*
        "logprobs": {
            "text_offset": [0,..], // 文本偏移量
            "token_logprobs": [0,..], // 词元概率
            "tokens": ["test",..], // 各个词元
            "top_logprobs": [] // 概率最高的词元
        }
        */
        "finish_reason": "stop" // 结束原因："stop" 自然停止、"length" 达到最大 token 数、"content_filter" 内容过滤
    }],
    "usage": { // 完成请求的使用统计信息
        "prompt_tokens": 5, // 提示词中的 token 数量
        "completion_tokens": 7, // 生成的补全内容中包含的 token 数量
        "total_tokens": 12, // 该请求中使用的 tokens 总数（prompt+completion）
        "completion_tokens_details": {
            "accepted_prediction_tokens": 0, // 在使用“预测输出”功能时，出现在补全中的预测 tokens 数目
            "audio_tokens": 0, // 模型生成的音频 tokens
            "reasoning_tokens": 0, // 模型为进行推理而生成的 tokens
            "rejected_prediction_tokens": 0 // 在使用“预测输出”功能时，未出现在补全中的预测 tokens 数目
        },
        "prompt_tokens_details": { // 提示词中使用的各类 token 的详细分类
            "audio_tokens": 0, // 提示词中包含的音频输入 tokens
            "cached_tokens": 0, // 提示词中包含的缓存 tokens
        }
    }

}

{
    "id": "chatcmpl-abc123",                   // 唯一标识符
    "object": "chat.completion",               // 对象类型
    "created": 1780289625,                     // 创建时间（Unix 时间戳）
    "model": "gpt-5.4",                        // 实际使用的模型
    "choices": [    // chat completion 选项列表，如果请求参数中 n > 1，则将有多个选项
        {
            "index": 0,                        // 选项索引
            "message": {
                "role": "assistant",                // 消息角色
                "content": "Hello! How can I ...",  // 消息内容
                "refusal": null,                    // 模型生成的拒绝信息（如触发安全策略）
                "tool_calls": [],                   // 模型生成的工具调用请求（如有）
                /*
                "audio": {  // 如果请求了音频输出模态，audio 包含音频响应数据
                    "id": "string",             // 音频响应唯一标识符
                    "data": "string",           // 模型生成的 Base64 编码音频字节，格式为请求中指定格式
                    "expires_at": 1780290328,   // 服务器上过期时间
                    "transcript": "string",     // 模型生成的音频的文字稿
                }
                */
            },
            "logprobs": null,                    // 日志概率（按请求返回）
            "finish_reason": "stop"              // 结束原因：stop / length / tool_calls / content_filter
        }
    ],
    "usage": {  // 完成请求的使用统计信息
        "prompt_tokens": 9,                     // 提示词 token 数
        "completion_tokens": 12,                // 补全 token 数
        "total_tokens": 21,                     // 总 token 数
        "completion_tokens_details": {
            "accepted_prediction_tokens": 0,    // 命中的预测 token
            "rejected_prediction_tokens": 0,    // 未命中的预测 token
            "audio_tokens": 0,                   // 音频 token
            "reasoning_tokens": 0                // 推理 token（o 系列模型）
        },
        "prompt_tokens_details": {
            "audio_tokens": 0,                   // 输入音频 token
            "cached_tokens": 0                   // 缓存命中 token
        }
    }
}

{
    "id": "resp_abc123",                    // 响应唯一标识符
    "object": "response",                   // 对象类型（始终为 response）
    "created_at": 1741711372,               // 创建时间（Unix 时间戳）
    "model": "gpt-4o",                      // 使用的模型
    "status": "completed",                  // 响应状态：completed / failed / incomplete
    "completed_at": 1741476543,             // 完成时间
    "error": null,                          // 模型无法生成响应时返回的错误对象
    "incomplete_details": null,             // 说明回复不完整的原因： max_output_tokens / content_filter
    "instructions": null,                   // 插入到模型上下文中的系统消息，与 previous_response_id 一同使用时，前一响应的指令不会传递到下一个响应中
    "output": [                             // 模型生成的项目列表，可包含多个不同类型的项
        {
            "type": "message",              // 输出类型：消息（始终为 message）
            "id": "msg_abc",                // 消息唯一标识符
            "status": "completed",          // 输出消息状态：in_progress / completed / incomplete
            "role": "assistant",            // 输出消息的角色（始终为 assistant）
            "phase": "commentary",          // 标识 Assistant Output Item 当前处于执行流程的哪个阶段：commentary / final_answer
            "content": [                    // 输出消息的内容
                {
                    "type": "output_text",  // 输出内容类型（始终为 output_text）
                    "text": "Hello! How can I help?",   // 模型的输出文本
                    "annotations": []       // 标注信息（如引用来源）
                } 
                /*
                {
                    "type": "refusal",      // 拒绝的类型（始终为 refusal）
                    "refusal": "string"     // 模型拒绝的解释
                }
                */
            ]
        },
        {
            "type": "file_search_call",     // 输出类型：文件搜索工具调用
            "id": "tool_id",                // 文件搜索工具调用的唯一 ID
            "status": "searching",          // 文件搜索工具调用的状态：in_progress / searching / completed
            "queries": "search query",      // 用于搜索文件的查询语句
            "results": [
                {
                    "file_id": "abc",       // 文件唯一标识符
                    "filename": "temp.txt", // 文件名
                    "score": 0.5,           // 文件相关性得分：[0, 1]
                    "text": "some text"     // 文件中检索的文本
                }
            ]
        },
        {
            "type": "function_call",        // 输出类型：函数调用
            "id": "fc_xyz",                 // 函数调用唯一标识符
            "call_id": "call_abc",          // 模型生成的调用 ID，用于匹配工具返回结果
            "name": "get_weather",          // 函数名称
            "namespace": "somens",          // 要运行函数的命名空间
            "status": "in_progress",        // Item 状态：in_progress / completed / incomplete
            "arguments": "{\"location\":\"Tokyo\"}"  // 传递给函数的参数（JSON 字符串）
        }
    ],
    "parallel_tool_calls": true,            // 并行工具调用
    "previous_response_id": null,           // 模型先前响应的唯一 ID，使用此 ID 来创建多轮对话。
    "reasoning": {
        "effort": null,
        "summary": null
    },
    "store": true,
    "temperature": 1.0,                     // 采样温度取值范围
    "text": {
        "format": {
            "type": "text"
        }
    },
    "tool_choice": "auto",                  // 模型在生成响应时应如何选择要使用的工具：none / auto / required
    "tools": [],
    "top_p": 1.0,
    "truncation": "disabled",
    "usage": {                              // 使用统计
        "input_tokens": 50,                 // 输入 token 数
        "output_tokens": 100,               // 输出 token 数
        "total_tokens": 150,                // 总 token 数
        "input_tokens_details": {
            "cached_tokens": 0              // 缓存命中 token
        },
        "output_tokens_details": {
            "reasoning_tokens": 0           // 推理 token
        }
    }
}