Deprecated Plugin ApproachThe web search plugin (
plugins: [{ id: "web" }]) shown below is deprecated. Use the openrouter:web_search server tool instead, which works with both the Chat Completions and Responses APIs via the tools array.Web Search Plugin
Enable web search using theplugins parameter:
const response = await fetch('https://openrouter.ai/api/v1/responses', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_OPENROUTER_API_KEY',
'Content-Type': 'application/json',
},
body: JSON.stringify({
model: 'openai/o3',
input: 'What is OpenRouter?',
plugins: [{ id: 'web', max_results: 3 }],
max_output_tokens: 9000,
}),
});
const result = await response.json();
console.log(result);
import requests
response = requests.post(
'https://openrouter.ai/api/v1/responses',
headers={
'Authorization': 'Bearer YOUR_OPENROUTER_API_KEY',
'Content-Type': 'application/json',
},
json={
'model': 'openai/o3',
'input': 'What is OpenRouter?',
'plugins': [{'id': 'web', 'max_results': 3}],
'max_output_tokens': 9000,
}
)
result = response.json()
print(result)
curl -X POST https://openrouter.ai/api/v1/responses \
-H "Authorization: Bearer YOUR_OPENROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "openai/o3",
"input": "What is OpenRouter?",
"plugins": [{"id": "web", "max_results": 3}],
"max_output_tokens": 9000
}'
package main
import (
"bytes"
"encoding/json"
"fmt"
"io"
"net/http"
"os"
)
func main() {
body, _ := json.Marshal(map[string]any{
"model": "openai/o3",
"input": "What is OpenRouter?",
"plugins": []map[string]any{{"id": "web", "max_results": 3}},
"max_output_tokens": 9000,
})
req, _ := http.NewRequest("POST", "https://openrouter.ai/api/v1/responses", bytes.NewReader(body))
req.Header.Set("Authorization", "Bearer "+os.Getenv("OPENROUTER_API_KEY"))
req.Header.Set("Content-Type", "application/json")
resp, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
result, _ := io.ReadAll(resp.Body)
fmt.Println(string(result))
}
Output
{
id: "gen-1794947622-R1UKdLTSjFyYjQajS9Bm",
object: "response",
created_at: 1794947622,
model: "openai/o3",
status: "completed",
completed_at: 1794947669,
output: [
{
id: "rs_0d99c78179edda6f016afcba27385c87d1988c07dea5d818c3",
type: "reasoning",
status: "completed",
summary: [Array ...],
encrypted_content: "gAAAAABq_LopR38QmXbJBWfy2eNwXGqoi-G5qJY0hmuVz4R4jg45tgAZAjGQm-dReq6TWssUI1cg1Zrt1hQX9sN6bS330WT0U_b6tADJjpGtypEur4YdXnVvHKOikmC4C-6j5De0Ovki_BpkYaKqK-eihaQ18plHe7YONbZl7JJAVJQY5Pc4hycfKUCqXGDhku9Nn838xMIHFCm3U0-BVwqKY3OYmToP2uEB1OB1swz4eIYPKahmoWB-E0tg723x1kPnfVt5DQHsYkasDF3lyd6FH8d0M9vS-XyyDjlKv8dxZdXADviKnkOt5k0LoUi6flonsSedlN5fnyO_S8Sj6hYHYBWfnTtWCwRwLRe8epYWu_syxLDUAAGb5DyLTwpGvmBi74VgIhuo7IF3pUrOZ15E-VjzWKCQb1hM8ybIxLeNKz3zkZSP08aSk3s9BPLl7MMg9nSSpqd_Ac7WABVVFehxLLUE7hWeIDnrgbuijC--SsEop1pFDJBzPAZjql_D1fywyPFs_5MTLcUPmkg6NUq36mms-QxySFq2scscb2O1RRbW_7jfm1AgDluIo0pTzmSUYiyCnauFsY5H6K-RRRVsgrodoZBEMv-c2DKMjlXiDCklYTTDaPxVCxA3WOoFVl_qh4WEF05hsB9lqkf60nuAUhlH-FWXDiGv0686Djq1tBKV6M1NOovN81VjzvO6zKHXhu_uSPFxx34AXaavUaq3Cz31lkTCP96TbJSQxlQ8q1q6gBjKhE5jkoiZJ4M_9S5m5CP8-eERBk2f1zFXMd2oRvW_wAvyyyXif6IwuDMep8LH_ZrMGKy5NhR88JKZnJ0kSvvyUDqdIm-QiO3TeE75DrVl75zBAygaa8VF58uJiCRfZpB1KAV0nawnc_aXUFfnCRzgCKXF9KdRs2o5lDuM4oPFDWxY1xxn5pJVt05oMnh_XgH-aLjUCOeQe8dGCgmcZn9l3huWhoxsM6xR0npe6_dPpo6iT8EANgL4stiFlEDN0u0za0cFP_WrS4U58u6HBGYo2aZq-7U33jiSD2cpJqlDFf86mbPHk8uDWobkzsitB0WWeeSeR4b8sTTF9naoIIOhNFna7qaluhn3lmJkppnpyPe8Y_LRvB81L211USZOYUA_zAHQoz8dS4EUTboIyp1fjJ3GT-JLguFW_8RpvPo09tENEi7jv9DNMlMJFeapjfxXyJehSI7sjm0odhK889AkhEJ07IEtv4wAAO7yOrRiYlD8e7E4RTo0Z-Zl1R_NTJeLsmI9OsARXetmerHCgABm4Y9PEP6oKWOiP6x9MfYB3Zdn4gQ6wVuzWMxCJmmU9xI_prKM1uwMbyR4DRkqUsbzmiYgb2JodhmXbXnIUrsOH26mKi13y0A8ac7K67bbctB89uAocgY9QZ3wEEey7onhDi4Zj90tQZV7UIhXWfxlVV7SERcQh66AhmJrfnaDX-qn7cD1Vc-_Fm4PGn04KRVCTe2RFKz-pGiqqVZKiIQXWSVLRwyo0NMel4Xqq9TyuZ3nO_TQOOl5zFqC0qcOAF67UbLRIImEGnOxBq0xD6xcn6zneiY_FOXcs3q6YzXVKIzuHloe4hP5mEpq_TX2NiuoZwOiIhXGDmHSWts7CBHxmHAlaGK479pvzlYnQvcRmwVM7yCrrSRCA_L_vhiZ2DRy8CghFb9gAK9GlIkXiPyvwP-W10SoRkK1iZqISmucfXDSEx9Stu2qRdryI7KPf52n5cdgz2UkNBuT412YchpdvkVa343PikRtgoA0KlDbtQN14auOQcL9HvoKWuK8b5QqMilEcVm765vnSvj0SqzywEjuGjaSpcdbyPtp528k-ekexBuylq0QeQcrgmMmJ40iRG886XyuG89lLr29zB11aUZQ9OIEo4PlNXQIN2UwLL57AO1tGVgd7vAtQCmi1zDrFoI3HLnrVZze0Gjrtzyvo7stN5UZndJreEoQ-ejVAofmMedk0Go3htkgHD0QQmQpb8y_nQRMvPzV7ezMZXC9-Cp12AJRV7mLW856B6Ih93fjm9kzVEfjZlVgyYRwu3rsLYOX0jFgdxQGFvx_YGE66gSwzrpis5svsxmVlaaEIF-2FWG_imUqctrnXck_nIxk5EOU-2gCwtE_ZtTfXjrRj1KZhpjYvjNBJfRTbN5cPjdpJ5dORqwjl9woWuv85yTNewlskW-3n48Mb4WlIN67F5buYnBhAMIM8giLFs0_b4pLeZDOf3li6Nwloc-zg_DjlvYEZczyHOc3RSvygbOIFpVpE6g0ceHxBIhSNPtuqiHLQKoBlNaz2CI5QquVhyTgXVyJwP0_vpmfchkkuRIanay4UwpCY8lWPcn3SwZDbSw-4f2OsZ_AD4H2-pRkDacRDV81UTMJy_C_DoJO8xFywN1FVzQ4b20h0SBo-epH6uArfoz_DZK1Mtglo8Ckkk7itGJDPJ3rYpFvkFpNP7ydzOzzZw==.eyJlbmRwb2ludF9zbHVnIjoib3BlbmFpL28zLTIwMjUtMDQtMTZ8b3BlbmFpIn0",
format: "openai-responses-v1",
}, {
type: "web_search_call",
id: "ws_0d99c78179edda6f016afcba29173887d1b6a5f8bb05654ae3",
status: "completed",
action: [Object ...],
}, {
id: "rs_0d99c78179edda6f016afcba2a6f1887d1afe803c216022cd7",
type: "reasoning",
status: "completed",
summary: [],
encrypted_content: "gAAAAABq_LoqACxNzvcP7wJoMnD286k-cSTImHV5a48nKnebIBW3AjNp-ShGMi0NwiDRVpVwf7yiOpDepmgpYP5CeqF-4cXcly972mnYEcXTKJXAFyKXj-wSdN0__MXH-i3cgodxw8RjsBqb0mmiYc53yG0D1s_OB99_Fst920cKQcFNDwLkA22zldx4zLCZqCZLnl4MbEmP4iQYnBeADQhE8P5D0Xx_I8CIohHoOY5ohC011A_PPaHRM4l0MLMZkdPbxw-Do4PMkcnTo584HdZQCYdgW2u6YnmyqQX0ZuWlWO64UToAgAJTrT4aEdNrOLkOwGDXJi7jpnkfxM5N5UhoP1NAe7qh4QZUFW1egU7pxTTNzYm2pASqnVhDiTTCthwX91iAYEhN_OdlcaDO5qip74rHM08uJTxybIwx7Xa_82IZZLdxD-g9aQSTCaGCXnRw4lovUpJeDvlo5CC3nf_mZxzHEp6AmKMzzVsyDg1qebCz34MJ1Hb9c043ire5bPVyM90iybNktfyKDo5jTsiiUml9BhYrl5YgCUt3bvpvThMiE0Zv_-Qh52B8fo2vXopsw8U2dZ05zEFWGIFrmSU7n_YTnHE0GIMbRMXQuywI7LTy-HDiTyv3ygy57huNJ0h7dscta9IFDCc7LCMud0cQTXAHP31QWg1wGjcLrZrtVUiK_WDMGdG85L2W6Qlwjka9tHeJdI8hK5A71CVjWCRD5Eyr97
…[37396 chars clipped]…
6TRexGPLR9Pym-g-019SwjGv5Vpxb1Sb1HCZdDF2GeIoReyfsBEFEgx8QH63MbpkVBZnVCGW19kBvwmpXwkcnz1MaQjsY1XEf9PR9eXmNlsN0zUNxFZyyOOvptwqg1HM8x2IvVpGJ1N6rNKV0LSg3IveLx7wG3JDL25VDPbKx9vp3LHSL7UgaWiyDxQWnRseJE81RCQzO-y4QhMsFqi1NRH1IeU_HPSmv65CfcKpnkhla30QgHIGcT8ULDGQR9zXw7ODgi-ld0RTqb8RngqNogo_ws4zZo2QxTlCpmKqRSVZT4Rspca72Qidh129PRp2x7-j7NMIqaa2a122LIrCf7NUorkc-56A_mfa7i2Y1BrglPMpkkzW6gAWmr8EQNdUXDzhzIZah49vH34rwe8ip5qSqIXPiii7mN-GiNG9ZFj-8E87wY3lMWh9dDTdjIzyk2w58j2OILB3-v31_hv0YQ1CdFJlR7XR_NOGawQhqEk0gpK9mDgvo0GxoBxojhLM6o-TEPK5gt1Nq1UOuV_0P2b_Dvs3ALJvXZG0C9PQTqFcIzKFzvSnWT3XJSPT1MGexZEPKqQykCg-kv4HWk1iFSQ5ZqMsm5MQoz19JOii2wzM-1n4nyU5T-wzHK-TlixxIK_7Reos--qczEKTDaK0l_psIIdGOzuWyxiNU5lhOGW2TYMwqgN-tvMXpPyDK98FZdR0WmoQDYolyK-qaqYkCJBby-P2uHhv2D_LTC6UHkGRQX5x7HSkz6wVhvAoqR0RFTdY6Rn1eVm6cCRQLbYqCZOWQe07937kdeFn7t83zXajAqtz5pqhFXTJkspr9tw54T9AWCMaOHBpTHskfuWxZA2lhEGAiONnePVOjlbwZ2xi5Berp99-St1cDVW_wcy-Nfrdk9jJMKSAsBJJwQCTwsEWo1Cy2OrMPXW-pDar-3kwz1dQFK2NMyO3NTn5At-i51Z6p2-qtalMTa2Ph8xbzINvHzIwakuNVxyGczJDjNz3438EJIAezWr6y9ZVM2-Wgytm96Rc-25O02HIU3XWj_6nVObiGRQ-Lq3zG_xHX8k_0MBQwfA9U3MGe4rFnhhI58lTSPC_RSG3gg_4I-enFdOzqK4n2xySK3-cnr5uYDiNaT8xCFgmPLnwRusuonuyZS0SJKZCHDXOh8Q_wopJgsqVdkEc_KfBpA2juTD0URFz88or1JnTEcmKmIAcbwhv8vWkT4oi8h8WWZdYtCa1spnEjymlNuzqHQZ7dwXLzIxedH3onAvVB6TehUqNGteGnNacpQVHN5ao5zDMnCY9FfiBpAfmOtIomKOPsXzz92KQpKFSF70WhqTOWlkcRuznZcv5NFR9mg5VMrOdfdFuo-iwxKldW8E7LFIdjX38Cpk1iGSf0tenMjR8t9Qev5T1hbsIqo59PHIrEBf07410H_BGpGYZfre9B8WjLIkEpwVVQbzSZyxgFQGzhV7aET1sxeHaZFKKqqceoIx4YFqHc4W99CFphtKsayklgg2BM6abWt4KaxhEkcHLWRvvLyPJ98JPnzX-hhcIC22dZnxSJGTv3AB3NYv5AGA2d-XVXkfzJI1T71FpjofaeT-fnPRS0PPFnVcncp0FQiT3KpdmIfxbrgU1CN2u91EoevZ5p7XaPWexc0VpLAx_zX7B_19nOQiJYvS7ui4e0ZPMBKO3HhH6UMGCHZ-y4o_LJKaHijZ71qMAcOq9b1bPu26g2w3Wpb7BF6sDREtWnh9wsZP-kpnT0F4-8cfBerVgy5AeOeDMNggHSGBjtt8rNyskEth1FxPW12Dkp5sw4Ji55m9oEWr4pJi2Xzm3g0jwayKacneyoX05IzZ2hRq7XTBA6I8zne7YyoSRCZCOOcLHJ9QmzTHAzM6wghpnSL91EI3Ig21XlVZ2Kw6XHX9SaKH8rF6ColH3iQn3DqaQ20FWqw7kn0Ftg_J6KiQxe5Q8rnJQB7Ifi6GFrw_GYdKbh43GWH4PHKSOUnud4e05263cXS34tBLnYAvfq_uLfpzBInzJxpMboa8OqXdUFYl3wQJ6dcoR3FsLqDULrPBWtjAClUVyttidauNiTPCeZbeYlS8KduevC4sxrhk8sjiAq8Rs5_o6p0Cu94cGUReXwgO-c4CSSIf8j7CWHLjc_wMompY9V3Eom96_4wJ6K_9urX3n5TC2BD5uVfKMbC9CmcP1wBYSeK9w7TcBl0Ypqo1SseRwFiyinVYgn60CuGqsRRHraBU1w9KP7o6--Ib3W052qx-YgeWJXVdQDbnVc3TAbX17of0IggLFtx68rPCgt0OOMZaQqGbgCjn5aVgSWw_3SEq5HFDjMz238w5LzHLhXRFliX1BXmBX_BMccmvI-v-Y6XpiZNP3IEe6-BAHE9svmy46eb2zN6MCIMRmBtEZ_JZ4VehM7DH9LHAo4TjJMnkjWow91m0GYTL6vJqb9pXubzT3m_AtzAEE5cJh_ZJHh1-0lg7XFu2bSluDve_gX4SLFd34j2Vgk1ejZD5MFtnKcE5Kni3eIcW_oCumKI=.eyJlbmRwb2ludF9zbHVnIjoib3BlbmFpL28zLTIwMjUtMDQtMTZ8b3BlbmFpIn0",
format: "openai-responses-v1",
}, {
id: "msg_tmp_6i1ufooevbc",
type: "message",
role: "assistant",
status: "completed",
content: [Array ...],
}
],
error: null,
incomplete_details: null,
access_programs: {
Plugin Configuration
Configure web search behavior:| Parameter | Type | Description |
|---|---|---|
id | string | Required. Must be “web” |
engine | string | Search engine: "native", "exa", "firecrawl", "parallel", or omit for auto |
max_results | integer | Maximum search results to retrieve (1–25; 1–20 for Perplexity; default 5) |
include_domains | string[] | Restrict results to these domains (supports wildcards like *.substack.com) |
exclude_domains | string[] | Exclude results from these domains |
X Search (SpaceXAI only)
On SpaceXAI models (e.g.x-ai/grok-4.3), web search sends only SpaceXAI’s web_search tool. Add an x_search object to the plugin to also search X/Twitter. An empty object enables it with no filters:
{
"model": "~x-ai/grok-latest",
"input": "What are people saying about AI?",
"plugins": [
{
"id": "web",
"x_search": {
"allowed_x_handles": ["OpenRouterAI"],
"from_date": "2025-01-01",
"enable_image_understanding": true
}
}
]
}
parameters.x_search on the openrouter:web_search server tool. The legacy top-level x_search_filter request field still enables X search for backward compatibility. X search is opt-in because SpaceXAI bills it per item returned starting September 21, 2026 at 12:00 PM PT ($5 per 1,000 posts fetched and $10 per 1,000 user profiles fetched, replacing $5 per 1,000 tool calls).
| Parameter | Type | Description |
|---|---|---|
allowed_x_handles | string[] | Only include posts from these handles (max 20) |
excluded_x_handles | string[] | Exclude posts from these handles (max 20) |
from_date | string | Start date (ISO 8601, e.g. "2025-01-01") |
to_date | string | End date (ISO 8601, e.g. "2025-12-31") |
enable_image_understanding | boolean | Analyze images in posts |
enable_video_understanding | boolean | Analyze videos in posts |
allowed_x_handles and excluded_x_handles are mutually exclusive. See the Web Search plugin docs for full details.Structured Message with Web Search
Use structured messages for more complex queries:const response = await fetch('https://openrouter.ai/api/v1/responses', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_OPENROUTER_API_KEY',
'Content-Type': 'application/json',
},
body: JSON.stringify({
model: 'openai/o3',
input: [
{
type: 'message',
role: 'user',
content: [
{
type: 'input_text',
text: 'What was a positive news story from today?',
},
],
},
],
plugins: [{ id: 'web', max_results: 2 }],
max_output_tokens: 9000,
}),
});
const result = await response.json();
console.log(result);
import requests
response = requests.post(
'https://openrouter.ai/api/v1/responses',
headers={
'Authorization': 'Bearer YOUR_OPENROUTER_API_KEY',
'Content-Type': 'application/json',
},
json={
'model': 'openai/o3',
'input': [
{
'type': 'message',
'role': 'user',
'content': [
{
'type': 'input_text',
'text': 'What was a positive news story from today?',
},
],
},
],
'plugins': [{'id': 'web', 'max_results': 2}],
'max_output_tokens': 9000,
}
)
result = response.json()
print(result)
package main
import (
"bytes"
"encoding/json"
"fmt"
"io"
"net/http"
"os"
)
func main() {
body, _ := json.Marshal(map[string]any{
"model": "openai/o3",
"input": []map[string]any{
{
"type": "message",
"role": "user",
"content": []map[string]any{
{"type": "input_text", "text": "What was a positive news story from today?"},
},
},
},
"plugins": []map[string]any{{"id": "web", "max_results": 2}},
"max_output_tokens": 9000,
})
req, _ := http.NewRequest("POST", "https://openrouter.ai/api/v1/responses", bytes.NewReader(body))
req.Header.Set("Authorization", "Bearer "+os.Getenv("OPENROUTER_API_KEY"))
req.Header.Set("Content-Type", "application/json")
resp, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
result, _ := io.ReadAll(resp.Body)
fmt.Println(string(result))
}
curl -X POST https://openrouter.ai/api/v1/responses \
-H "Authorization: Bearer $OPENROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "openai/o3",
"input": [
{
"type": "message",
"role": "user",
"content": [
{
"type": "input_text",
"text": "What was a positive news story from today?"
}
]
}
],
"plugins": [{"id": "web", "max_results": 2}],
"max_output_tokens": 9000
}'
Output
{
id: "gen-1794947795-raccqSKZrZTOmwScm8z2",
object: "response",
created_at: 1794947795,
model: "openai/o3",
status: "completed",
completed_at: 1794947808,
output: [
{
id: "rs_0bc57cc43a11be42016afcbad412f487d1ad0153e2125432e6",
type: "reasoning",
status: "completed",
summary: [],
encrypted_content: "gAAAAABq_LrUxxIx6HeOqVfMbuUtpQ40cwkpIh3D0oY8u3IZsipQIG8qq5jP3hoQqCfQHNGP4YJR92nn364lumeknQOFMB5LND0CzibasZNidQvnCBQ03F4UVdKDP7Fq18TUHhLlKPa64QBmHW6g_TaglwNygX-LQM_B2-ju2GQxGA3otWrR_SqBptinWlj5zVFh8dVmy4lgohVxxK7s0GcQ1VH0Vlcizh1waV5vcW1o7A94rG8Ez_DalZaT04XuICW74_Pvx8gtVk8kk8nNfPeXaiM1i3l8MyBH-pTk5Mrt1osBRx6mCvJfJSME95roVfNaimY9ThqquWMqypJgYffmwuf7NMYSJox63-9iuqwdRfSHrPP1ASK_Ytgw_1WZfoztovP42JHcWccqLAOD2vkpNRg3NMqYiax6rKfxWbwqy5tZT3sHP9CCJztGPtLwptIRX18GlpZqjC0TMKN11iZJmmKPKCNP9btOz4cLRmzs-eBACZeFc6KSxZLg3aLmS5zMFjztqTeAb10VUDgtZyzJun2XpJaYUVT9eiR9QfHc-hFWB7i5zrTXhB5osu_pNyXrvvmJWiUIvxAPgdn35RB-uQiboZDc9YafL89TyRZhXbyG5TAhS_2zUY63qJzEkhz6IooT4u3gOIvRWQ3zOmkgnU_tqL2fgoYvrO3VHXZkiehvjFM_eKo0Uo9Kp6RUUlZZjtE_qDa8S2N-yeJAccnxHvfoaZ5aUl6idcbSvDrHd6VgMIvx5sLecYv-3PQkrH9sOOEeKgyUnurKySzTh4CK9J7dmNtK-XWxLsD4NKjZ3IrBV2kJrdxaW1JcuSw-tF60BUaTFbIZYjB5yZfqcn13pQiGlJjjQfKxOatQGDxkSM9SUuOt5Fay47kLlwSTn_d09Ld_aoAEIe-Dz5HSXurzG2mIO2r88IXvgVDVD2qsuq35qg6GgZXgCcNpSm-4qAL9Yz4CiZI67BvAclsAe4Vs5be4sLyb4zFmNG-O8ndDjhgn-2ywzw-kULbpAjTWE-FTvUEvbvAfiLs2j9lcHjr7wEdsMM7QRR7_Dow5HctOa2QjmQYNyKBT8CYN3rqi9tISde2mxTEAOjs5tJWsyVGjw0oS_ZYStcg5qIJNkXr3saiIja7YbROTfTb_ecy75j-wR495iC36IpRYvD00D3Op0JM-I-SQ2--Bia3_5dBs7kvg7zyRrK2w5VI0yO1mGeO1aKkw2l8J0MWhExA8T_l_ndx-J7jwxo2k-mqI9Ptp66dzssi_neFV4dDIHVlqFLQfZ9WMUsLW6gRXxbW3EH0a8Qjii8obCe_Nuy57CINRAOF49DvPD0TcIhjISxSJ2HuxSGxn5GrE0EkMjW9bL39X9DsFee-PlviJquOI0w76ftcZWAqijQoYGudyOKvrK38NRf9-NacTlyRATPlWgIkTlytq3IlIoRe7l-eTGS_5zOJa2nB1RrP143RykkiLtJUGhY_-z68bjVC0gOBdh36y3M0DCwKgmcJVwJbJiOrkJfBJBGzXc2oVJtvFbqkLZ5DDZg55A7FBW8rv4PXg-NIzWj2DYKkFA5zVpiYyPHj-mWPH5DxjD7XPr7Ou7DZC65L8nz26LnbJNNCAGLZZrQ08Zfpc3TIB42c1Jz62nJS_XZSIco2099AU-e4vyxecSQUSWPaEu6tWBJA7BcTSg8kXZXL3V8Xufkfnx_7-IP4L47Z9tHvVpoDLTGrOX6QPkiloauXNCgZ_BQiBH5d7chySgF6Fx8CvuZdQRCIO5BjzqEmnPw7aO0bPYlM0kw5Xs7bCLbO2Gw_HePEHGHexnz7K1ryLHZtvRVkiG8yMNWOdWgml0PopAevIRP1o2d6hk8keRU2Aav-eopMeT_pm4ktSdCsp_BuXFPIe5qLNDaZNgRSN1jMxvxevydlQPM_e9WrflBpFlQ6Adzwp6cPy2wGwm5vTUI3khrhjDtSPZrIyz5nuqQhT_5kXNbP8qWiDp9InZXKvXBr2JjAaVu6rjDBGlvYJIv7-iN-uxR91oqwP6xZeEM3XJkmE5t467omxC3QpFB2fds6D_xPNgPxMfhQc-z6HGL8UBsDFpmq3bNXanFQ6WpgF9OOhiPMKV_z5qJppQkA8NXWEbd7-LBD9gYJuB6Me4vOK60HRSX8aqz_0Pi4Jzy6E1UZp1rim3HUhOxP-hw0CWTkK2LBCzbIhEXPqT3J76sfkw9rbLSlYoSv6Xix21DYAiQ3CtQNAwP8QwFTHdyKQdXwy0F66z9iNMnn_08ffw7su91j-iMlVYjQQeGcA8bGRPCTmj8TqWEXQPYJL12izOhc7yBbo_kqjALpWWubym7Kudkupqtc3FAloSC6EYhW15sOaoAKLhwXrryHpqRrb4j8BkLCqZ4vew8pxpzv7J-NNnxD67-VdH5P_Mdsk3Y6xIDoXo4viOyocuUeG96wQ6YL8-VxqEl9W_escfQZzGlncQA==.eyJlbmRwb2ludF9zbHVnIjoib3BlbmFpL28zLTIwMjUtMDQtMTZ8b3BlbmFpIn0",
format: "openai-responses-v1",
}, {
type: "web_search_call",
id: "ws_0bc57cc43a11be42016afcbad4eba487d1b82978b412aad9a2",
status: "completed",
action: [Object ...],
}, {
id: "rs_0bc57cc43a11be42016afcbad71ae087d197e8c17e09945a14",
type: "reasoning",
status: "completed",
summary: [Array ...],
encrypted_content: "gAAAAABq_LrZEsCu2eLSYtpWUI_6APcrqLOVbCDY2kV-QwxFCGPtu3pZnLrTF1S8qqkzXORn4DVjGyar2BwexmWUP9OjN_yuSWdXP99YNkffbgl4ehT_AddvneMseb4ThBncluiYH-bDFyofdjwYW2NRQoig9FEy-uwTEOHePHGIDVgKPAcojsQVJXAHcTVdmMOMBcSDJNpTJyR4vVzwkv0PXhl2ljWnRCXoeacAqLbGWZ331MyzpVYOSzZdu-a8Fl5mGZiFCeAUGIbMt_tjsftoz_G3dtkqJvhA1Ou292WeJ5SPCW13DX3YSF9b0H0frgJa1R3xETDMWXRAWm5IDS6FcbsjX-62NpcZaFF3VwL7UcdJ63hI8PPYu8vKyHUCM6wofsNjN377jRDTTN1lvVGzhoc9BT-sGznzlbyxLUpZT8b31tdQJb_jbRhbaFpHv-rRJVlGVKmc-6t4fOY-vZKi0TyvZ5aG3ZsK5J6e96yc9uJnI217agtIaDEyScsdbHyp07y5ZuUkeA8UxnNyBvxVjm84_peU_TMJ-xlNmUfNJx6NwoQOGHrNVpppVm0wsr0honpJRNCZHvHqZOC6CUvEAf67l_1uJ1hfipySBLcsrgxL-7GWeY24RL-tQUDZVl2CZE5YYvG8X2Rc36K5cX0W9P7FpaM5OBA2g4LDigS5kzav44qIBUP5ap5ggHxp7JANSLQG9qq3xCo0omycjG2um1kyA1
…[6927 chars clipped]…
TDxW3gKZZG8VM7jU2pXwIlvjzlP5W3m4Xqu5hPJMR-mSG60Mv_TKL1okRpaYkS1V-RJst0pePovy_FOIEAGzUGEJuNY6t5jPiwRTtXYgzjxbnfKoohN2Fnl3SZ98Vx4t_lpa6OTHfDgXczFReHnIfCSAS-ggUg4yAw1GwVNbV1bV0yArYaIG9bJOWvqM7RCBh3d5bnzAW0L8zRmioREtFGY-TRLzcTEHkl9bLeJji6_ecL915Q-kMK2KwIWIu85rafnmUZgARwehiDFpnw5H4O45NHGUByPAxctVzf5fePZTF-aG_g5PsYyBckD-0cs0UMEGlFVzzNqSgnMtZYA-ba8rrPqB9dwqGQQOVwWmePkOx0i5NdJt68wQrcBPfYr8VEXLSNCGdZdb3CDu9JGu968Umb_IcSVfMnxXPmy6jbpXh1iqbyiQtCHrBBsz8PPRiXtdDf_fg8SEH3XSp0z13D-ZTn0ZChnFyS6cvTuCz-Lh0hjlhJWJSjrEjWai4Z8HiChyD_bSW7ENwae00kKCIGoeDc8ygmTFYkyr0WXCRY2DLcqtQ3PIthICMKn2A-2cz2RzcbfDaJ0SDailyF45YjU_6rANuNes3D_xD1Jm5kMiA0fpRiEjfa6AiI9dmCxdERrhh7wTdJcqA0Tc-XtKWZhF3pipW-hPXs6_3KhEs0g67kwTb5viGpRS5jWlsy61sq4s_P1h3OEwyxUsRrND9vSTD8lwOmiZgy46Go0UxQhuXreQXqnYCH2RPQC--fZlJDZotWo58ucX4bNMoMgaubGkPmTSSq7e-yd3A-Yl619kQLjd-iukOeZmNREoZDlmbffw8aBWtll_j3qajmNJsnuBGnwLE--mNxoWzxrUpYmm_j2wuMEXJuVQl2ClzumBITFQ1s1JFTTEPa9k15VKpJaS8RIo3v-MsSJaxEm90hGRxn9dvxF90NfKdwxBFyynbA9XQrLGQhg1f0eIn4FsZJOajenlmLRtxWZ34x8NjxX4G_uaA09c-h9cfYFV55PTIBxwbT_MQHi3BmpLx3mtajJCemP6ZlHwTsipNkL6B28BcviWy-z_hWaJWhecPNym3gbveXASzo6hTXaUnVI-aqrl-Iuyy2XCaCJyrJTnoEe3DqGHI-mJZa8rWNOcRtfbGqfPrELz9_z1rAhKrQmvxUYod6KXrRBn8f9MHYWY_x_9ANsa7ndvA-wUZyztUOZV5gQO1jsDzWls8SzNBqEOgH-eRsV0C30HkRti7oj1P-iyoW2HGmY4t3n6Mfj5QdIyhU9aSXuQ_gNGnOESTgqDL9l6iqIgGTxLnlQ8PWkdBPlyOhbAwUMpsTtpixabI_-0R4nkIZDELCAygWmz-xLVL0rj5XkvKS3zkM2IyComHOz0WZv_PF0p8nMmcjGoimClnoSE0BlQqwLHKptVYvfyLJsmCiOv_CcYJQIqsp0mePZDJ_V5l3NcDTms2TzbGQ5NXaV1aWmsB937j3Q_ttRV_IaztYgVp8ZJuc8IVOZdMHD7_dqn_EDYZY3kXLzjF8dZhWeFH6a0gBX2c6kNhgX7azvDshfQUnOTt5QexkFd6HYEfA-8_03Ng-b1pbKZuakOVWi7zmdhQbvadjoDSvOj512bqOK_69OcfM4ynqthvon_nn5MoNI2CpATKineMyZdEdDDzBKTKZbSV29dDvKrwMvJZqqJlc-elgEeMuHoaG9a7tc-84aNZ5Wf2Ik0pD1j2hgaejiBZKoNiFLZgz46MnJeMwIwuS9nd2lxCP3jrMwjHoKTJnmCcDGVoDfkLu13W0MWbmVND-IIUd73dzvprr1L8faml9FeEX2TlHfYkze7vSYkubh9u-sh-DjKZsQ_9arKA6ixbPY4cUrOjLywK3xQu0GoB5nHqyBZ8TZiwghRICiL7SIb0Hotv5qK1_3pe4UxLJ-MrfCNgOoZxRW8_56ETi5ZcFcPYbmwY0fPnGglH4Yi-gbjCrA00azXAki-eXdMY7YxB0mtVektPnycnVyBoY4UHMTzPHILjPuhDcH3fqP_Soe464trFFROFQvEEww5LE8G5WUE3o-KGhnPnZBCZ7EJ00H5Awj3K16imV-yyaqMiyrldBp2EOnrPRnlmaz4Jd7Qb6RRrazJTi6hTvRRCJOGmEHqQx-QNm0ieqydAm_Ohy_rVvKN8gSZnPD2bZDKRHRXHA04PHKlElFKY3pjf3138zh2xPS-uohZlSV0bElv7XlEevOC0PkgFUaZXrOVFQPva1ddwB3Z-kCEHfXlZXxkNXOAMyVkJi3IDBpbsPTcE41t2FYX0KYTNJ8UQVXGT8FbJyfaus6qUM_WDxeIfxT2tdShSJ42a_8RbS5HnpY4EMqHd5JJNHM-z415vEjv_mMOyjoHNPRF-16VGC449CDnLosH8DCTOMtOVHpUcMU_Es6DnLt9Eco7miBBtp1GC3L0mG44H7dHl4Thk9iYZq9DKWQ6eVdiqv6bLJfv3sdfxET8qW2q9m1mcJF3V6bsE4JNK0-6BLZm8TED5EL_rwrFzSV8Y8N9CgQ==.eyJlbmRwb2ludF9zbHVnIjoib3BlbmFpL28zLTIwMjUtMDQtMTZ8b3BlbmFpIn0",
format: "openai-responses-v1",
}, {
id: "msg_tmp_qut43dofg3",
type: "message",
role: "assistant",
status: "completed",
content: [Array ...],
}
],
error: null,
incomplete_details: null,
access_programs: {
Online Model Variants
DeprecatedThe
:online variant is deprecated. Use the openrouter:web_search server tool instead.:online variant:
const response = await fetch('https://openrouter.ai/api/v1/responses', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_OPENROUTER_API_KEY',
'Content-Type': 'application/json',
},
body: JSON.stringify({
model: 'openai/o3:online',
input: 'What was a positive news story from today?',
max_output_tokens: 9000,
}),
});
const result = await response.json();
console.log(result);
import requests
response = requests.post(
'https://openrouter.ai/api/v1/responses',
headers={
'Authorization': 'Bearer YOUR_OPENROUTER_API_KEY',
'Content-Type': 'application/json',
},
json={
'model': 'openai/o3:online',
'input': 'What was a positive news story from today?',
'max_output_tokens': 9000,
}
)
result = response.json()
print(result)
package main
import (
"bytes"
"encoding/json"
"fmt"
"io"
"net/http"
"os"
)
func main() {
body, _ := json.Marshal(map[string]any{
"model": "openai/o3:online",
"input": "What was a positive news story from today?",
"max_output_tokens": 9000,
})
req, _ := http.NewRequest("POST", "https://openrouter.ai/api/v1/responses", bytes.NewReader(body))
req.Header.Set("Authorization", "Bearer "+os.Getenv("OPENROUTER_API_KEY"))
req.Header.Set("Content-Type", "application/json")
resp, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
result, _ := io.ReadAll(resp.Body)
fmt.Println(string(result))
}
curl -X POST https://openrouter.ai/api/v1/responses \
-H "Authorization: Bearer $OPENROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "openai/o3:online",
"input": "What was a positive news story from today?",
"max_output_tokens": 9000
}'
Output
{
id: "gen-1794947899-0Gh5NsSvq4gktksSiIkO",
object: "response",
created_at: 1794947899,
model: "openai/o3",
status: "completed",
completed_at: 1794947912,
output: [
{
id: "rs_00758b1c1ebe0100016afcbb3c4bfc87d196d13e1be9dcef79",
type: "reasoning",
status: "completed",
summary: [],
encrypted_content: "gAAAAABq_Ls9hj8JSnf7Rak1FV5VsZyYQRRVA4U59i_tpb3I5XOXuBRjDKCK_HEQ7TdCncMs0uPOMM9i7bahqw3HrOH1LJop4DNQhm8aGzA4zRgKbB1Wo7Nc1htptso5CHxBVF7qfGDdmVgu6P1wwcel047l8T2FEEiaGgdaaggKmuHi05MsL6BkwY9fIu9g6O7P4SPsWk_5MmD7mTcpso3hk9Sw1fWxfdewR-OzoD6enyDLdz8TfQGUGo5q1XueyVPbdTj3ms4WhBZBBi72u13_J-jcmnnybSdvxf9khbgWUwBizutnW1IKvh7aVy5EfgPP_X3vrij_BGWw4fPUv2iwUKIRthCIf-PDbN7w6BEZLwS7sHZSz1IiEOJOrGY6zNnrQ4Oz8IDWmdKtIaL9dmMdw3Mln8nEulO6W8pMZDD8_c1kd995tuI-DQEeAAnYYtKpv0aVP8fHvtyUazTTsDx6fozmhHNNhj2U17ULcs-fdRcNLDstQ_OhEZr7b1rzM-OBRswh26MooGbqsSCLDKraZrw9Lw6OwllETixeJJL7rkCPxIIe_wvXovZI2MGMtlz_1xZjeVetDsIha9wfYJbgt2IQHYpbcZAL2Po2z4N4z4tTOzBQDN3WM069lBjGDASZYZhrqiPOPYjxYwXYhkgTcxxCvC7qvlwPIB5Wdm9QGAttXS0w-XyCdIOqGP6zyve4c7F4LeZ5rG89DvA1J4QD-XfjwAi6CDFWA3dNUMyLPuJg0xORBJucYSbtiq6H_z0_SHVas06GgTGmO54fo1H0A6Rf4z5Z-_JAkGo5SXhAlPVmsp1h9bGtlJb1El6J153Xda40Lr3A_5zTP5jYOTcIj0TmLarjae9l5omEdmxHee9pfrJqjzFXx2xz2K8WN5vd4IL0IpFA2xD6GloRiLeNUsLlWfEXuNsIBs7HNSPT2cNYTiUdolMxR9tglLtd-HTlGn8O86Q9aUmW9l-zWbHBVajBcd6rrBuckNKSxRTzvVTppDuP8Ud3e_GDGPpMBiWrWQgxomxDi4FVTBS5IGTjNgjx8PIY4qSik7sJKjt1sNHdZSvGvT24qrg2IICm3HVAu6Yl-W8WtYC3ohbRpWRWgp4MXIX4vbGZbdQfIZoP24-QMvcfHTSnRVdx1n1Jn2vtHH-jHXMuSADgD86VDcvb4OPyG897Csz3ixE5aYacx24vZVOSA9vh-866uS_eA1YyzyPMAYY_aEYVYo6YGrqdgd1VD5LaLrJiNyFSVFJyxF2xvfhzRKdWRVRKAIDKpVbGNt2vRwotp0KiyP6KGwzgpPETNiSOP-ta54M28Iu8gQwbW6Ou70SBLaEWiiC8LKu6rhp89krbE01TJcvzuBleXpDZYwpyvQlj7LGoJSr3WSkB2123UVfgzc4gxassohmOXVLrQI2c8wQbJFIVT3r4LWhmawn_hzkz1zyT63hvGATDLk-88RctAtFpG7NQsrVAinZ6U4osZTTn3WmoMknFboR3OZ5slvoeqHjbL1KOC99s2roKNY_Xf0BiDhJzO307ksLZBbyv6SZsVsYHE3Kc8PZ42-Lrz9nCCUSthluKBKg2T8IdCnufB-LR39v39Pq0QxHXKv8YPFAC106qQKz3o1_BX97lk_bOTDTC77v5znA7bQPAN5Mp08R7KReN4YhBhf09N2ZDX-NyJse10hhWF8CbIYOlz821pYefGd8dfqG5W_2_M1inmABDHm4IPPzyvejWOHxnc6qf2Uiiut5TZ1Ozd8Nf0wu5_Y1D3TqdUzcr87JMSQuaq5wFkb81BuxM7ECCYRgDXNu4nTqQpUibsKt0g484rz8iDHQttgcTGxQ-rPW5BUHJrHqLgzrOYDfUkRs2BQNVRe9neE730pCgrAQYWDS_KRvAWoooDEoAnyKE3hijW3XRez22YAGBaQ1TfBaUuqStuxB3aAEY32xXY2qFAoGN4YRV_XPI7hpYXyGAeWraB21TW8DmR33dYZVDWU4FYDyOiTQRo7U5Xa-RvkRtjS2vwriJGwv09lmItjCsf0wdmhFRH2hKgS__S1BphG2bqgcanR1lJpxPtUPjqxVfnZvoMTsxGyPm10axNUmH0VgnKw97cOh2E8GDBvENzQi2An2FpuCEn71TzBjwds9iU19P0AYUJ9Z_KlvqGOxoHHNJ9Y9I6da-o7fslvfCN4C1KMS8a-Up4FFvr5TJveFr6MrwbsvSf6Lqrxg3ZhG81mKPobSRKaS8dOBrcD6ZdLDE8W-v-q43AcqZqXK7TG9tb5I4KbvMwwSA1EU5NeO93Pl2UAsas3Zxfljow5D4Z6OJ8rozkOQ0nGREgNF3RD8J0UxldYKob3aSjFXrLYxuTN7MMr9V2WnNOPoMBvsafnpsPIu2eZIe9HGPz2Mpq---Yt-IodQfsc2xBlr-5ntN6-rU4F8IRnqjg6fgueymu3-37clLRsGVm0BRz5IDdVTfchgRSEJ-u7YPwMccsduSvofXZfZGd0ZBJCfQ-gZVuIY-wASWfbsufkIBcye4-y9AIeIqFY9hf3H2naasGPMLZrnPQqSEeTiMH-7WbZZXHgJN1lx2UeGBr2JO4Wfckt2eiDQJLtlDO4jHk19UgNzgmOJ5L2AbzikRISzUZTv1U7S9Yyzfryf6eHaIc7aTrXHFUdj3_dlUXjqAsXLo6Nk8NDOzFD1JMZ33j73Lk02MN1tbWQ6JW6yCS0X7bTZxGwvLidhUtUaQ6x31f2tu5DQ7dITu7W2TKfBKi61-O6THH4LkGh5-.eyJlbmRwb2ludF9zbHVnIjoib3BlbmFpL28zLTIwMjUtMDQtMTZ8b3BlbmFpIn0",
format: "openai-responses-v1",
}, {
type: "web_search_call",
id: "ws_00758b1c1ebe0100016afcbb3d028487d1acafa93a4e87f29a",
status: "completed",
action: [Object ...],
}, {
id: "rs_00758b1c1ebe0100016afcbb3e8c0487d19fb9822c69c1c85a",
type: "reasoning",
status: "completed",
summary: [],
encrypted_content: "gAAAAABq_Ls-0kqO9jgfT794JG6Fe7FwgS-ppjCYn0IN5j5IoMDh4-CKrxSARkwi2ysBOEwqeynov17To2WEYQnjHg9mcypB4ku27r2adxePNrefwIiMsvXohxnhwr-KNBdx76L0ZNYkZpeTRC2TSssgMInE1zQV9JgIYOfcQOQcMgS8SQv9FcJLZU_GBpOlLUwUvtsDMLgpawci4mgf1_B-Mhwp-hv2OB5rVAm4L-Z06ybp6fSG1KEVvY2qfvgoJUupYP6cAcEv-Tu2viGQ4LthsfKHYX2MsTdlohrM9tgItpJyahQ23XG0VwloYVDmaTgZuX1rttr8XfZ8lMT5R0Myhrt12nBPyDpPIZ4Qo3-S2mVB2ZSbp2vHvqyvE8ZQIrKDlLzOs9-qziTguuyTdY9sRbkmKgJRQXIL33d3XS6zD4xFyDWGoEETyQoRJXs
…[8907 chars clipped]…
3BW_qDm88rfQEampyG_mxso3XWnuL4JfcyfJHR__5GzjkmQfb7L_nlYBuZxtVUW-dnpVsSkVWPv1FeZ-3IrbEdvSvOpoWs8J-Kz3N4B8Y0RnJD-Yji10WWg5hQ-11nPg2XEhwNsxxrSCwcjyvllSg2vaYiaICoyV0TMqMdkbJPlEHM53E6-F28_FMu_tViNzb83RkbGKnrFSjJY0Ml9X-Os72H_7eXRzZr__rfM-Ksvypv8oyFczgLR_rwpGZjx_1kYnh6PUJIo4Wy4RbdUNIufz3FhW9Tf_A2kigi6hdAocRNDTzXKKK9-SwwKSfCkx76PfshVg591GsDI79EVnM9N_X9-A_RQqrTODul6LbV3QXx2cWhlmdIbnsY0OeYCxaLbvoTBN5DePHktfMVu2cQ1VKlI8OQvlSxjpcOskHW4SJcQzinYy1AY8RmUcsSHN7JhfM8kJoT74tu7ae9NALdf7UOBOdpDUxjjyk7HdbOI4lQ7Try1O5dzi3x3pyaYmhYvtUfVhEnHbz2p0tsJVfSwlAwHziuBL9brw9TiIky03bSplBzB5aPeliBFoaGPDFOenamdZCJJeSMitX-0bvv3GN4nPLiXnoEVaewzlQMPc18naBeC89LMo_punSC4WlNwKIhW9sSVOLLT5g8PVKYpz7oOONrUuO6aMcLf4ZsnVXVMUpkasUL1p3WRpOaTPxmEJuaBEYOGbT0VA3MXkVbymS3PpDxkZ4vUrF5VCbcfpxwFOsX-spv45QGc4ilk-2z9CoMDMBrJD32zT6rmtoAIk2gw656OeQEi0pVwqP67qqJHtdZ59tOL_ftsD4XkDJUBSaXt5t98rXGWzXqfDe5xkOqis1a3xUXi7tz3l4CcO-sCMtSj_zt__KzumxEn9y9pGxiNLIpiItSZ-DVgkipgeBw1hNyJ2Hk0SV0sabkoKwxNg0e41Ey3a-B3ZWMfBO3iKwdti4hDQ1rxCKs-OoKHNdAOGDzxmnDW3_OLqW7NcYPBnQ9ttW_qH9K5whW8QSKJtseeVgLsRiQhkV_Rdci2e6Xrlul-L05v5fD9tlH8KjKhvLBP7_6JHbbSLTP-x_oyt5REFPyxHpkpzhrboFZN1FhEYThptd5fV0Tec63je-tWp-EgCHD7yzkQvbSiVFLcTmm268c9hQeNLrk1jO0H6WfFnAPm7i4EzfMzMap93K2bS58_7qx42YZtjcJLBomXTobXnGrOb54P_rgJ0ylR46WJ7xsDhZRN9eNoqpBO_g9cWzkhgR1kL6mLbUcl08JNzEFoPDnWEUk66ItiPhHO7UGgtJUMhLZP-Ug6KOlp9oyhUObNK7NpaugITgtyHTch7C3New3WsgSKtgAtwX6yT0eyC9eh1CZzGNelD7XIQQnhYmL9iouVjV03C4mmqIW2JGrybncwQESnKysP8w6aEsUKQ8hp3b-IwgK_wvVpNvyaiUo2A4FZizfhOHUBlgvixrbZaW1iZ1ZBkyg0WNW5JeXNL0-J8ZMIygoWmKZ5Lh4Fkunpl7vD2j4vT5HeMr_B2EkzJMfBETBOS4kg_gHlgaRRAtLm5VudGNC4iMHiTx5KDF9irDVEvt9jZ9vbh-n6939R_Bw14qkUrlCe820DnOI52bXsdxAZLXn5mn_a-1bAdclWrbQkHkjyj6r8YzSW3M4ea8sW6PemCn8ehnVykzmaF3i_IGFJCTMPbzDTNjE-Ku9D0XLk0io5TVDPoF9dxDmYQStXLN2be8IhCGya257XV-Huv98JGDgt3SyQbiwMlFiBDQ9Ig1wG61LSFoFlm9tBjGO31LVb8mYXMr3H5r8QJqThF3A97k5lPCI0olnB8JeDZs8dee_YR7YTpX2k30szM4zWofv7V8Oo62B5mHKEU3Y7s0mGnDy6jxqqEQtpu6cgGGloBRhnW6O3Ie3yDjCi-kCnn1DobUxoh0QgdED9lpjxbxQ6uduJtCk3Kgt9RDcZTc2gEsVZpLncA04I6cXly7CtlzRa4zmmUcjOftyJte6CYB0d56RCyxEfJkX2JxCaOUKBcZlIfmzJkkTOKLvUVzVIjaWauBWzVT3pyQSTTUglsGuNOjhiDtKsmEq7Yje6ISEyJ8SPOiRlguxYHtAApas7Bm0V_Znefr2jcb0mYhSSVqB5cB0tnuY_t8igykZke2LwVjhjh_ohS4OJiDiZG_kwcBI-EphpeZdA8Ix046sNyE8bimxu2qSZgmvMt2TPC8Bd7qqnvHT9-j5OtM8ytXcGeVBf8k2UIJlRLERFa_q5C8cVwgRFxctVJbEmzo2XoRxpOKgWZMXJ5LXYJzb6uaOs5d84guS7rwCorQ7Z7tjna6dtHoxHZws33HG5IOgP_KUnZUF2BJPIQ3GvtM0L6UmdT6UkvwIqOUvxdtKROtSd3DYbA5urpDvOE2nYl7lMxG2CBBT5zSrCm8CF-fqesNSeFKq25bzsDPw7JO0NY7kWHjcik8MWLJesyQj1Fsix0RP2DqjJIiPYDLSZnNCmGxZut96EfuzlmForCD1IrRy631gjpVI=.eyJlbmRwb2ludF9zbHVnIjoib3BlbmFpL28zLTIwMjUtMDQtMTZ8b3BlbmFpIn0",
format: "openai-responses-v1",
}, {
id: "msg_tmp_35pohxxocxq",
type: "message",
role: "assistant",
status: "completed",
content: [Array ...],
}
],
error: null,
incomplete_details: null,
access_programs: {
Response with Annotations
Web search responses include citation annotations. Aurl_citation with uncited: true means the page was consulted rather than quoted in the answer.
{
"id": "resp_1234567890",
"object": "response",
"created_at": 1234567890,
"model": "openai/o3",
"output": [
{
"type": "message",
"id": "msg_abc123",
"status": "completed",
"role": "assistant",
"content": [
{
"type": "output_text",
"text": "OpenRouter is a unified API for accessing multiple Large Language Model providers through a single interface. It allows developers to access 100+ AI models from providers like OpenAI, Anthropic, Google, and others with intelligent routing and automatic failover.",
"annotations": [
{
"type": "url_citation",
"url": "https://openrouter.ai/docs",
"start_index": 0,
"end_index": 85
},
{
"type": "url_citation",
"url": "https://openrouter.ai/models",
"start_index": 120,
"end_index": 180
}
]
}
]
}
],
"usage": {
"input_tokens": 15,
"output_tokens": 95,
"total_tokens": 110
},
"status": "completed"
}
Annotation Types
Web search responses can include different annotation types:URL Citation
{
"type": "url_citation",
"url": "https://example.com/article",
"start_index": 0,
"end_index": 50,
"content": "Excerpt from the web page..."
}
Complex Search Queries
Handle multi-part search queries:const response = await fetch('https://openrouter.ai/api/v1/responses', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_OPENROUTER_API_KEY',
'Content-Type': 'application/json',
},
body: JSON.stringify({
model: 'openai/o3',
input: [
{
type: 'message',
role: 'user',
content: [
{
type: 'input_text',
text: 'Compare OpenAI and Anthropic latest models',
},
],
},
],
plugins: [{ id: 'web', max_results: 5 }],
max_output_tokens: 9000,
}),
});
const result = await response.json();
console.log(result);
import requests
response = requests.post(
'https://openrouter.ai/api/v1/responses',
headers={
'Authorization': 'Bearer YOUR_OPENROUTER_API_KEY',
'Content-Type': 'application/json',
},
json={
'model': 'openai/o3',
'input': [
{
'type': 'message',
'role': 'user',
'content': [
{
'type': 'input_text',
'text': 'Compare OpenAI and Anthropic latest models',
},
],
},
],
'plugins': [{'id': 'web', 'max_results': 5}],
'max_output_tokens': 9000,
}
)
result = response.json()
print(result)
package main
import (
"bytes"
"encoding/json"
"fmt"
"io"
"net/http"
"os"
)
func main() {
body, _ := json.Marshal(map[string]any{
"model": "openai/o3",
"input": []map[string]any{
{
"type": "message",
"role": "user",
"content": []map[string]any{
{"type": "input_text", "text": "Compare OpenAI and Anthropic latest models"},
},
},
},
"plugins": []map[string]any{{"id": "web", "max_results": 5}},
"max_output_tokens": 9000,
})
req, _ := http.NewRequest("POST", "https://openrouter.ai/api/v1/responses", bytes.NewReader(body))
req.Header.Set("Authorization", "Bearer "+os.Getenv("OPENROUTER_API_KEY"))
req.Header.Set("Content-Type", "application/json")
resp, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
result, _ := io.ReadAll(resp.Body)
fmt.Println(string(result))
}
curl -X POST https://openrouter.ai/api/v1/responses \
-H "Authorization: Bearer $OPENROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "openai/o3",
"input": [
{
"type": "message",
"role": "user",
"content": [
{
"type": "input_text",
"text": "Compare OpenAI and Anthropic latest models"
}
]
}
],
"plugins": [{"id": "web", "max_results": 5}],
"max_output_tokens": 9000
}'
Output
{
id: "gen-1794947990-oBsbOZtFmZHLkpgGwAgd",
object: "response",
created_at: 1794947990,
model: "openai/o3",
status: "completed",
completed_at: 1794948035,
output: [
{
id: "rs_0a4f6695c27438a2016afcbb97d1f887d1a3f2e08f1973d1db",
type: "reasoning",
status: "completed",
summary: [],
encrypted_content: "gAAAAABq_LuYWURv_vewWwmpZslxdNdA1g7NHwdyRV0fsn7hTUtIFXt7t10CvBic05BKLaiz2yBRaMmHsDYF3_HKHQLoBCs6a9leUC34fldA7DaHi0PMm8iiLoA_kzyumtVgG48dboDQOfbYPKW65b_V4SZf6waE5lna9UkjTcQVuV8_CXeOz1r0W8jq4AJcE18R0xFwP2TrSGKxomjXh_3e2AQLIkqjgpXLpQ9J2KaLuZpfkPlRHWamI-vuCZE_8GIgIKSDFFRfztlriVoIRjBAwOXh_FfityY13HHSw2GMehKjVmF0-CGdnPuRoIPYVtlXwTgjgmnpKhYGwTiktmhUMPiDXnKIajLNtCmHnFQvreO6DIdtTH1owcORDDoHyuT0mNbu9RsKbJaDMasx7_EaNWpf_dfvTQUkih0DAk3wYGwgVXmP_7FrWCqb4_4GXLjmNhKklc24tvw8oVim6IE0MdbEsvIpJN0Tn9tAjOCKLAHWN1b2dWpKy7LuR8fpOpa5JsRIacURonlaHQkxlAp_C2Vzxu1Hb1ct3O5GNRxmnrbS9EF1_rECPfsjS-WRGwzCcnG_bnOUPLeZ7_vj4LHq25dMHQiMiB9D_ywBC--x-7Hd-q65TuJNwITRZJVb9_I_yfOf-oQKkyPFaBt8on-tgN53gm-hKbvSlHfYszfmsNvKVpBKyI4L5gWxNqBLM4jFfK3q0XzKxlf6dX8UJtr5E9r7D5nza_ZQSnd3t1iJqrb_w1KxgjLIzLe49SuFzH-hRZKi4sHGzcwMxl2BJmc6ec6wbQJAV-SP3SZZhUyvyJwYndsYRf_g0oyTrHQSwz3QuvG8f_ipTr7Dr0J9g31j3_bF0yf50ietPaxhhTSBuTyKeP1QCPtZOQYp2Kvp5edKxN6Rq3MUd82RLy6cyj3IyhN1NQ3MW2SwDkHbq2K8Ya6PhcBSZC5EwBFaWipgqrpkc53KFOR-lf9d9AE5DchD1AbAEYMeAXYHs8ZpLwnH8jv2HV0aLkSY6remaJEmlU7Z7YnAFh0D1yxDNmMuVQ61bAXqAl3R8VYU580WpTgZ1vvy0lFfgZI7ciWeaFmpmxT9In_2X4AN67oV5ywGBwwzYdCQShwgh06E6yu4jhEZZNY_Hs_R8HzC7XWHgdbt2UdzWrz1195CVYay_SnlUKYux3GAuWsmYX2rc1QQPg54bIdCX7r68Li7s3UbXdsVHSJaEf91uf7mg5Lx0_ivZAL1e2ZTh-E94pvGjdnh9PQxjyp4YEKpsMDxIzJKbu9sCdFe0foc6AcYaS8xZ86vC6v78d9KUdkc7rilYIv_11mIWgL2M9qvutgAgrQ22Z7GGwL7MM-1O8ewpZy-DDZWraBxhXWMB53i8nw60jKiCjmHox--J5DrmIGgPy3guDVy4UWUgEB8AdxCQx9tctkpareFsE0Qj2lMZwXrYpMdE3EZhlm9wGUaSLw9JO7cxG1b5eQpEuZedmOMeTJ41pYfhL7x8py8_dW4u2ICWdm-RYTCxLkegCy9a4bRN4EBqnpOXtbgeAYGsdn8iFSvEDuCxXL5LF7GSoh73lzf1w35lHa_3D74iEkiffEfSiNwsokMTe4mIt_6podogn8lY944NEjfZUiys9fwRAe3KWq_OoBAa1UK2DWO1kc3WdmyKlwY9kvAp86QAJW4nq_fGzhv6DXbQs6K4WxT7QmAtzeXJfzT8ghPmZ7zWNhH25NneU5qtTOS8hB1uYjkbp2O3AFKUVjQvF863Il9IQS61k4Pq-_hHsMTWWBjhmh6wmRChYBeYYSGtcVmOtCw5BdZfPs-XVHjkdJdmaXzMzbNvRsEQHI9ihvUKLvvFm1Gw1bqwLJuT0Dmt5d6uwKQJVeP-5dKIFQuCIAyxJ8d_UF-bZc1fu6DysVYY5U76QPxXtHYK-EbzRBhbtfNRcmZTUWDVmQ-CCos2b4qi6ydBoT3zMcp6PCS8gTgcqzi83yhx3K-lSueesFTIT8ws8GhTC3vzkUu8BN40tnfKZBp7yq7C6FE7gK8ikCmHAkfGYVcE-GAs2IMP23rZHoeAJQwX5I6K93C193-beXTpYT2kRWukRGyGBqtb2J8lArBKyJ_IZtyP5MFHvXPZEFOtbCRfdLNbRa-RCRmM_Arwe6Ulf2oIGNU83dc2BKB9_dVrkUgp4LYbuLHywpmLidMbj3oummG6sFePLHZSkTuJ4cPJpWXhQnf9WmxVkQLWFIxzt5U_xrCMKFdI23xnfkLQXBnqTWCEfDKrhCkfCwaIc2Ps9pSu-PGyeg4UTcQPOqg1qRjoHa8G-DK0KuzLG2LEIJ-wkF8nw3EbFnM1ipo0vrH9NrmoNDSs2fgiBS6KbeJ4RsSG7iJLxluNhCRIOYfjjSf5WKlnf4feKYdnA8v2081_rb9l_GUvDgbeC-RVAdzDIMZ9zwFzK4AmrIEl1V59HBe9h17-l8V8xgG57vGfYgpFvqwhUswb-hAOD1NjENr6oEQZxsnfJXLVdC46L5XNK0q9qkQaOdXXFkA-gxxM8PQ1qhpq72yRm_-qyU6bRQ-okhYgmfiVsE_z1x4G5BtPqVc3A7WPPLvW0KTrsjlMoEzG4pnVkb4fBOhD9P51iCJJvvYYt9NhJ-R4dZMkQL42t9ONkK9EvFn6eZGSHHIRQqWBkGBRAOv27bFwQOC6MOUNWWJ9A-M5HYsbm3yWIfpqJGeIgETdZ5GAQk5WKOxmV7vtkD9o-EjcEsmfHslsWsoHnk3kxh2_zQ6DAeFkwKK-ZjSmW9auqJt_33vAvfMcE12T1KC4AHqw5AMG4lkRQAxmhLmbMzl4oDoBPCo_xjfuzLjtzHYJ_VSZ_bIS70ELMZcmKG3WmQoyHTJsreJiakweculVDThQj-FM1SCIqmn7hfzmnuzi7jFEgghHbkY9IQo21ExWRBsXAtoamfGcTNefTw1g6H9CljnNqo0X0YVJLDeQwO7cqv1RLr5v0Dwiv9tdiJxcVXrozmISfr7u3YsAVl1h8UsRr2Zh8Hdp9dTPEk7s4ML9pQ5B5jCsfzCLmt4y_ysKOHUbXDSfgmoVvBzif4ve0GAynjNwTXtsXcqSXijZOBrZOAXpmbVN31AIiyGkBkDn1zHHo9PJQ_xF--GuB0DYcG-y3GOYnbdxW33C2eqXn9XLOt9IfflGT1cBpMqtS70HVhbQqQ5I6dztlLV4hGsnKCwsGPxNEudAmT9-ZXk.eyJlbmRwb2ludF9zbHVnIjoib3BlbmFpL28zLTIwMjUtMDQtMTZ8b3BlbmFpIn0",
format: "openai-responses-v1",
}, {
type: "web_search_call",
id: "ws_0a4f6695c27438a2016afcbb98f68887d19d4aec37e04f8214",
status: "completed",
action: [Object ...],
}, {
id: "rs_0a4f6695c27438a2016afcbb9aa7a887d1891754298f003a96",
type: "reasoning",
status: "completed",
summary: [],
encrypted_content:
…[52278 chars clipped]…
mBUtdK1S8Kwl2QwTNAz5-Zmb81bcekDmBR1hn-668v2kyraR12ljDnDUXliG0D-NM-h8MQcv2fi2H9vYw6mP2KLyoBw-vTPPgqvKwkI76OtIKnhuK5RdOUXU2RgHlh3WpFzFjXavM75d9QgRMzFCqiB0JMcgnoI5GL28N6g3MPYIcBvs7Mzx0fSQ0l7jtvNnEnavzoYWVoh9m4UquOfNDsXAuMiuUHfGRGv4lFzX-dvYQSxErF6TUJpc6k7WGUHOdyHVcLyLxxwWGb6B7lLt0e5txs3-RTAQhQiQg5nXzn7sTVIf_psOGsD6kr_sRFKZqzH63sqTedBTZyDy2QHs2WhpAabTDmZnlaiAqD1kS0iM5kopivOltLCVrY8M202-ChNiPphIxBzxf2dYbJ-Y4FjQtRQmlKSLm1BGtrd9-zcfIhKawGf9hr5-oRXlYM_qbA-89asIplku7SNJ4rxDP_GI16v47a23_ZLp7I1Gj0X2jmQX6CWwT3u9S_3vuHE43VFBCAHT3iTbHMXXU6_kmzpvGbnQb1sT9Gt6JcZq4G3Q9gqX-8CcLkDa-Xarq8X2JvXQbR_HuKNtR0p8M0Ix5HA4B6yVTh3SegegB0tOgSoDvp49WS_3r74M1z0fGuf-TWMKBzzGxgyYoQX6PJP7NJQ_KvzB3-i51__KTwo_YJX7p07vJGGaEyMzhVSZ_DLK3QCyCE-7kJyvwYq2iBz2xlf3eJTEq6vjJ3ZRXRfso-dI4VZ6WVQOOxWW-r4bKQ6GEdC1Btau5G9Ch1VMiStyb7Xw0qAjxZffmkCmjXoz5Pa9nrPqV599TplOuldypaUBlLb2esUCnZ8G4qrc4ZlHO5Yjwa31O52QfD9WGf8gkGZLne7b4lbr9VcrP02SIeajE1xxgAmgBS7oP8Vcs_7CE0KcTX5xdm90caDIkC6vFpX6vZQkjAi4wCtA8hCpoUwtVYk85ywLdqJPoK7J-vkwSdElHwJZnucMrBte_bjQIDbgaRcJq3-04qR8x6nX_XiS199bNVJM82JdUzX92GTAaKTeaWqR7iI7zs7dEfr69GmiaDohokYIZ3u25__F_pmADlFXPsuE1L8vPzDBQZBeV11FlxRrzrx1jf_z1gj_ur5rBI18clCxRHhPbhFyUT4lyY9_azEjLiDNp1JgA2bxQpaW8FGkcMIvU3ajeAIhrSYsQEKqpMcmd8Gt2RdjIgsBVNMD8jhByeapCu-wyUZ6HEOgh0nfjC_Wr8kEnqVDWi9qHHhzcD3lltNuDN4XBbzl3ZC3327VzHsHrCZw7P4IVS2RHyMm5iqH-gmiWLBm9EPHZ86hicwber2YID5vgguwZH_46FUykHSAsDVB4aGqlgijEhHfCvQ-h4yBwFERXLN-Kb2FY5_Re2U2s-vN9U65-EPG0UzC8He3D2Rhs9YKc7bP0Kq_y6keOlPeXKsL52tMRGwqA-UHnSUIShyuEkdLODf4dvCwdovlP2ojgWISKLKps4rbdJn1DopIaMyhJkHp-SUN2G0qLSLJSvdzSPJ1_xDMRoHA4RoT7LyTvySSU2J-E4V1tGVCPcZx7okOXH8zbgSd_gjn0Z6JsfOst4vujRe1SwlUpI4HNRPHaRhZ_eRWBDs9j4AxPjklGg3bwlbXt_MUqlP9Ff1xkiAyqOjPZvnHxmnP1HPT0SkMP9TUP-BDC4fdIMHOpuq9MeTv7wr-g5p0mLst7ZqcEBejhF97ZBtCXFu971uggp_PjUM6O3J9hgF6rTTROaI-Mg_ZrBp02aFjzflAhj6Hr5MCqw79cp-YzcXOXZD_xYMWzjqKJTnBby5ZrcgsWG-09Y9RZRe5OHlkEhMTzcERUXzJfPB6ijURoYuzScQIRd3YElL9amDhDDB3hy_et52tyZSDjHDulNyIi621EwBf-M9XPZAt8F5Hdpj_vpYkZGrNdKvtSH4ioFwmCgknZhHYqNzrivgLNNZ7CB7qXsut3KBpH8obsv3oIF5pelyEFy8WyJePv1wUOmOmaUn-ycoSkOolTmZKNQ6rE9FrvCUe7d_CtNAFtHPF4FGvAFDeXk0mZwcsqXRbrb5YDKPK50XL-mPL-hHAcFd5hBjDDU-RX_pazz7_tEiMt-ABWDO-Kon4eduF1JpgEggziTpkvwZ_Mb0VpGTKfnLgKwvcmIsGFuDCeegSi0gZcdnfFGyVSTEqUrc2M6T2q_eBPutpJsNQGOYf_WkDkPg7gYJN3jWPDreltoGioF5XkzVi4z2Y3TJqt5GRA9zKQGXjICqkCWYbRRF53qXH55DACUUOI_xA8IYb3jfbPZBPd3S413Mtx7dLD1mQaxCtrBc4Zb3YGcktMhVTxQH5BFzIcPDoONRfv75NB3kNWEO5vdGpQIGkV_aqkw9XN8vlG6m9Piqbi-bYH6xtCuH6P2QoWBxJV6EaD539OFoo7AiJt2wqB1pC8R9AvnH2dZssFm6X6PItswj-5C9LjAvSSc8EHQEow-2GC39tMWtLi95FPklDzhWI5RjUqQyo1gQ5g87BfMT5Yi2.eyJlbmRwb2ludF9zbHVnIjoib3BlbmFpL28zLTIwMjUtMDQtMTZ8b3BlbmFpIn0",
format: "openai-responses-v1",
}, {
id: "msg_tmp_j5x8zhi9skb",
type: "message",
role: "assistant",
status: "completed",
content: [Array ...],
}
],
error: null,
incomplete_details: null,
access_programs: {
Web Search in Conversation
Include web search in multi-turn conversations. Replayed assistant content usesoutput_text, while user content uses input_text:
const response = await fetch('https://openrouter.ai/api/v1/responses', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_OPENROUTER_API_KEY',
'Content-Type': 'application/json',
},
body: JSON.stringify({
model: 'openai/o3',
input: [
{
type: 'message',
role: 'user',
content: [
{
type: 'input_text',
text: 'What is the latest version of React?',
},
],
},
{
type: 'message',
id: 'msg_1',
status: 'in_progress',
role: 'assistant',
content: [
{
type: 'output_text',
text: 'Let me search for the latest React version.',
annotations: [],
},
],
},
{
type: 'message',
role: 'user',
content: [
{
type: 'input_text',
text: 'Yes, please find the most recent information',
},
],
},
],
plugins: [{ id: 'web', max_results: 2 }],
max_output_tokens: 9000,
}),
});
const result = await response.json();
console.log(result);
import requests
response = requests.post(
'https://openrouter.ai/api/v1/responses',
headers={
'Authorization': 'Bearer YOUR_OPENROUTER_API_KEY',
'Content-Type': 'application/json',
},
json={
'model': 'openai/o3',
'input': [
{
'type': 'message',
'role': 'user',
'content': [
{
'type': 'input_text',
'text': 'What is the latest version of React?',
},
],
},
{
'type': 'message',
'id': 'msg_1',
'status': 'in_progress',
'role': 'assistant',
'content': [
{
'type': 'output_text',
'text': 'Let me search for the latest React version.',
'annotations': [],
},
],
},
{
'type': 'message',
'role': 'user',
'content': [
{
'type': 'input_text',
'text': 'Yes, please find the most recent information',
},
],
},
],
'plugins': [{'id': 'web', 'max_results': 2}],
'max_output_tokens': 9000,
}
)
result = response.json()
print(result)
package main
import (
"bytes"
"encoding/json"
"fmt"
"io"
"net/http"
"os"
)
func main() {
body, _ := json.Marshal(map[string]any{
"model": "openai/o3",
"input": []map[string]any{
{
"type": "message",
"role": "user",
"content": []map[string]any{
{"type": "input_text", "text": "What is the latest version of React?"},
},
},
{
"type": "message",
"id": "msg_1",
"status": "in_progress",
"role": "assistant",
"content": []map[string]any{
{"type": "output_text", "text": "Let me search for the latest React version.", "annotations": []any{}},
},
},
{
"type": "message",
"role": "user",
"content": []map[string]any{
{"type": "input_text", "text": "Yes, please find the most recent information"},
},
},
},
"plugins": []map[string]any{{"id": "web", "max_results": 2}},
"max_output_tokens": 9000,
})
req, _ := http.NewRequest("POST", "https://openrouter.ai/api/v1/responses", bytes.NewReader(body))
req.Header.Set("Authorization", "Bearer "+os.Getenv("OPENROUTER_API_KEY"))
req.Header.Set("Content-Type", "application/json")
resp, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
result, _ := io.ReadAll(resp.Body)
fmt.Println(string(result))
}
curl -X POST https://openrouter.ai/api/v1/responses \
-H "Authorization: Bearer $OPENROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "openai/o3",
"input": [
{
"type": "message",
"role": "user",
"content": [
{
"type": "input_text",
"text": "What is the latest version of React?"
}
]
},
{
"type": "message",
"id": "msg_1",
"status": "in_progress",
"role": "assistant",
"content": [
{
"type": "output_text",
"text": "Let me search for the latest React version.",
"annotations": []
}
]
},
{
"type": "message",
"role": "user",
"content": [
{
"type": "input_text",
"text": "Yes, please find the most recent information"
}
]
}
],
"plugins": [{"id": "web", "max_results": 2}],
"max_output_tokens": 9000
}'
Output
{
id: "gen-1794948148-iAySxfqJ04whz8P6t7vu",
object: "response",
created_at: 1794948148,
model: "openai/o3",
status: "completed",
completed_at: 1794948163,
output: [
{
id: "rs_065b3fc0ae66a3e3016afcbc358cd887d19d4b16c5423b5721",
type: "reasoning",
status: "completed",
summary: [],
encrypted_content: "gAAAAABq_Lw2o4DToqfotGlEOjd5IhhAsYZxEhfeaOHikXNTyRN-W4xTZBfdTDmUDNFDy1cS3bsHh3QcguoY8N1x90Q_nuu-XW50QYQc_PVAVBQ9Vu_aH7Yjxw3G7MhoRs8LYXvpRwoPVdmEEiF9uqGoOrDXk_keq7Rff7jfJpTRvSW8cNnhHZpfVHHVK0qNsaQzj98DxJD5Rg9oK5BiodnfnBZNUHhbY79xIWFH_7ZHOSj_J_A_gW4iElZFeYSB6HQcjLUspic9I0MERqf-5tN5PKhcKiMRfI0pXorFcOYx2txmob4jbEkjzIuAxsD5cokQpVQvtAnJf1ito9rkYyAoY2DPijz3C1a-AKSjM345R2ui14WjW1K7Ply3lLVq1egEV3Bo1wOfqktxqLQmctVZ3gx72fBpWDrWHKBy9kxTO0o936cwUEq4kBWb5YM3VSzVf47UE3ls7tNBIV0Eh6QeiHRDcswJ4FuVygNbmoWjU4LyZ6ik3O75AoTO4Kak4tHcEyGDQf3BEvk5ItZWbyNmnuiD7rgkmABYs1kpDaxs0M2YbmEHl3wgpyRJejmlJ26BwnCCl-hA5DPK61lsv4dgZUaNCAu9UyerBlos_C7l7ZwFslVeORfDJstMM1nVuWtvhb_ye97pwDyA3tR4-8FqdVca-TA7LE6fgDB8Teplb5xvI-CZe_BsDqCPtuTpYhDCBMlqC3RIl77LS8xXIDvBy0ICL3C3AZXP5JRZpFfGYAd6IrwpBpdMoWATkeA_OPFaAA4dO6wxvJRVQwaYfxkHzoEGioP9TwspGTSxtMqfBITDeeHBeRqVSDV4zKtb9ldKsn19QyQe-v4Q8kkDU2fDxhTDsX__WpafGXnBsSOWSfgA_3STVF5gGYffI251hWuKuHwhQoBiMveS4Qx2Mdb4-gGT37Qks4X7zNdJlupDWsyVd96fJp_8w4WZo0zlp7HEsCHY92844M6WElarXNoWbUvSJwB4KduMbeuczjSCewFvBi9UkNEve_DRCAgMHbpV69_aPBSzxZBIja7KqmM0eGUhPj_awa0qUperEBGCvqeWX0raiUdV-O9fIO7hrzG7u6Rq-r-N9SfEFo1kKNd8pA8-iMURdqTzg6rfGburc1xUwFKDsr2GNGA9Tsak0hfJzI_UaVSruSC7k1Tb5K3fqC5Gg3kQcSQ7yNudgWX7lIn5p7iFgSq_U1VWjTr69R1jOk6zFEpoYU9yAV8gB5UCDJl1F6kJfIi5P524cxyPqfyfkwNV9OvS2g9IWy3znICU17eTcXlNmAqR37BiGUHFk_xLKJOV35zlXgNb2TgukBLzY1fTlewFIrLfKOD0VR2wjDoEgUjhJtLek7ab7z-WzRFVnoa4GhWTly-dkN2uZ0WmhiOOeYeJwL3QpQZE_sqMMdYarhKwXcbAhAy8-TRC1UcOL4wWRtSS8jxinxdvoktsJs25PbnDiD7ROC9pKYF5lNI9CE3b6IGF-NHN8SmCDIgbPOLUyr-hFQSvO9510OiV1FDvDGgj3aWeZq5HQ7KhMtdnmKGd0AIbmXIMXxfUwRk8XL0ZfV5gEWxRQxQBtBx_pi7CBv_yfLxDG2jWjBiuuL64PwcbBLLJ18k7o1yBIoLyDUNSa-wGYDRCLIl86djwQy7RugHxzP8t9F77y5LQZxyehKKaOeiv4MzeTuQ1q41THpITrkuNQAkdWA_-rSod4kcDTIE6EpJhSqV_abK5B9bsU5zEihsyAJnzNl0q73El7Cclh-9x92aIzZILWpsMRpkb54qheKcUW0ZVwE8drpfbu78riZEaS0ouacFTI8JKRp7cZBej7zegbkiVLomcEfs81sY3c4-w3e0GbymPBEVrmresEtytjMmV9XIVRyzNCyQkw6IkWMKxZB0gL2tXzarGYWXBzDjzIy84LnGaltjCyaVzdvtQZoY7bkSOK9gAP4NrXdeCNeqFekY13UPP_GydvruyTrx38ct1Vphpkjh4GtAIlIM9jgmzDNwGXcciif8NV-U3HLXZFGRHVvbzoHovXJ5M59yl07F_LpxSQE1BHO1kljpYY1Qc4gRAQnYEk7RwJwX_g2shrJJos__BwRcPMDMI-ER_sz2jYCNedfxQeGjY76K642-pepg9MSuIAJNudPTLay7yK-qlCaKWapmdKD0AtuAo3f8hKPO6oiCGV19E.eyJlbmRwb2ludF9zbHVnIjoib3BlbmFpL28zLTIwMjUtMDQtMTZ8b3BlbmFpIn0",
format: "openai-responses-v1",
}, {
type: "web_search_call",
id: "ws_065b3fc0ae66a3e3016afcbc360b7887d190cf9eeb9f3f07cd",
status: "completed",
action: [Object ...],
}, {
id: "rs_065b3fc0ae66a3e3016afcbc37091887d1a220d1686901d879",
type: "reasoning",
status: "completed",
summary: [],
encrypted_content: "gAAAAABq_Lw3SJzymmIdxfnRF3unoXllpEpA-BqKeIVBMmfur6o58fWzLv1YgPif9UAM_Loc8RicKG9iioPAse-ePdhtF6l-L2mLUyJibiJ17kc1JJ_-RHhj9bxmQBZ_FidVv53scEpt3p4BqOyelXB2yxnajU8zOb_DrIlJNGiSSFkAqVoxd8GcDU7hLCXw2Sk3mmdy1JUPiqsFFse-ZZVnOsxzSdEDiPI_rhBDTZbfoyU_LtYTIKwjtPaTmWxwbC7V3BpdncZTOftolFeJhTA47hfXCK_eWbGWnSpg6Dzs-844n_yIuYWkG06tqO9Wm-1fT2asAUITyprOe1GTs6HL-8iymcFn0oZx2rvQ6K-wSI-CLEL5vog4g1nXwrKx9NFc1L7A0YVHXl2F3x2dTlIivhm8_4JjQeMTCWOzJvOEdbqWI7wu0ZEvncofcoePYdL-BUWVfQBu-WiAbZU9ahCV-eF4W72HO3vsxoYwClKxZLLrL_9YTP-aeTSVM60QEB0NsluBqOL2sJMOVAFXTvtmAjU2eRf0GPmkdITVAMjQ5CdioBdKdHLBfOqwkrRDLwUSn1WiZrNrGCrK4sBPp8oSN1di6N9uud_o3nPfXVgrGdmb9F5cUsNhT_Mv1rWK9EXxcj8R_dUA1_TmVs910boIZatgXSrGiqtmvR-IFMXRbzGmW9cEvt_qYdZi-nCanNpxUrDoI68tBzEeBz08NZUJiOyz_Q3mPkBf1BAoZYht2L6_V6RaAEOSidbkLGCk1H8hv7U3eyv4RCDBJK1_H73bRmqZbtV-P4hPxWPfPWNGwz25gDF1kHfsbeM8F4zLW3VNfdMtYQtdk5Z6n5GXhweimcDFpmfi3JYbw_MdhbdsAXSCQsa-qnn7_tgFHaBvG1yXpAeOIYbj7A_MmdUVWW0nVUXdit6dK9yZbYcSaxbLb0udSt0EtUT1aUMp0HwfMjjhKCH4v00x8cFGqTLyx2K0QKtGuLKk-HmBluw4LSsm1pXMXDUB-cHQ660Kb0t
…[16715 chars clipped]…
ILAIQQ-NWnkPRNobqy9yrsK74C22dT0rWsPBG_f2F0cQQmKbEcd--4EjZXgUsgtUSCKyU8G_TKeFWA58yv2Gtmp-58husazvzd1LRP6FUnz_HV_Li6cFahoORBGIc3PcXh4loezW32ZqJVKWv7ednzcOoFmLX8LRI52yNkmLnuTUvDH9KMWMDThvUK75bVNbkn1aOdLBthb26AyBI2Drx2AEVT4fw331ixPw9DNPgSe0YVQqf5MhuvqlI_PBvGecR38SEIATQPpwvFhSVlRUEDlJo6N9w9NPE5v2A5OE5PtM_y_WSgiIUydVXVV9VPOHDnEQ4vmiiflIceVCXDYhRJtCAm7NVlt4cRZ27nMUK6CWyFVd1sUBv1FRcXN_bj2RGYT8bmHZ2KAgVNmk2BW3XF_go28_1A-hDoLDe42QUpPP10hWDgpr7TT5Ov2iAKgVVLOSHEY6-SJHRAWAPeqh30hBh-tPbTeZoWJ8jV8ri5ny_0oN1-oUWK4_rq9odowZKwY3Fc2jbfrSArGJRGWjvnoXSgjor6T5dPYkk7TgBfTwuUhdwzDV_QjDBmCfAbUrsj6QmFQ38F2D-zqJPZzDdFqJKceCDoysnMSyC5-B0Ovio-UmBGpRKEtrLjBP01dlGaZGJAVqG02avjcbBNyC3ep_NrJ4ERzXaQV3OCXjZ32rwiUsUSmQmrcnOZ29szyuDClakMLqxVOa07uzjU4qRH96wA04JwHZCsYeC47GRGHEC28Op-aIARHV_ia-BiSyZG65Os_kKUmCez3lLFIcWl0wh-Xt306MEXnoSQPBZlaRvurtARXCzG5yEQ5x7oZB1CxYbiYtnGRjyUadZFYyRe_V3wp4SuInomwFLGb6pJ4_YAAXftZ4RPtj0mXIsWTsqtZOA2VoV5R1bj9uhHJLat2t5ZPO0tBMoi3ACPb_QWRp0Hp8C4axNS0kwKh6Jxr5ev-E8HppFTE9XmhQtfS9kWpI3FezZt9FdNnR89VO3QrDc2kCPBa8nMv2uR9v9XInPFYYpd3H15LdP5t4VZMZyOfqu9AavvqUxSitxW0On67KF2XKuKGJBUne80P6hQpDmAMJXF09iT0tlHfcPhmxfb2PORotw0YIUJLtSpoPNTG5h06_YjkYdJZaWVkxlDk1DXRNUaGibbmCPUEPQYp7X8xzfaiiBF_HdTRIzf4mvtEqFqrEoCoH7HF6VXEEmRWL6ZqkB6eRXytH0qQ-rzW2ny9YzVSq_4nb_xG5vsjnedr8l2pYsCjuL09HE81C5-Z6Ru0VBadeMg2Mj7NNvxfp8D5NKUC12n8K42bTJ1iNL-49EppMudwr7eKBwLRFQLEFbTZIo8DePWBdFGnvXwyDfxHvJuDzS1Chr8qLjpIOLJEg1K69WiXxsbZWvoodEEfZQtvvnktxsXSRR9l-3r4uV-JWWY5MXl64fwDXZxPzsZgrKHs0MXmGTPnI1vy4TAYwXdE_tZKkumN1_oItNeYeSYO6nq3xrxEiNmqpO_dc7A7jgdjbux63WFQ5OG-_VnahydX05NTQZScyu7ohG_10bBq5-6BR5N6w-d3Fowd2G3_3oWXM0Y-X3716lniwYxr8k8bm-C_hd98IE8sEYs9SGnFMEzWcUP76yBYIEV5FfiVStbQ99Di1Q37xb5--s-kdGc1AbznUs19cabzBAgtJuO4udVgLgLfwkF0WZlFlZ_Bez3ooVkNlviRw9AZcC8RQaemMG1Du8wQcrt3fKNtn1IcZESWFoFJXvIhdeSKDb96pZG_bzzVyOx1ru5M-lUbf9QyoTMgmUQCyv4Ivid0J-MHSucDgwoHIMT9YkgByRIUCSS3paKH5JFkWNGmo73yG44LA9xoKBy2CEHIVR8rPZZfFxg0ITx3KX2jUp7s4NzJ9BA-5MfmwdkLdRpLrKT_6XQLqi846P61vXgqsHlHY9N2ixHJMg_MKqQvEtKNumAQItem4ofGcIPhZgmeL6Rq2iZrfUFJ-5LyfgHc3wettyXLaqQpKNNgjRw0_7XWAIaasceDsyb3LgR0UF5tI66D6vt7-btZ27yzH3fOqYIMQaD1nFpmD0wd5LjHkdpFJSCBAcvoYCxGUD0B4QFx9utAzMw5_aYk797jFeoV6uEQ1uVXux9A0qzcl_4fkAIDm-AADg7WI-ygxtGpjG79H1KZmVjuvNXKt4DyFZE-Q5MKj9FFr2jaKf3S_qFjEsrMI1No025jhJ3KFW8yqgwx9C1tXcDTPhl06ghG17mH3w2XkZSbFgfvaUaMrbPN5DlkYrxwtPlOsWBrK9DbGgk4k--lL6CgehPGGXO7p_Ls1wCMIVvaIVvC14KGhpp9ScSRsWFiOGkIU02TVh4e-HlXizMnWI2eg_BxTx_0inJgfwsUqNeSdbANmcYGR0I8jc5YdVU7u0oPPLolEex5FE3cmRquoSjFTxu-qJHIP3Qd1Be5kwb-fITjWEe0PKtDe_A7EptFmFQrgIcvw6T2xZUm0lCiwcgD3_ph7yHij_Tk2m9FLbyTdCkpekFTreXEHVHZY=.eyJlbmRwb2ludF9zbHVnIjoib3BlbmFpL28zLTIwMjUtMDQtMTZ8b3BlbmFpIn0",
format: "openai-responses-v1",
}, {
id: "msg_tmp_imowgllm5k",
type: "message",
role: "assistant",
status: "completed",
content: [Array ...],
}
],
error: null,
incomplete_details: null,
access_programs: {
Streaming Web Search
Monitor web search progress with streaming:const response = await fetch('https://openrouter.ai/api/v1/responses', {
method: 'POST',
headers: {
'Authorization': `Bearer ${process.env.OPENROUTER_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
model: 'openai/o3',
input: [
{
type: 'message',
role: 'user' as const,
content: [
{
type: 'input_text',
text: 'What is the latest news about AI?',
},
],
},
],
plugins: [{ id: 'web', max_results: 2 }],
stream: true,
max_output_tokens: 9000,
}),
});
const reader = response.body!.getReader();
const decoder = new TextDecoder();
stream: while (true) {
const { done, value } = await reader.read();
if (done) break;
const chunk = decoder.decode(value);
const lines = chunk.split('\n');
for (const line of lines) {
if (line.startsWith('data: ')) {
const data = line.slice(6);
if (data === '[DONE]') break stream;
try {
const parsed = JSON.parse(data);
if (parsed.type === 'response.output_item.added' &&
parsed.item?.type === 'message') {
console.log('Message added');
}
if (parsed.type === 'response.completed') {
const annotations = parsed.response?.output
?.find(o => o.type === 'message')
?.content?.find(c => c.type === 'output_text')
?.annotations || [];
console.log('Citations:', annotations.length);
}
} catch (e) {
// Skip invalid JSON
}
}
}
}
import requests
import json
response = requests.post(
'https://openrouter.ai/api/v1/responses',
headers={
'Authorization': 'Bearer YOUR_OPENROUTER_API_KEY',
'Content-Type': 'application/json',
},
json={
'model': 'openai/o3',
'input': [
{
'type': 'message',
'role': 'user',
'content': [
{
'type': 'input_text',
'text': 'What is the latest news about AI?',
},
],
},
],
'plugins': [{'id': 'web', 'max_results': 2}],
'stream': True,
'max_output_tokens': 9000,
},
stream=True
)
for line in response.iter_lines():
if line:
line_str = line.decode('utf-8')
if line_str.startswith('data: '):
data = line_str[6:]
if data == '[DONE]':
break
try:
parsed = json.loads(data)
if (parsed.get('type') == 'response.output_item.added' and
parsed.get('item', {}).get('type') == 'message'):
print('Message added')
if parsed.get('type') == 'response.completed':
output = parsed.get('response', {}).get('output', [])
message = next((o for o in output if o.get('type') == 'message'), {})
content = message.get('content', [])
text_content = next((c for c in content if c.get('type') == 'output_text'), {})
annotations = text_content.get('annotations', [])
print(f'Citations: {len(annotations)}')
except json.JSONDecodeError:
continue
package main
import (
"bufio"
"bytes"
"encoding/json"
"fmt"
"net/http"
"os"
"strings"
)
func main() {
body, _ := json.Marshal(map[string]any{
"model": "openai/o3",
"input": []map[string]any{
{
"type": "message",
"role": "user",
"content": []map[string]any{
{"type": "input_text", "text": "What is the latest news about AI?"},
},
},
},
"plugins": []map[string]any{{"id": "web", "max_results": 2}},
"stream": true,
"max_output_tokens": 9000,
})
req, _ := http.NewRequest("POST", "https://openrouter.ai/api/v1/responses", bytes.NewReader(body))
req.Header.Set("Authorization", "Bearer "+os.Getenv("OPENROUTER_API_KEY"))
req.Header.Set("Content-Type", "application/json")
resp, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
scanner := bufio.NewScanner(resp.Body)
scanner.Buffer(make([]byte, 1024*1024), 16*1024*1024)
for scanner.Scan() {
line := scanner.Text()
if !strings.HasPrefix(line, "data: ") {
continue
}
data := strings.TrimPrefix(line, "data: ")
if data == "[DONE]" {
break
}
var parsed struct {
Type string
Item struct{ Type string }
Response struct {
Output []struct {
Type string
Content []struct {
Type string
Annotations []any
}
}
}
}
if json.Unmarshal([]byte(data), &parsed) != nil {
continue // Skip invalid JSON
}
if parsed.Type == "response.output_item.added" && parsed.Item.Type == "message" {
fmt.Println("Message added")
}
if parsed.Type == "response.completed" {
count := 0
find:
for _, o := range parsed.Response.Output {
if o.Type == "message" {
for _, c := range o.Content {
if c.Type == "output_text" {
count = len(c.Annotations)
break
}
}
break find
}
}
fmt.Println("Citations:", count)
}
}
}
curl -sN https://openrouter.ai/api/v1/responses \
-H "Authorization: Bearer $OPENROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "openai/o3",
"input": [
{
"type": "message",
"role": "user",
"content": [
{
"type": "input_text",
"text": "What is the latest news about AI?"
}
]
}
],
"plugins": [{"id": "web", "max_results": 2}],
"stream": true,
"max_output_tokens": 9000
}' | sed -un 's/^data: //p' | jq -rR '
fromjson? |
if .type == "response.output_item.added" and .item.type == "message" then
"Message added"
elif .type == "response.completed" then
"Citations: \(([.response.output[]? | select(.type == "message")
| .content[]? | select(.type == "output_text") | .annotations][0] // []) | length)"
else empty end'
Output
Message added
Annotation Processing
Extract and process citation information:function extractCitations(response: any) {
const messageOutput = response.output?.find((o: any) => o.type === 'message');
const textContent = messageOutput?.content?.find((c: any) => c.type === 'output_text');
const annotations = textContent?.annotations || [];
return annotations
.filter((annotation: any) => annotation.type === 'url_citation')
.map((annotation: any) => ({
url: annotation.url,
text: textContent.text.slice(annotation.start_index, annotation.end_index),
startIndex: annotation.start_index,
endIndex: annotation.end_index,
}));
}
const result = await response.json();
const citations = extractCitations(result);
console.log('Found citations:', citations);
def extract_citations(response_data):
output = response_data.get('output', [])
message_output = next((o for o in output if o.get('type') == 'message'), {})
content = message_output.get('content', [])
text_content = next((c for c in content if c.get('type') == 'output_text'), {})
annotations = text_content.get('annotations', [])
text = text_content.get('text', '')
citations = []
for annotation in annotations:
if annotation.get('type') == 'url_citation':
citations.append({
'url': annotation.get('url'),
'text': text[annotation.get('start_index', 0):annotation.get('end_index', 0)],
'start_index': annotation.get('start_index'),
'end_index': annotation.get('end_index'),
})
return citations
result = response.json()
citations = extract_citations(result)
print(f'Found citations: {citations}')
type Annotation struct {
Type string
URL string
StartIndex int `json:"start_index"`
EndIndex int `json:"end_index"`
}
type Response struct {
Output []struct {
Type string
Content []struct {
Type string
Text string
Annotations []Annotation
}
}
}
type Citation struct {
URL string `json:"url"`
Text string `json:"text"`
StartIndex int `json:"startIndex"`
EndIndex int `json:"endIndex"`
}
extractCitations := func(response Response) []Citation {
citations := []Citation{}
for _, o := range response.Output {
if o.Type != "message" {
continue
}
for _, c := range o.Content {
if c.Type != "output_text" {
continue
}
text := []rune(c.Text)
for _, a := range c.Annotations {
if a.Type != "url_citation" || a.StartIndex < 0 || a.EndIndex > len(text) || a.StartIndex > a.EndIndex {
continue
}
citations = append(citations, Citation{
URL: a.URL,
Text: string(text[a.StartIndex:a.EndIndex]),
StartIndex: a.StartIndex,
EndIndex: a.EndIndex,
})
}
return citations
}
return citations
}
return citations
}
var result Response
if err := json.NewDecoder(resp.Body).Decode(&result); err != nil {
panic(err)
}
citations := extractCitations(result)
out, _ := json.MarshalIndent(citations, "", " ")
fmt.Println("Found citations:", string(out))
RESPONSE=$(curl -s -X POST https://openrouter.ai/api/v1/responses \
-H "Authorization: Bearer $OPENROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "openai/o3",
"input": "What is OpenRouter?",
"plugins": [{"id": "web", "max_results": 3}],
"max_output_tokens": 9000
}')
echo "$RESPONSE" | jq -r '
[.output[]? | select(.type == "message") | .content[]? | select(.type == "output_text")][0] as $t
| "Found citations:",
[($t.annotations // [])[] | select(.type == "url_citation") | {
url,
text: $t.text[.start_index:.end_index],
startIndex: .start_index,
endIndex: .end_index
}]'
Best Practices
- Limit results: Use appropriate
max_resultsto balance quality and speed - Handle annotations: Process citation annotations for proper attribution
- Query specificity: Make search queries specific for better results
- Error handling: Handle cases where web search might fail
- Rate limits: Be mindful of search rate limits
Next Steps
- Learn about Tool Calling integration
- Explore Reasoning capabilities
- Review Basic Usage fundamentals