Chat（Search online）

POST

/chat/completions

Add internet search capability to all models. There are two ways to enable this feature, and you can choose either one:

Append -web-search to the model suffix, e.g., gpt-3.5-turbo-web-search (convenient for third-party software)

Include the parameter "web-search": true in the model request, as shown in the example (convenient for API usage)

Note: If the model suffix includes -web-search but "web-search" is set to false, the internet search functionality will also be disabled.
(Can be used together with -ocr, e.g., deepseek-r1-ocr-web-search)

Supported Parameters:
search-service: Search service provider

Supported list:
search1api（default）
tavily
exa
bocha

search-results: Number of search results

Default is 10, optional range is 1-20

search-include-sites: Whitelist for search (not supported by Bocha)

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

search-exclude-sites: Blacklist for search (not supported by Bocha)

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

*The principle behind this feature is: Before each request, keywords are extracted from the user's conversation, followed by a search. The results from the search engine are then incorporated into the model's context as reference information. The detailed process can be viewed in the logs during API calls.

Price: Original model cost + search API fees

Request

Header Params

Body Params application/json

Example

{
  "model": "gpt-3.5-turbo-web-search",
  "search-service":"search1api",
  "web-search":true,
  "messages": [{"role": "user", "content": "2025年美国总统是谁"}]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.302.ai/v1/chat/completions' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer sk-jls4AaVBGoe1GwZD64qZA1qyKTN1MPHa4NmvH1cT68z7K1Zz' \
--header 'Content-Type: application/json' \
--data-raw '{
  "model": "gpt-3.5-turbo-web-search",
  "search-service":"search1api",
  "web-search":true,
  "messages": [{"role": "user", "content": "2025年美国总统是谁"}]
}'

Responses

🟢200OK

application/json

Body

Example

{
    "id": "chatcmpl-123",
    "object": "chat.completion",
    "created": 1677652288,
    "choices": [
        {
            "index": 0,
            "message": {
                "role": "assistant",
                "content": "\n\nHello there, how may I assist you today?"
            },
            "finish_reason": "stop"
        }
    ],
    "usage": {
        "prompt_tokens": 9,
        "completion_tokens": 12,
        "total_tokens": 21
    }
}

Modified at 2025-03-19 02:38:35

API Migration Guide

Chat（Depth-First Search）