Tìm kiếm và lấy nội dung web DeepSeek
Chọn tìm kiếm trực tiếp, lấy nội dung trang hoặc để mô hình dùng công cụ web tạo câu trả lời.
Chọn cách gọi
| Nhu cầu | Cách gọi |
|---|---|
| Tìm trang theo từ khóa và tự xử lý kết quả | Search trả liên kết, tóm tắt và nội dung tùy chọn; không cần model |
| Có URL và cần đọc nội dung | Fetch trả tiêu đề và nội dung Markdown; không cần model |
| Muốn mô hình tra cứu rồi trả lời trực tiếp | Khai báo công cụ web phía máy chủ qua Responses hoặc Messages; mô hình chọn và thực hiện thao tác |
Các yêu cầu sau dùng API Key của nền tảng. API độc lập và công cụ mô hình đều có thể phát sinh phí.
Tìm kiếm và lấy nội dung trực tiếp
1. Tìm kiếm web
curl 'https://api.agtcloud.cn/v1/tools/search' \
-H 'Authorization: Bearer your-api-key' \
-H 'Content-Type: application/json' \
--data '{
"query": "DeepSeek site:api-docs.deepseek.com",
"count": 5,
"need_content": false
}'Chọn trang liên quan trong results và đọc url. Nếu không có kết quả phù hợp, điều chỉnh truy vấn hoặc phạm vi. Đặt need_content: true để kèm nội dung trang trong kết quả.
2. Lấy nội dung trang đã chọn
Thay URL bên dưới bằng results[].url đã chọn ở bước trước:
curl 'https://api.agtcloud.cn/v1/tools/fetch' \
-H 'Authorization: Bearer your-api-key' \
-H 'Content-Type: application/json' \
--data '{
"url": "https://example.com/"
}'Đọc title và content; dùng Markdown để hiển thị, truy xuất hoặc làm đầu vào cho mô hình. Mỗi lần tìm kiếm và lấy nội dung thành công được tính phí riêng. Nhiều kết quả vẫn chỉ tính một yêu cầu tìm kiếm.
Để mô hình gọi công cụ web
Thay MODEL_ID bằng ID đầy đủ của mô hình hỗ trợ công cụ tương ứng. Công cụ chạy ở máy chủ; phía khách không cần tự tìm kiếm hoặc gửi lại kết quả công cụ.
Chọn deepseek-v4-pro. web_search thực hiện tìm kiếm và mở trang; không cần khai báo riêng công cụ Fetch.
curl 'https://api.agtcloud.cn/v1/responses' \
-H 'Authorization: Bearer your-api-key' \
-H 'Content-Type: application/json' \
--data '{
"model": "MODEL_ID",
"reasoning": {"effort": "none"},
"max_output_tokens": 4096,
"tools": [{"type": "web_search"}],
"input": "Tìm trang web chính thức của Python, đọc các trang liên quan, giới thiệu ngắn gọn mục đích và cung cấp liên kết nguồn."
}'Xem cấu trúc yêu cầu và phản hồi đầy đủ tại Responses và Messages.
Đọc kết quả và mức sử dụng
| Cách gọi | Vị trí và ý nghĩa |
|---|---|
| Search / Fetch độc lập | Search đọc results, Fetch đọc title/content; không trả thêm usage |
| Kết quả Responses | web_search_call trong output mô tả thao tác web; câu trả lời cuối ở phần văn bản của message |
| Mức sử dụng Responses | usage.server_tool_use.tool_search đếm truy vấn tìm kiếm thành công; một lần gọi có nhiều truy vấn có thể tính nhiều lần. tool_fetch đếm lần đọc trang thành công, gồm mở trang và tìm văn bản trong trang. Bỏ qua server_tool_use khi cả hai bằng không |
| Kết quả Messages | content gồm server_tool_use, web_search_tool_result và khối văn bản câu trả lời cuối |
| Mức sử dụng Messages | usage.server_tool_use.web_search_requests đếm lần thử, có thể gồm thất bại hoặc vượt max_uses. tool_search đếm tìm kiếm thành công có kết quả; nền tảng tính phí tìm kiếm theo số lần thành công |
| Mức sử dụng khi phát trực tuyến | Responses đọc response.usage từ sự kiện cuối response.completed/incomplete/failed; Messages đọc giá trị tích lũy từ message_delta.usage cuối, không cộng với sự kiện ban đầu |
Khai báo công cụ không đảm bảo mô hình sẽ tìm kiếm; xem số lần trong mức sử dụng trả về. Responses bỏ qua max_tool_calls, và số lần yêu cầu trong lời nhắc không phải giới hạn số lần tính phí.