Web 和 Gemini-compatible

MoonApiX 提供网页搜索、网页阅读和 Gemini-compatible 内容生成接口。它们适合需要实时信息、网页正文提取、图文理解或 Gemini 格式接入的应用。

网页搜索

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"
  }'

常用字段：

字段	类型	说明
query	string	搜索关键词。
area	string	可选。global 或 cn。
freshness	string	可选。Day、Week、Month、Year。
includeImages	boolean	可选。是否包含图片结果。
page	integer	可选。页码。
count	integer	可选。每页数量。
format	string	可选。json、markdown、md、text、txt。

网页阅读

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
  }'

常用字段：

字段	类型	说明
url	string	要读取的网页 URL。
format	string	返回格式。
liteMode	boolean	是否启用精简模式。
includeImages	boolean	是否包含图片。
onlyCSSSelectors	string[]	可选。只读取匹配选择器的内容。
waitForCSSSelectors	string[]	可选。等待指定元素出现后再读取。

Gemini-compatible

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": "写一段简短的产品介绍。"
          }
        ]
      }
    ]
  }'

图片理解可使用 inlineData：

{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "描述这张图片。"
        },
        {
          "inlineData": {
            "mimeType": "image/png",
            "data": "<BASE64_IMAGE>"
          }
        }
      ]
    }
  ]
}

使用建议

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

更多字段和响应结构见 API Reference。