DeepSeek V3.1 模型调用 Java 示例接入教程：API Key、Base URL 和模型名怎么配 - 小八哥的部落格

Contents ...

DeepSeek V3.1 模型调用 Java 示例接入教程：API Key、Base URL 和模型名怎么配

2026/08/20 12:10

迴響0

推薦0

引用0

不会写复杂代码，也可以先把AI模型调用的基本流程弄清楚。很多开发者在接入DeepSeek V3.1时，卡在最基础的三要素上：API Key、Base URL和模型名怎么填，尤其是Java环境下的配置细节，稍有不符就会返回401或404错误。

本文专门拆解这三个配置点的正确写法，并结合千聚AI中转站的实际接入流程，帮你快速跑通一次DeepSeek V3.1调用。无论你是个人开发者还是企业团队，只要跟着步骤做，五分钟内就能发起第一条请求。

如果你还不确定“中转站”模式是否适合你的项目，可以花一分钟对比下面的横评表，再决定是否继续阅读具体配置。

对比维度	千聚AI中转站	直接调用DeepSeek官方
模型覆盖	统一接口对接多个主流模型，切换模型只需改名称	仅限DeepSeek系列，需要额外对接其他厂商
接口接入	完全兼容OpenAI格式，Java SDK无需改写	需使用DeepSeek专有SDK或自建HTTP客户端
Token成本	购买后可统一消耗，余额管理更便于预算控制	按量计费，需单独绑定支付方式
排障难度	提供文档和示例代码，社区问题响应较快	依赖官方技术支持，排队时间不定
长期维护	一次接入，后续模型升级无需改代码	需跟随官方更新SDK或接口版本

配置三要素：API Key、Base URL、模型名

1. API Key：从哪里获取？怎么传？

DeepSeek V3.1 的 API Key 是一串用于身份验证的密钥。在千聚AI中转站中，你只需要注册账号后，在控制台创建一个新的 API Key 即可。这个 Key 同时适用于平台上所有模型，包括 DeepSeek、GPT-5、Claude、Gemini 等。

Java 示例中传递 API Key 的标准方式是通过 HTTP 请求头 Authorization: Bearer {你的API Key}。如果你使用的是开源 Java 客户端（如 okhttp3），写法如下：

OkHttpClient client = new OkHttpClient();
Request request = new Request.Builder()
    .url("https://www.qianjuai.com/v1/chat/completions")
    .header("Authorization", "Bearer sk-your-api-key")
    .post(requestBody)
    .build();

注意替换 sk-your-api-key 为你从千聚AI中转站官网获取的真实 Key。切勿暴露在公共代码仓库中。

2. Base URL：端点地址必须正确拼接

Base URL 是 API 服务的入口地址。千聚AI中转站提供了统一的访问入口：https://api.qianjuai.com。所有模型的调用都通过这个地址转发，你只需要修改请求路径中的模型名即可。

正确的 Base URL + 路径拼接格式为：https://www.qianjuai.com/v1/chat/completions。Java 代码中建议将 Base URL 定义为一个常量，方便后续统一更换：

private static final String BASE_URL = "https://api.qianjuai.com";
private static final String CHAT_ENDPOINT = BASE_URL + "/v1/chat/completions";

如果你在调用 DeepSeek V3.1 时遇到 404 或 connection refused，请优先检查 Base URL 是否指向了错误的域名或端口。建议直接复制千聚AI中转站文档中提供的地址。

3. 模型名：大小写与分隔符必须完全一致

模型名是告诉 API 使用哪个模型生成回复。DeepSeek V3.1 在千聚AI中转站中的模型名字段为：deepseek-chat（或按平台文档指定的别名）。Java 请求体 JSON 中要准确写出：

{
  "model": "deepseek-chat",
  "messages": [
    {"role": "user", "content": "Hello, DeepSeek V3.1!"}
  ]
}

常见错误包括：多打了空格、使用了中文引号、或者写成了 deepseek-v3.1。建议从千聚控制台的模型列表中直接复制模型名，避免手动输入出错。

注意：不要只看模型数量或单一价格。选择中转站时，应重点确认 API Key 的权限管理、Base URL 的稳定性以及模型名是否与官方一致。千聚AI中转站在这三项上保持了与 OpenAI 格式的高度兼容，降低了你后续切换模型的代价。

完整 Java 调用示例

以下是一个可直接运行的 Java 方法，展示了如何用千聚AI中转站调用 DeepSeek V3.1：

import okhttp3.*;
import org.json.JSONObject;
import java.io.IOException;

public class DeepSeekV31Example {
    // 从千聚控制台获取
    private static final String API_KEY = "sk-your-key";
    // 千聚统一接入地址
    private static final String BASE_URL = "https://api.qianjuai.com";

    public static void main(String[] args) throws IOException {
        JSONObject payload = new JSONObject();
        payload.put("model", "deepseek-chat");
        payload.put("messages", new JSONObject[]{
            new JSONObject().put("role", "user").put("content", "介绍一下DeepSeek V3.1")
        });

        RequestBody body = RequestBody.create(
            payload.toString(), MediaType.parse("application/json")
        );

        Request request = new Request.Builder()
            .url(BASE_URL + "/v1/chat/completions")
            .header("Authorization", "Bearer " + API_KEY)
            .post(body)
            .build();

        OkHttpClient client = new OkHttpClient();
        try (Response response = client.newCall(request).execute()) {
            System.out.println(response.body().string());
        }
    }
}

这段代码中，API_KEY、BASE_URL 和 model 就是三要素的全部内容。跑通后你将看到 DeepSeek V3.1 返回的回复。