把互联网接入
你的产品。

Furries.World 把实时搜索、网页读取、内容清洗、格式约束与图片理解封装成统一 JSON API。给一个 URL、检索词或图片，拿回可直接消费的数据。机器可读规格：OpenAPI 3.1 JSON。

快速开始

在 控制台 创建账号，进入「API Keys」生成一个密钥。所有请求都使用 HTTPS，Base URL 为：

https://furries.world

第一个请求

下面这个请求会搜索实时网页，并让模型返回一段带引用的中文回答：

curl https://furries.world/v1/search \
  -H "Authorization: Bearer fw_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "2026 年 AI Agent 的关键进展",
    "count": 5,
    "mode": "answer"
  }'

成功时返回 HTTP 200。每个响应都包含 request_id，排查问题时请一并提供。

{
  "request_id": "req_7a1f...",
  "object": "search",
  "query": "2026 年 AI Agent 的关键进展",
  "mode": "answer",
  "results": [
    {
      "title": "Agent 工程实践",
      "url": "https://example.com/agent",
      "snippet": "...",
      "summary": "...",
      "authority": 3,
      "relevance": 2.4
    }
  ],
  "answer": "Agent 正在从演示走向生产系统 [1]…",
  "usage": {
    "requests": 1,
    "prompt_tokens": 3120,
    "output_tokens": 420,
    "credits_charged": 15,
    "credits_remaining": 185,
    "currency": "CNY",
    "price_cny": "¥0.15"
  }
}

认证

调用 /v1/* 端点时，在请求头携带 API Key：

Authorization: Bearer fw_live_xxxxxxxxxxxxxxxxx

• Key 只在创建时完整显示一次；服务端仅保存 SHA-256 哈希。
• 每个账号最多保留 10 个有效 Key，可随时吊销。
• 不要把 Key 放在浏览器端代码、公开仓库或 URL 查询参数里。
• 认证失败返回 401 invalid_api_key，不会扣除额度。

浏览器直接调用时，/v1/* 支持 CORS；建议仍然通过你自己的后端代理，避免泄露密钥。

网页搜索

返回来自 DeepSeek 搜索的实时网页结果。mode 为 fast 时只返回结果；为 answer 时会额外生成带引用的回答。

响应字段

results[].relevance 是 0-3 的相关性分数；authority 是 0-4 的站点权威度，-1 表示未知。published_at 为 RFC 3339 时间或 null。

{
  "object": "search",
  "query": "DeepSeek 新模型",
  "mode": "fast",
  "results": [
    {
      "title": "…",
      "url": "https://…",
      "snippet": "…",
      "summary": "…",
      "site_name": "Example",
      "published_at": "2026-10-20T00:00:00+00:00",
      "authority": 3,
      "relevance": 2.6
    }
  ],
  "model": "deepseek-search",
  "usage": { "credits_charged": 5, "credits_remaining": 195 }
}

网页提取与格式化

抓取一个网页，或先搜索一个主题，再把内容清洗成 Markdown、纯文本或符合 Schema 的 JSON。适合 RAG、内容聚合、监控与数据入库。

用 Schema 控制输出

curl https://furries.world/v1/extract \
  -H "Authorization: Bearer fw_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "2026 年独立开发者趋势",
    "format": "json",
    "schema": {
      "type": "object",
      "required": ["title", "summary", "trends"],
      "properties": {
        "title": {"type": "string"},
        "summary": {"type": "string"},
        "trends": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "name": {"type": "string"},
              "evidence": {"type": "string"},
              "citation_ids": {"type": "array", "items": {"type": "integer"}}
            }
          }
        }
      }
    }
  }'

响应中的 output 在 JSON 模式下是对象，在 Markdown / text 模式下是字符串。sources 提供可回溯的来源列表。

{
  "object": "extraction",
  "format": "json",
  "output": {
    "title": "…",
    "summary": "…",
    "trends": []
  },
  "sources": [
    { "title": "…", "url": "https://…", "authority": 3 }
  ],
  "model": "deepseek-flash",
  "usage": { "credits_charged": 15, "credits_remaining": 180 }
}

视觉理解

用多模态模型理解图片：场景描述、OCR、截图分析、图表读取、结构化字段提取。支持 JPEG、PNG、GIF、WebP。

示例：读取一张截图

curl https://furries.world/v1/vision \
  -H "Authorization: Bearer fw_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://example.com/dashboard.png",
    "prompt": "提取页面标题、所有指标数值和按钮文字",
    "format": "json"
  }'

上游直接拉取外部图片 URL 时，目标站点可能拒绝访问。遇到这种情况，请把图片下载后以 Base64 传入。

深度研究

一次调用完成多源搜索、阅读、交叉验证与简报生成。返回结构化的结论、证据、冲突观点、待解问题、实践启示与置信度。

{
  "object": "research",
  "query": "AI 搜索市场的下一个增长点是什么？",
  "output": {
    "title": "AI 搜索的增长重心转向任务完成",
    "executive_summary": "…",
    "key_findings": [
      {
        "finding": "…",
        "evidence": "…",
        "source_ids": [1, 3]
      }
    ],
    "conflicting_views": [],
    "open_questions": [],
    "practical_implications": [],
    "conclusion": "…",
    "confidence": "medium"
  },
  "sources": [],
  "usage": { "credits_charged": 30, "credits_remaining": 170 }
}

研究结果是模型基于来源生成的辅助材料，不构成事实保证、投资建议或法律意见。

计费与余额

采用预充值、按成功请求扣费。每次调用的价格在请求开始前从余额中预留；如果上游失败、内容为空或生成结果无法通过 JSON 校验，系统会自动退回本次额度。

新账号自动获得体验额度。充值通过 CDKEY 完成：购买卡密后，在控制台「余额与卡密」中兑换即可入账。每张卡密只能使用一次，余额不过期。余额不足时返回 402 insufficient_balance，不会调用上游。购买卡密请联系 support@furries.world 或官方指定渠道。

查询余额：GET /v1/me；查询最近用量：GET /v1/usage?limit=50。usage 会随每次业务响应返回。

限流

• 每个 API Key：60 次/分钟，5,000 次/天。
• 每个 IP：120 次/分钟。
• 公共在线体验：每 IP 5 次/天，并受全站每日预算限制。
• 单次请求最长约 100 秒；建议客户端超时设置为 120 秒。

超限返回 429，并尽量提供 Retry-After 响应头。请不要在超时后立即重试非幂等请求；先通过 request_id 与用量记录确认结果。

错误码

所有 API 错误使用统一结构：

{
  "error": {
    "message": "余额不足。请先充值后再调用 API。",
    "type": "billing_error",
    "code": "insufficient_balance",
    "param": null,
    "request_id": "req_…"
  }
}

安全与数据

全站强制 HTTPS，API Key 仅存哈希，控制台会话使用 HttpOnly、SameSite Cookie。管理密钥与兑换卡密需要登录会话，并校验请求来源。

为了计费和排障，我们保存请求时间、端点、余额变动、延迟、token 用量、状态码与请求 ID，不把响应正文写入用量日志。搜索结果可能短期缓存以降低延迟和上游成本。请勿提交无权处理的个人信息、商业秘密或受监管数据。

需要删除账号或数据，请使用注册邮箱联系 support@furries.world。