Web 搜索

通过聊天补全接口调用支持联网检索的模型，让模型在生成回复时结合公开网页信息。

接口地址

POST https://www.vortapapi.com/v1/chat/completions

请求头

名称	必填	说明
Authorization	是	使用 Bearer Token 进行鉴权，格式为 Bearer sk-***
Content-Type	是	请求体格式，固定为 application/json

请求体

参数	类型	必填	说明
model	string	是	要调用的模型名称。请选择支持 Web 搜索能力的模型。
messages	array	是	对话消息列表。
stream	boolean	否	是否以流式方式返回结果，默认 false。
temperature	number	否	控制输出随机性，值越高回复越发散。
max_tokens	integer	否	限制模型最多生成的 token 数。

messages 对象

字段	类型	必填	说明
role	string	是	消息角色，例如 system、user、assistant。
content	string	是	消息内容。

示例请求

curl https://www.vortapapi.com/v1/chat/completions \
  -H "Authorization: Bearer sk-***" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o-search-preview",
    "messages": [
      {
        "role": "system",
        "content": "你是一个擅长联网检索并总结信息的助手。"
      },
      {
        "role": "user",
        "content": "请搜索并总结今天人工智能领域的重要新闻。"
      }
    ]
  }'

示例响应

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "created": 1710000000,
  "model": "gpt-4o-search-preview",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "以下是今天人工智能领域值得关注的几条新闻摘要：..."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 52,
    "completion_tokens": 180,
    "total_tokens": 232
  }
}

流式请求示例

curl https://www.vortapapi.com/v1/chat/completions \
  -H "Authorization: Bearer sk-***" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o-search-preview",
    "stream": true,
    "messages": [
      {
        "role": "user",
        "content": "请搜索最近关于量子计算商业化的进展，并用要点总结。"
      }
    ]
  }'

注意事项

• Web 搜索能力取决于所选模型，请确保 model 参数使用支持联网检索的模型。
• 若启用 stream: true，响应会以事件流形式逐步返回内容。
• Authorization 请求头必须携带有效的 Vortap API Key。
• 请求体必须是合法 JSON，并将 Content-Type 设置为 application/json。