跳转到主要内容

​
1️⃣ 实时联网支持：突破 LLM 时效限制，让输出更准确、更可靠

我们为 OpenAI 和 Gemini 系列大模型接口带来了获取最新网络信息的能力，帮助你：
✅ 获取最新资讯：无论是今日热点、最新研究还是实时数据，都能即时获取
✅ 消除知识盲区：突破大模型训练数据的时间限制，获取训练后的新信息
✅ 降低幻觉风险：基于实时网络搜索的事实回答，大幅减少 AI 已读乱回的可能性
✅ 提升决策质量：基于最新事实的分析和建议，让你的决策更有把握 支持的模型： 目前支持 OpenAI 和 Gemini 大模型系列，包含两种接入方式： 1. 原生搜索能力模型： Gemini 系列 (Ground with Google search)：
  • gemini-3.1-pro-preview-search
  • gemini-3-flash-preview-search
  • gemini-2.5-pro-search
  • gemini-2.5-flash-search
OpenAI 系列 (Search Preview)：
  • gpt-4o-search-preview
  • gpt-4o-mini-search-preview
2. 参数支持方式： 增加参数 web_search_options={}，可为支持该参数的 gemini、OpenAI 大模型开启联网能力。若返回 Unknown parameter: 'web_search_options'，说明当前模型或上游接口不接受该参数，请换用上方原生搜索模型，或使用下文 :surfing 后缀方式。Gemini 系列的搜索费率请以控制台和模型详情页展示为准。

​
使用方法

使用前需要运行 pip install -U openai 升级 openai 包，并将 AIHubMix API Key 写入环境变量： 
export AIHUBMIX_API_KEY="<AIHUBMIX_API_KEY>"
Windows PowerShell： 
setx AIHUBMIX_API_KEY "<AIHUBMIX_API_KEY>"
示例： 
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["AIHUBMIX_API_KEY"], # 换成你在 AiHubMix 生成的密钥
    base_url="https://aihubmix.com/v1"
)

chat_completion = client.chat.completions.create(
    model="gemini-3.5-flash",
    # 🌐 启用搜索
    web_search_options={},
    messages=[
        {
            "role": "user",
            "content": "搜索大模型 API 平台 AIhubmix 的相关资讯，简短介绍，并提供相关链接。"
        }
    ]
)

print(chat_completion.choices[0].message.content)

​
2️⃣ 智能冲浪：让 AI 自由驰骋互联网

通过在模型 id 后方追加 :surfing，让任何大语言模型具备搜索能力。
  • 追加后缀即可，不需要复杂的整合
  • 这种方式会默认将用户请求转发给 Tavily 搜索服务，LLM 根据返回的搜索结果参考作答
  • 搜索费用 0.006 美元/次
  • 目前「日志明细」里未列出每次搜索的费用，费用直接在「额度变动」扣取，后续会列出
模型 id 在模型广场中复制即可。
示例： 
import requests
import json
import os

try:
    response = requests.post(
        url="https://aihubmix.com/v1/chat/completions",
        headers={
            "Authorization": f"Bearer {os.environ.get('AIHUBMIX_API_KEY')}",
            "Content-Type": "application/json",
        },
        json={
            "model": "gpt-5.5:surfing", # 模型 id 后面追加 :surfing 即可支持搜索
            "messages": [
                {
                    "role": "user",
                    "content": "搜索 AIHubMix 最近的模型更新，返回中文要点并附来源链接。"
                }
            ],
            "stream": False
        },
        timeout=60
    )

    result = response.json()
    if response.status_code >= 400:
        print("请求失败：", response.status_code)
    print("API 响应：", json.dumps(result, ensure_ascii=False, indent=2))

except requests.exceptions.RequestException as e:
    print(f"请求错误：{e}")
except json.JSONDecodeError as e:
    print(f"JSON 解析错误：{e}")
except Exception as e:
    print(f"其他错误：{e}")
API 响应示例： 
{
  "id": "chatcmpl-xxxx",
  "model": "gpt-5.5-2026-04-24",
  "object": "chat.completion",
  "created": 1760000000,
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "AIHubMix 是一个聚合多家模型能力的 API 平台，官网为 https://aihubmix.com。"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 220,
    "completion_tokens": 240,
    "total_tokens": 460,
    "prompt_tokens_details": {
      "audio_tokens": 0,
      "cached_tokens": 0
    },
    "completion_tokens_details": {
      "accepted_prediction_tokens": 0,
      "audio_tokens": 0,
      "reasoning_tokens": 196,
      "rejected_prediction_tokens": 0
    }
  }
}
更新时间：2026-06-15