Webové vyhledávání v reálném čase zaměřené na AI.
BytePlus
Web search and page content retrieval.
Webové vyhledávání v reálném čase zaměřené na AI.
Spouští webové vyhledávání v reálném čase vytvořené pro agenty AI a vrací seřazený seznam výsledků s titulky, odkazy a úryvky. Query je povinné; zúžte sadu výsledků pomocí Count (≤ 20), Filter (omezit na Sites nebo vyloučit BlockHosts), Language a TimeRange. Odpověď obaluje ResponseMetadata.RequestId a seznam Result s webovými výsledky. Použijte pro augmentaci retrieval v RAG, monitoring konkurence/PR, ověřování faktů a získávání obsahu; každou URL výsledku spárujte s post_byteplus_fetch, abyste získali plný obsah stránky.
Referenční údaje o cenách
- Měření: pevná nákladová základna za úspěšný požadavek.
- Referenční odhad požadavku: USD 0.0048.
- Referenční multiplikátor pro zákazníka: 1.0. Znovu jej neaplikujte na již zúčtovanou částku zákazníka.
Pouze referenční metadata — nejde o nabídku pro účet, garantovanou cenu ani limit útraty. Kredity prostředků nejsou kredity Felo. Konečné účtování se řídí fakturačními záznamy Felo.
- Typ: stringQuerymaximální délka:400povinné
Vyhledávací dotaz. Povinné. Max. 400 znaků; upstream engine jej také fakticky omezuje na přibližně 50 slov.
- Typ: integerCountmax:20
Počet výsledků k vrácení. Volitelné; výchozí 10, maximálně 20.
- Typ: objectFilter
Volitelný filtr výsledků. Obě pole jsou řetězce plných domén oddělené svislou čarou (max. 5 v každém).
- BlockTyp: string
Hosts Vyloučí výsledky z těchto plných domén. Oddělené svislou čarou, max. 5, např. "reddit.com|quora.com".
- SitesTyp: string
Omezí výsledky na tyto plné domény. Oddělené svislou čarou, max. 5, např. "bytedance.com|byteplus.com". (Odeslání pole vrací 10400 Invalid Parameter.)
- Typ: stringLanguage
Volitelný jazykový hint ve formátu upstream, např. EN, ZH-HANS, ZH-HANT.
- Time
Range Volitelné okno aktuálnosti. Jedno z pojmenovaných oken OneDay / OneWeek / OneMonth / OneYear, nebo vlastní rozsah "YYYY-MM-DD..YYYY-MM-DD". Ponechte prázdné, pokud nechcete filtr času. POZNÁMKA: hodnoty jako "week"/"month" jsou v upstreamu tiše ignorovány.
- Typ: string enum
Volitelné okno aktuálnosti. Jedno z pojmenovaných oken OneDay / OneWeek / OneMonth / OneYear, nebo vlastní rozsah "YYYY-MM-DD..YYYY-MM-DD". Ponechte prázdné, pokud nechcete filtr času. POZNÁMKA: hodnoty jako "week"/"month" jsou v upstreamu tiše ignorovány.
hodnoty- One
Day - One
Week - One
Month - One
Year
- Typ: object200
Vyhledávání proběhlo úspěšně.
Resultobsahuje seřazené webové výsledky.- Typ: objectResponse
Metadata Metadata požadavku upstream.
- ActionTyp: string
- RegionTyp: string
- RequestTyp: string
Id Jedinečný identifikátor tohoto požadavku.
- ServiceTyp: string
- VersionTyp: string
- Typ: objectResult
Payload výsledku vyhledávání.
- ChoicesTyp: array object[] | null
Vyhrazeno; null, pokud se neuplatní.
Prázdný objekt - LogTyp: string
Id ID logu upstream (rovná se ResponseMetadata.RequestId).
- ResultTyp: integer
Count Počet vrácených webových výsledků.
- SearchTyp: object
Context Echo vyřešeného kontextu dotazu.
- OriginTyp: string
Query - SearchTyp: string
Type
- TimeTyp: integer
Cost Doba zpracování upstream v milisekundách.
- UsageTyp: object | null
Vyhrazeno; null, pokud se neuplatní.
- WebTyp: array object[]
Results Seřazený seznam webových výsledků.
- IdTyp: string
Neprůhledné ID výsledku.
- LogoTyp: string
Url Podepsaná URL loga webu (časově omezená).
- PublishTyp: string
Time Čas publikace v ISO 8601 (může být prázdný).
- PublishTyp: integer
Time Unix Čas publikace v unixových sekundách (0, pokud není znám).
- SiteTyp: string
Name Název zdrojového webu (může být prázdný).
- SnippetTyp: string
Krátký úryvek textu ze stránky.
- SortTyp: integer
Id Pořadí výsledku počínaje 1.
- SummaryTyp: string
Delší shrnutí obsahu stránky.
- TitleTyp: string
Titulek výsledku.
- UrlTyp: string
URL výsledku.
application/json - 400
Požadavek se nepodařilo zpracovat. Zkontrolujte parametry požadavku.
- 401
Je vyžadován platný API klíč Felo.
- 402
V požadavku nelze pokračovat, protože není splněn požadavek na fakturaci.
- 403
Účet nemá oprávnění tuto operaci provést.
- 429
Byl dosažen limit požadavků nebo útraty.
- 502
Služba nemohla požadavek dokončit.
- 503
API nebo fakturační služba je dočasně nedostupná.
- 504
Při zpracování požadavku vypršel časový limit služby.
- default
Chybová odpověď; odpovědi předávané přímo od upstream poskytovatele mohou používat formáty poskytovatele
application/json
curl https://openapi.felo.ai/v1/beta/byteplus/web-search \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '{
"Query": "OpenAI news"
}'
{
"ResponseMetadata": {
"RequestId": "20260904155503A787EC832774768DC56F",
"Action": "",
"Version": "",
"Service": "",
"Region": ""
},
"Result": {
"ResultCount": 3,
"WebResults": [
{
"Id": "19b903d59c017bbb04c7832574500d49",
"SortId": 1,
"Title": "OpenAI News | OpenAI",
"SiteName": "OpenAI",
"Url": "https://openai.com/news/",
"Snippet": "Stay up to speed on the rapid advancement of AI technology and the benefits it offers to humanity.",
"Summary": "Stay up to speed on the rapid advancement of AI technology and the benefits it offers to humanity.",
"PublishTime": "2026-09-03T07:50:20+08:00",
"PublishTimeUnix": 1788393020,
"LogoUrl": "https://p16-bpsearch-sign.ibyteimg.com/...<signed>"
}
],
"SearchContext": {
"OriginQuery": "OpenAI latest news",
"SearchType": "web"
},
"TimeCost": 935,
"LogId": "20260904155503A787EC832774768DC56F",
"Choices": null,
"Usage": null
}
}