java-ai-examples

Java攻城狮AI大模型项目对接学习示例参考

1. 基础框架版本

• JDK17
• SpringBoot 3.4.5
• SpringAI 1.0.1
• SpringAI Alibaba(SAA) 1.0.0.3

2. chat-example

2.1 curl-example

a. 调用OpenAI接口

OpenAI注意返回429错误

You exceeded your current quota, please check your plan and billing details. For more information on this error, read the docs: https://platform.openai.com/docs/guides/error-codes/api-errors.

curl --location 'https://api.openai.com/v1/responses' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer ${OPENAI_API_KEY}' \
--data '{
    "model": "gpt-5",
    "input": "你好你是什么大模型？"
  }'

b. 调用阿里云dashscope接口

• 兼容OpenAI

curl --location 'https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer ${DASHSCOPE_API_KEY}' \
--data '{
    "model": "qwen-plus",
    "stream": false,
    "messages": [
        {
            "role": "user", 
            "content": "你好，你是什么大模型？"
        }
    ]
}'

• 阿里云百炼API

curl --location 'https://dashscope.aliyuncs.com/api/v1/services/aigc/text-generation/generation' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer ${DASHSCOPE_API_KEY}' \
--data '{
    "model": "deepseek-r1",
    "input": {
        "messages": [
            {
                "role": "user",
                "content": "你是谁？"
            }
        ]
    },
    "parameters": {
        "result_format": "message"
    }
}'

c. 调用DeepSeekAPI

兼容openAI标准API接口

curl --location 'https://api.deepseek.com/v1/chat/completions' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer ${DEEPSEEK_API_KEY}' \
--data '{
        "model": "deepseek-chat",
        "messages": [
          {"role": "user", "content": "你好!你是谁？"}
        ],
        "stream": false
      }'

d. 调用本地Ollama

兼容openAI标准API接口

curl --location 'http://127.0.0.1:11434/v1/chat/completions' \
--header 'Content-Type: application/json' \
--data '{
    "model": "deepseek-r1:1.5b",
    "stream": false,
    "messages": [
        {
            "role": "user", 
            "content": "你是谁？"
        }
    ]
}'

3. 工程目录

持续更新...

3.1. chat-example目录

|- chat-example
    |- langchain4j-ai-chat          # 基于langchain4j框架实现chat示例
    |- spring-ai-alibaba-chat       # 基于spring-ai-alibaba框架实现chat示例
    |- spring-ai-chat               # 基于spring-ai框架实现chat示例
    |- spring-ai-deepseek-chat      # 基于spring-ai框架实现chat示例
    |- spring-ai-ollama-chat        # 基于spring-ai对接ollama实现chat示例

3.2. mcp-example目录

|- mcp-example
    |- client
        |- spring-ai-simple-mcp-client  # 基于spring-ai实现mcp客户端示例
        |- spring-ai-nacos-mcp-client   # 基于spring-ai实现mcp客户端对接Nacos3示例
    |- server
        |- spring-ai-simple-mcp-server  # 基于spring-ai实现mcp服务端示例
        |- spring-ai-nacos-mcp-server   # 基于spring-ai实现mcp服务端对接Nacos3示例

3.3. prompt-example目录

|- prompt-example
    |- spring-ai-alibaba-prompt         # 基于spring-ai-alibaba框架实现prompt示例
    |- spring-ai-ollama-prompt          # 基于spring-ai对接ollama实现prompt示例

3.4. rag-example目录

|- rag-example
    |- langchain4j-ai-memory-rag        # 基于langchain4j框架实现内存存储rag示例
    |- spring-ai-es-rag                 # 基于spring-ai对接elasticsearch实现rag示例
    |- spring-ai-memory-rag             # 基于spring-ai对接内存实现rag示例

3.5. storage-example目录

|- storage-example
    |- spring-ai-memory-storage         # 基于spring-ai对接内存实现storage示例
    |- spring-ai-mysql-storage          # 基于spring-ai对接mysql实现storage示例
    |- spring-ai-redis-storage          # 基于spring-ai对接redis实现storage示例

3.6. tools-example目录

|- tool-example
    |- spring-ai-alibaba-baidutranslate-tools           # 基于spring-ai-alibaba框架实现tool示例
    |- spring-ai-time-tools                             # 基于spring-ai对接时间工具示例-tools