Anthropic Web Search
Generate cited answers using web search.
جستجوی وب مبتنی بر مدل (Anthropic).
تولید پاسخ دارای استناد با Claude و جستجوی وب. پیام‌ها و max_tokens را ارائه کنید. مدل و ابزار web_search توسط سرویس مدیریت می‌شوند؛ max_uses تعداد جستجوها را محدود می‌کند. پاسخ یک شیء Anthropic Messages با بلوک‌های tool-use، search-result و text است. usage مصرف منابع را گزارش می‌کند، نه هزینه Felo را.
مرجع قیمت‌گذاری
- اندازه‌گیری: اجزای پاسخ اندازه‌گیری‌شده.
- برآورد درخواست مرجع: 0.3 دلار آمریکا.
- ضریب مشتری مرجع: 1.0. ضریب‌های مرجع را نباید دوباره روی مبالغ تسویه‌شده مشتری اعمال کرد.
فقط فراداده مرجع، نه نقل‌قول حساب، نه قیمت تضمین‌شده و نه سقف هزینه. اعتبار منابع، اعتبار Felo نیست. هزینه‌های نهایی تابع سوابق صورت‌حساب Felo است.
- نوع: integermax
_tokens الزامیحداکثر تعداد توکن‌هایی که در پاسخ تولید می‌شود. این پارامتر توسط Messages API بالادست الزامی است.
- نوع: array object[]messagesالزامی
پیام‌های گفتگو، با همان قالبی که Anthropic Messages API استفاده می‌کند. نوبت کاربر حاوی پرسش شماست.
- contentنوع: string
متن پیام. بلوک‌های محتوای ساختاریافته نیز پذیرفته می‌شوند.
- roleنوع: string فهرست مقادیرمقادیر
- user
- assistant
- نوع: stringsystem
دستور سیستمی اختیاری برای هدایت لحن یا قالب پاسخ.
- نوع: object200
یک پاسخ استاندارد Anthropic Messages.
content[]جستجوهای انجام‌شده و پاسخ مستند را درهم می‌آمیزد؛usage.server_tool_use.web_search_requestsتعداد جستجوهای صورت‌حساب‌شده است.- نوع: array object[]content
بلوک‌های مرتب: server_tool_use (کوئری‌های جستجو)، web_search_tool_result (منابع) و text (پاسخ همراه با ارجاع‌ها).
شیء خالی - نوع: stringid
- نوع: stringrole
- نوع: stringstop
_reason - نوع: stringtype
- نوع: objectusage
- cacheنوع: integer
_creation _input _tokens Integer numbers.
- cacheنوع: integer
_read _input _tokens Integer numbers.
- inputنوع: integer
_tokens Integer numbers.
- outputنوع: integer
_tokens Integer numbers.
- serverنوع: object
_tool _use - webنوع: integer
_search _requests تعداد جستجوهای وب صورت‌حساب‌شده.
application/json - 400
درخواست پردازش نشد. پارامترهای درخواست را بررسی کنید.
- 401
یک کلید API معتبر Felo لازم است.
- 402
درخواست ادامه نمی‌یابد چون یک الزام صورت‌حساب برآورده نشده است.
- 403
حساب مجاز به انجام این عملیات نیست.
- 429
به سقف درخواست یا هزینه رسیده‌اید.
- 502
سرویس نتوانست درخواست را کامل کند.
- 503
سرویس API یا صورت‌حساب موقتاً در دسترس نیست.
- 504
سرویس هنگام پردازش درخواست به پایان مهلت رسید.
- default
پاسخ خطا؛ پاسخ‌های عبوری بالادست ممکن است از قالب‌های ارائه‌دهنده استفاده کنند
application/json
curl https://openapi.felo.ai/v1/beta/anthropic-websearch/search \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '{
"max_tokens": 1024,
"messages": [
{
"role": "user",
"content": "What are the three biggest AI announcements this week? Give one sentence each with sources."
}
]
}'
{
"id": "string",
"type": "message",
"role": "assistant",
"stop_reason": "end_turn",
"content": [
{}
],
"usage": {
"input_tokens": 1,
"output_tokens": 1,
"cache_read_input_tokens": 1,
"cache_creation_input_tokens": 1,
"server_tool_use": {
"web_search_requests": 1
}
}
}