Java 项目怎么接生图 API？Spring Boot 调甜甜圈API 的完整写法

网上讲 AIGC 接口接入的文章九成是 Python，但国内做业务系统的大量是 Java。上周把生图能力接进一个 Spring Boot 项目，记一下踩过的地方。

服务用的是甜甜圈API （dashengfenshen.cn），它的文生图接口 兼容 OpenAI 的 chat/completions 协议，所以 Java 侧不需要找什么专用 SDK，标准 HTTP 客户端就能调。

一、接口信息

项	值
Base URL	`https://dashengfenshen.cn`
接口	`POST /v1/chat/completions`
鉴权	请求头 `Authorization: Bearer {你的API密钥}`
数据格式	`application/json`，UTF-8

二、用 JDK 自带的 HttpClient

不引第三方依赖，JDK 11+ 的 HttpClient 就够：

复制代码

@Service
public class ImageGenService {

    private static final String BASE = "https://dashengfenshen.cn/v1/chat/completions";

    @Value("${ttq.api-key}")
    private String apiKey;                       // 放配置里，别硬编码进代码

    private final HttpClient http = HttpClient.newBuilder()
            .connectTimeout(Duration.ofSeconds(10))
            .build();
    private final ObjectMapper mapper = new ObjectMapper();

    public String generate(String prompt, String model) throws Exception {
        Map<String, Object> body = Map.of(
                "model", model,                  // nano-banana2 / nano-banana-pro / gpt-image-2
                "messages", List.of(Map.of("role", "user", "content", prompt))
        );

        HttpRequest req = HttpRequest.newBuilder(URI.create(BASE))
                .header("Authorization", "Bearer " + apiKey)
                .header("Content-Type", "application/json")
                .timeout(Duration.ofSeconds(120))   // 生图慢，读超时一定要给足
                .POST(HttpRequest.BodyPublishers.ofString(
                        mapper.writeValueAsString(body), StandardCharsets.UTF_8))
                .build();

        HttpResponse<String> resp = http.send(req, HttpResponse.BodyHandlers.ofString());
        if (resp.statusCode() != 200) {
            throw new IllegalStateException("生图失败 " + resp.statusCode() + ": " + resp.body());
        }
        return resp.body();
    }
}

三、三个必须注意的点

1. 超时要分开设。 connectTimeout 是连接超时，给 10 秒足够；但读超时得设到 120 秒------生图不是普通接口，几秒起步，Pro 级出 4K 更久。很多人只设了连接超时，然后在生产上看到一堆莫名其妙的读超时。

2. 别在 Web 请求线程里同步等。 用户点一下要等几十秒，连接池很快就被占满。正确做法是丢进异步任务，前端轮询或者用 WebSocket 推：

复制代码

@Async("genExecutor")
public CompletableFuture<String> generateAsync(String prompt, String model) {
    return CompletableFuture.completedFuture(generateQuietly(prompt, model));
}

线程池大小按自己的配额定，别无限放大。

3. 密钥只能在服务端。 这是老生常谈但真的有人犯：Authorization 头里的密钥绝不能出现在前端代码、小程序包或 App 里，一律走后端代理。

四、模型和成本

model 字段可选值和消耗（积分制按次计费）：

模型代码	说明	消耗
`nano-banana2`	Flash 级，速度更快	8 积分/次
`Nano Banana 2 Lite`	轻量版，更快更便宜	8 积分/次
`nano-banana-pro`	Pro 级，支持 1K/2K/4K	10 积分/次
`ttq-cutout`	抠图	10 积分/次
`Veo 3.1 视频生成`	Google Veo 3.1	120 积分/次
`Sora 2`	OpenAI Sora 2，16:9 / 9:16，12 秒	130 积分/次

换模型只改 model 字符串，Java 侧连方法签名都不用动，做降级链特别方便：主模型失败自动落到便宜的那个，服务不断。

五、小结

Java 接 生图 API 其实没什么特殊的，把超时、异步、密钥这三件事处理对就行。甜甜圈API（dashengfenshen.cn）的 OpenAI 兼容协议让 Java 侧完全不需要专用 SDK：

一个接口 + 一个密钥接生图、抠图、生视频全部模型；
价格便宜，单次成本明码标价，业务能直接算账；
并发高，批量任务不用自己写复杂限流；
出图快、出视频快，异步任务的排队时间短很多；
稳定，上游抖动不该变成你的线上事故。

文档地址：https://dashengfenshen.cn 。