Chat(オンライン検索) - 302.AI API 書類

すべてのモデルにインターネット検索機能を追加します。この機能を有効化する方法は2つあり、どちらかを選択してください：

1.モデルのサフィックスに「-web-search」を追加する。例：gpt-3.5-turbo-web-search（サードパーティソフトウェアに便利）
2.モデルリクエスト時にパラメータ "web-search": true を追加する。例を参照（API利用に便利）

注意: モデルのサフィックスに「-web-search」が含まれていても、"web-search" が false に設定されている場合、インターネット検索機能は無効になります
（-ocr と併用可能。例：deepseek-r1-ocr-web-search）

対応パラメータ:
search-service: 検索サービスプロバイダー

対応リスト：
search1api（デフォルト）
tavily
exa
bocha

search-results: 検索結果の件数

デフォルトは10、選択可能範囲は1～20

search-include-sites: 検索ホワイトリスト（Bochaでは非対応）

["arxiv.org", "paperswithcode.com"]

search-exclude-sites: 検索ブラックリスト（Bochaでは非対応）

["arxiv.org", "paperswithcode.com"]

*この機能の原理は、各リクエストの前にユーザーの会話からキーワードを抽出し、その後検索を行い、検索エンジンの結果をモデルのコンテキストに組み込んで参考情報として活用するものです。詳細なプロセスはAPI呼び出し時のログで確認できます。

価格：元のモデル料金＋検索API料金

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Body

Example

{
    "choices": [
        {
            "content_filter_results": {
                "hate": {
                    "filtered": false,
                    "severity": "safe"
                },
                "self_harm": {
                    "filtered": false,
                    "severity": "safe"
                },
                "sexual": {
                    "filtered": false,
                    "severity": "safe"
                },
                "violence": {
                    "filtered": false,
                    "severity": "safe"
                }
            },
            "finish_reason": "stop",
            "index": 0,
            "logprobs": null,
            "message": {
                "annotations": [],
                "content": "2025年美国总统是唐纳德·特朗普（Donald Trump）。他在2024年总统选举中以312张选举人团票击败民主党副总统卡玛拉·哈里斯的226张，并赢得普选票，于2025年1月20日正式宣誓就任美国第47任总统，标志着他时隔四年再次成为白宫主人[2][4][8]。他的第二次就职典礼是第60届美国总统就职典礼，在华盛顿特区举行[5][7]。就职演说中，特朗普强调“美国优先”，宣告“黄金时代从现在开始”，并表达了强烈的国内外政策雄心[4][8][10]。",
                "refusal": null,
                "role": "assistant"
            }
        }
    ],
    "citations": [
        "https://zh.wikipedia.org/wiki/%25E5%2594%2590%25E7%25B4%258D%25C2%25B7%25E5%25B7%259D%25E6%2599%25AE",
        "https://zh.wikipedia.org/zh-hans/%25E5%25B7%259D%25E6%2599%25AE%25E7%25B8%25BD%25E7%25B5%25B1%25E7%25AC%25AC%25E4%25BA%258C%25E4%25BB%25BB%25E6%259C%259F",
        "https://www.news.cn/world/20260120/1b669673a3944a42b7df681771032df8/c.html",
        "https://www.bbc.com/zhongwen/articles/cevedz2wwk2o/trad",
        "https://baike.baidu.com/item/2025%25E5%25B9%25B4%25E7%25BE%258E%25E5%259B%25BD%25E6%2580%25BB%25E7%25BB%259F%25E5%25B0%25B1%25E8%2581%258C%25E5%2585%25B8%25E7%25A4%25BC/65212735",
        "https://www.president.gov.tw/News/28839",
        "https://zh.wikipedia.org/wiki/2025%25E5%25B9%25B4%25E7%25BE%258E%25E5%259C%258B%25E7%25B8%25BD%25E7%25B5%25B1%25E5%25B0%25B1%25E8%2581%25B7%25E5%2585%25B8%25E7%25A6%25AE",
        "https://www.aseancenter.org.tw/post/2025%25E5%25B9%25B4%25E7%25BE%258E%25E5%259C%258B%25E7%25B8%25BD%25E7%25B5%25B1%25E5%25B7%259D%25E6%2599%25AE%25E5%25B0%25B1%25E8%2581%25B7%25E6%25BC%2594%25E8%25AA%25AA%25E9%2587%258D%25E9%25BB%259E%25E6%2591%2598%25E8%25A6%2581",
        "https://www.abcdreamusa.com/2025%25E7%25BE%258E%25E5%259B%25BD%25E6%2580%25BB%25E7%25BB%259F%25E5%25B0%25B1%25E8%2581%258C%25E5%2585%25B8%25E7%25A4%25BC-%25E6%2597%25B6%25E9%2597%25B4-%25E9%2597%25A8%25E7%25A5%25A8-%25E7%259B%25B4%25E6%2592%25AD-%25E6%2594%25BE%25E5%2581%2587%25E5%25AE%2589%25E6%258E%2592/",
        "https://cn.nytimes.com/usa/20250121/trump-sworn-in-president/"
    ],
    "created": 1769163760,
    "id": "chatcmpl-D18bIDMigtz5H39S9uE6EyRbwWTxa",
    "model": "gpt-3.5-turbo",
    "object": "chat.completion",
    "prompt_filter_results": [
        {
            "content_filter_results": {
                "hate": {
                    "filtered": false,
                    "severity": "safe"
                },
                "self_harm": {
                    "filtered": false,
                    "severity": "safe"
                },
                "sexual": {
                    "filtered": false,
                    "severity": "safe"
                },
                "violence": {
                    "filtered": false,
                    "severity": "safe"
                }
            },
            "prompt_index": 0
        }
    ],
    "system_fingerprint": "fp_3dcd5944f5",
    "usage": {
        "completion_tokens": 167,
        "completion_tokens_details": {
            "accepted_prediction_tokens": 0,
            "audio_tokens": 0,
            "reasoning_tokens": 0,
            "rejected_prediction_tokens": 0
        },
        "prompt_tokens": 1323,
        "prompt_tokens_details": {
            "audio_tokens": 0,
            "cached_tokens": 0
        },
        "total_tokens": 1490
    }
}