MoonApiX Docs

Appearance

Web 与 Gemini 概览 ​

Web 与 Gemini-compatible 能力覆盖网页搜索、网页阅读和 Gemini 格式内容生成。它们适合需要网页信息、正文提取、图文理解或 Gemini 兼容接入的应用。

Search网页搜索按关键词获取候选网页、摘要和相关信息。Read网页阅读读取指定网页正文，输出 Markdown、文本或 JSON。GeminiGemini-compatible使用 Gemini 风格路径和请求体进行内容生成。

路由清单 ​

方法路径用途
POST/v1/web-search/search网页搜索。
POST/v1/web-reader/read网页阅读。
POST/v1beta/models/{model}:generateContentGemini 媒体理解。
POST/v1beta/models/{modelName}:generateContentGemini 格式生成。

网页搜索 ​

bash
curl https://moonapix.com/v1/web-search/search \
  -H "Authorization: Bearer <MOONAPIX_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "MoonApiX API documentation",
    "area": "global",
    "count": 10,
    "format": "json"
  }'

网页阅读 ​

bash
curl https://moonapix.com/v1/web-reader/read \
  -H "Authorization: Bearer <MOONAPIX_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/article",
    "format": "md",
    "liteMode": true,
    "includeImages": true
  }'

Gemini-compatible ​

bash
curl https://moonapix.com/v1beta/models/gemini-compatible:generateContent \
  -H "Authorization: Bearer <MOONAPIX_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [
          {
            "text": "写一段简短的产品介绍。"
          }
        ]
      }
    ]
  }'

使用建议 ​

  • 搜索接口适合获取候选网页和摘要，阅读接口适合提取指定网页正文。
  • 对同一网页做多次处理时，建议缓存阅读结果。
  • Gemini-compatible 路径中的模型名应与 MoonApiX 后台可用模型一致。
  • 图片、PDF、音频或视频输入建议控制文件大小，避免请求过大。

相关页面 ​