GET STARTED
三步发出第一个搜索请求
创建密钥,然后用一个 POST 请求把实时网页结果交给你的 Agent。
- 1
创建账号
注册并登录 Prismex Console。
- 2
创建 API Key
- 3
发送请求
把密钥放进 Authorization Bearer header。
curl -X POST https://prismex.cc/api/v1/search \
-H "Authorization: Bearer psk_..." \
-H "Content-Type: application/json" \
-d '{"query":"latest AI model releases","count":10}'
Response shape
| Field | Type | Description |
|---|---|---|
query | string | 规范化后的查询。 |
results | array | 包含 title、url 与 snippet 的结果。 |
request_id | string | 用于日志关联和排障。 |
SECURITY
Authentication
每个搜索请求都必须携带 Prismex API Key。
Authorization: Bearer psk_...创建和保存密钥
在 Console / API Keys 创建密钥。完整值只显示一次,请放入 secret manager,不要提交到代码仓库。
API Key 代表你的账户权限和额度。怀疑泄露时应立即撤销并轮换。
REFERENCE + TESTER
REST API
支持 GET query parameters 与 POST JSON body。下方 tester 仅在你手工输入 Bearer key 并点击运行时发出请求。
POST
https://prismex.cc/api/v1/search根据 query 检索公开网页,返回结构化结果。
| Field | Type | Required |
|---|---|---|
query | string | yes |
count | integer 1–50 | no |
freshness | string | no |
运行结果将显示在这里。
MODEL CONTEXT PROTOCOL
MCP
使用 Streamable HTTP,把 Prismex Web Search 作为远端 MCP 工具接入客户端。
- 1
Transport
streamableHttp - 2
URL
https://prismex.cc/mcp - 3
Tool
web_search
AGENT SKILL
Skill
下载说明文件与零依赖 Python 脚本,把搜索工作流交给 Agent。
ERROR REFERENCE
错误码
失败响应包含稳定的 error code;可使用 request_id 关联日志。
| Error | HTTP | Description |
|---|---|---|
unauthorized | 401 | 缺少 Bearer token。 |
forbidden | 403 | API Key 无效或已撤销。 |
bad_request | 400 | 请求格式无效。 |
missing_query | 400 | query 为空。 |
rate_limited | 429 | 请求频率超限。 |
quota_exceeded | 429 | 周期配额已用完。 |
insufficient_credits | 402 | 账户搜索额度不足。 |
upstream_unavailable | 502 | 上游搜索暂时不可用。 |
internal | 500 | 服务内部错误。 |