联网搜索 Web Search

POST

/v1/responses

访问地址：https://koalaapi.com，OpenAI 兼容接口在末尾加 /v1。

所有模型都支持 /v1/chat/completions，把模型名称完整复制到 model 参数即可调用。

模型与官方文档

示例模型：gpt-4.1

本站在架模型（文本）：gpt-6.1-sol、gpt-6-sol、gpt-5.6-sol、gpt-5.5、gpt-5.4、gpt-5.3-codex、gpt-6-luna、gpt-4.1 等

厂商官网：OpenAI 模型文档

说明：模型名称需与【模型广场】完全一致；不同令牌分组可用的模型不同，以控制台展示为准。

请求参数

Header 参数

Body 参数application/json必填

示例

{
    "model": "gpt-6.1-sol",
    "input": [
        {
            "role": "user",
            "content": [
                {
                    "type": "input_text",
                    "text": "今天的科技行业有哪些重要新闻？"
                }
            ]
        }
    ],
    "instructions": "你是一个乐于助人的中文助手，回答保持简洁准确。",
    "max_output_tokens": 4096,
    "max_tool_calls": 3,
    "temperature": 1,
    "top_p": 1,
    "stream": false,
    "stream_options": {
        "include_obfuscation": false
    },
    "tools": [
        {
            "type": "web_search"
        }
    ],
    "tool_choice": "auto",
    "parallel_tool_calls": true,
    "reasoning": {
        "effort": "medium",
        "summary": "auto"
    },
    "text": {
        "format": {
            "type": "text"
        },
        "verbosity": "medium"
    },
    "truncation": "disabled",
    "metadata": {
        "scene": "api-doc-demo"
    },
    "store": true,
    "background": false,
    "include": [
        "reasoning.encrypted_content"
    ],
    "service_tier": "auto",
    "safety_identifier": "user-hash-001",
    "user": "user-123",
    "prompt_cache_key": "cache-001",
    "top_logprobs": 5,
    "previous_response_id": "resp_02f977b4e68b（多轮对话时填上一轮响应 ID，与 conversation 二选一）",
    "conversation": "conv_64a8b2c9（会话 ID，与 previous_response_id 二选一）",
    "prompt": {
        "id": "pmpt_67a4b3c9",
        "version": "2",
        "variables": {
            "city": "北京"
        }
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/v1/responses' \
--header 'Accept: application/json' \
--header 'Authorization: sk-' \
--header 'Content-Type: application/json' \
--data '{
    "model": "gpt-6.1-sol",
    "input": [
        {
            "role": "user",
            "content": [
                {
                    "type": "input_text",
                    "text": "今天的科技行业有哪些重要新闻？"
                }
            ]
        }
    ],
    "instructions": "你是一个乐于助人的中文助手，回答保持简洁准确。",
    "max_output_tokens": 4096,
    "max_tool_calls": 3,
    "temperature": 1,
    "top_p": 1,
    "stream": false,
    "stream_options": {
        "include_obfuscation": false
    },
    "tools": [
        {
            "type": "web_search"
        }
    ],
    "tool_choice": "auto",
    "parallel_tool_calls": true,
    "reasoning": {
        "effort": "medium",
        "summary": "auto"
    },
    "text": {
        "format": {
            "type": "text"
        },
        "verbosity": "medium"
    },
    "truncation": "disabled",
    "metadata": {
        "scene": "api-doc-demo"
    },
    "store": true,
    "background": false,
    "include": [
        "reasoning.encrypted_content"
    ],
    "service_tier": "auto",
    "safety_identifier": "user-hash-001",
    "user": "user-123",
    "prompt_cache_key": "cache-001",
    "top_logprobs": 5,
    "previous_response_id": "resp_02f977b4e68b（多轮对话时填上一轮响应 ID，与 conversation 二选一）",
    "conversation": "conv_64a8b2c9（会话 ID，与 previous_response_id 二选一）",
    "prompt": {
        "id": "pmpt_67a4b3c9",
        "version": "2",
        "variables": {
            "city": "北京"
        }
    }
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "id": "resp_02f977b4e68bf7ac016aed83a1491487d08c4d3602c05fb2c3",
    "object": "response",
    "created_at": 1793950625,
    "status": "completed",
    "error": null,
    "incomplete_details": null,
    "instructions": null,
    "max_output_tokens": null,
    "model": "gpt-6.1-sol",
    "output": [
        {
            "type": "reasoning",
            "id": "rs_014b4b3f8a8c9de902f0135ad57e",
            "summary": []
        },
        {
            "type": "message",
            "id": "msg_014b4b3f8a8c9de902f0135ad57e",
            "status": "completed",
            "role": "assistant",
            "content": [
                {
                    "type": "output_text",
                    "text": "你好！很高兴见到你。有什么我可以帮忙的吗？",
                    "annotations": []
                }
            ]
        }
    ],
    "parallel_tool_calls": true,
    "previous_response_id": null,
    "reasoning": {
        "effort": null,
        "summary": null
    },
    "store": true,
    "temperature": 1.0,
    "text": {
        "format": {
            "type": "text"
        }
    },
    "tool_choice": "auto",
    "tools": [],
    "top_p": 1.0,
    "truncation": "disabled",
    "usage": {
        "input_tokens": 12,
        "input_tokens_details": {
            "cached_tokens": 0
        },
        "output_tokens": 16,
        "output_tokens_details": {
            "reasoning_tokens": 0
        },
        "total_tokens": 28
    },
    "user": null,
    "metadata": {},
    "service_tier": "auto"
}

修改于 2026-11-08 03:13:36

PDF文件分析

Response_Format

联网搜索 Web Search

模型与官方文档#

请求参数

请求示例代码

返回响应

模型与官方文档