Jina Search API

• 功能概述
• 请求示例
• 返回结果
• Java 客户端使用示例
• 总结

Jina Search API 将搜索引擎和内容转换功能相结合，不仅可以搜索相关网页，还能将返回的网页内容进行转换和整合，便于后续处理和大模型理解。

功能概述

• 搜索引擎： 根据用户输入的查询条件，搜索相关网页。
• 内容转换： 将搜索到的网页内容进行转换，返回易于阅读和分析的数据格式。

请求示例

你可以使用 curl 命令来调用 Jina Search API，以下示例展示了如何进行请求：

curl https://s.jina.ai/%E5%A6%82%E4%BD%95%E5%88%9B%E5%BB%BAtio-boot%E9%A1%B9%E7%9B%AE \
  -H "Authorization: Bearer jina_cf99cd628dd34559b21d1f967bfe6cceGqIE6CtNk0JmiZ2sslSu77E3FcYR" \
  -H "X-Retain-Images: none"

在上面的请求中：

• URL 说明： 请求 URL 包含经过 URL 编码后的查询关键词，此例中查询的是“如何创建 tio-boot 项目”。
• Authorization 头： 用于身份认证，其中包含了 API Key。
• X-Retain-Images 头： 设置为 none，表示在返回结果中不包含图片内容。

注意： 请求延迟大约为 59 秒，并且 API 将返回 6 个网页的内容。

返回结果

调用成功后，Jina Search API 会返回两个网页的转换内容。返回的数据中将包含标题、描述、网页 URL 以及经过内容转换后的详细内容，具体格式可能根据 API 版本和参数有所不同。

Java 客户端使用示例

对于 Java 开发者，java-openai 已经内置了 JinaSearchClient，可以直接调用该客户端来使用 Jina Search API。下面的示例展示了如何在 Java 中集成调用：

package com.litongjava.perplexica.services;

import org.junit.Test;
import com.litongjava.jian.search.JinaSearchClient;
import com.litongjava.tio.utils.environment.EnvUtils;

public class JinaSearchServiceTest {

  @Test
  public void test() {
    // 加载环境变量配置，例如 JINA_API_KEY
    EnvUtils.load();
    // 使用 JinaSearchClient 进行搜索，并返回相关网页的转换内容
    String result = JinaSearchClient.search("How can I run deepseek r1 with lama.cpp");
    // 输出搜索结果
    System.out.println(result);
  }
}

在该示例中：

• 通过 EnvUtils.load() 方法加载环境变量配置（例如：JINA_API_KEY）。
• 使用 JinaSearchClient.search(query) 方法执行搜索查询，其中 query 为用户输入的查询内容。
• 最后将返回的搜索结果打印到控制台。

总结

Jina Search API 将搜索引擎功能和内容转换功能完美结合，为用户提供了一种便捷的方式，既可以搜索相关网页，又能获取经过转换的网页内容，从而大大提高了大模型理解和处理信息的效率。无论是通过 curl 命令还是使用 Java 客户端，都可以轻松集成并使用该 API。

有关更多详细信息和最新更新，请访问 Jina 官方文档。

---

通过以上文档，你可以快速上手使用 Jina Search API，实现搜索和内容转换的功能，以满足各类应用场景的需求。