快捷導(dǎo)航

Java調(diào)用即夢繪圖API實(shí)例Demo

更新時(shí)間：2025年12月11日 08:29:19 作者：綾波粒

Java提供了多種繪圖API,這篇文章主要介紹了Java調(diào)用即夢繪圖API的相關(guān)資料,文中通過圖文以及代碼介紹的非常詳細(xì),對想學(xué)習(xí)即夢繪圖的同學(xué)們具有一定的參考借鑒價(jià)值,需要的朋友可以參考下

Java調(diào)用即夢繪圖API

結(jié)果展示

prompt:“畫面展現(xiàn)詩句夕陽在西峰，疊翠縈殘雪，所描述的景象”。

即夢文生圖3.0

1.接口簡介

文生圖3.0是即夢同源的文生圖能力，在文字響應(yīng)準(zhǔn)確度、圖文排版、層次美感和語義理解能力上相較之前版本均有顯著提升，人像質(zhì)感更逼真，且支持輸出高清大圖。此外，在文字響應(yīng)更精準(zhǔn)的基礎(chǔ)下，還支持響應(yīng)大小字、各類藝術(shù)字體和不同字重

2. Prompt建議

用于編輯圖像的提示詞。建議：

畫面描述技巧：用連貫的自然語言描述畫面內(nèi)容（主體+行為+環(huán)境等），用短詞語描述畫面美學(xué)（風(fēng)格、色彩、光影、構(gòu)圖等）
文字效果增強(qiáng)：把想要生成的文字內(nèi)容插入“”引號中，可以提升文字準(zhǔn)確率
**專業(yè)詞匯表達(dá)：**推薦嘗試詞源語言/英文表達(dá)專業(yè)詞匯，效果更準(zhǔn)確
明確圖像用途：建議寫明圖像用途與類型，例如，用途PPT封面背景圖、背景素材圖/ 類型廣告海報(bào)設(shè)計(jì)、紀(jì)實(shí)攝影
**簡單語言表達(dá)：**在表達(dá)準(zhǔn)確的基礎(chǔ)上，短提示詞也能發(fā)揮驚艷的效果

接入說明

請求說明

名稱	內(nèi)容
接口地址	https://visual.volcengineapi.com
請求方式	POST
Content-Type	application/json

提交任務(wù)

提交任務(wù)請求參數(shù)

Query參數(shù)

拼接到url后的參數(shù)，示例：https://visual.volcengineapi.com?Action=CVSync2AsyncSubmitTask&Version=2022-08-31

參數(shù)	類型	可選/必選	說明
Action	string	必選	接口名，取值：CVSync2AsyncSubmitTask
Version	string	必選	版本號，取值：2022-08-31

Header參數(shù)

注意

本服務(wù)固定值：Region為cn-north-1，Service為cv

主要用于鑒權(quán)，詳見公共參數(shù) - 簽名參數(shù) - 在Header中的場景部分

Body參數(shù)

注意

業(yè)務(wù)請求參數(shù)，放到request.body中，MIME-Type為application/json

參數(shù)	類型	可選/必選	說明
req_key	string	必選	算法名稱，取固定值為jimeng_t2i_v30
prompt	string	必選	用于生成圖像的提示詞，中英文均可輸入。建議長度<=120字符，最長不超過800字符，prompt過長有概率出圖異?；虿簧?/td>
use_pre_llm	bool	可選	開啟文本擴(kuò)寫，會針對輸入prompt進(jìn)行擴(kuò)寫優(yōu)化，如果輸入prompt較短建議開啟，如果輸入prompt較長建議關(guān)閉默認(rèn)值：true
seed	int	可選	隨機(jī)種子，作為確定擴(kuò)散初始狀態(tài)的基礎(chǔ)，默認(rèn)-1（隨機(jī)）。若隨機(jī)種子為相同正整數(shù)且其他參數(shù)均一致，則生成圖片極大概率效果一致默認(rèn)值：-1
width	int	可選	1、生成圖像寬高，*系統(tǒng)默認(rèn)生成1328 1328的圖像*；2、支持自定義生成圖像寬高，寬高比在1:3到3:1之間，長度在[512, 2048]之間；推薦可選的寬高比為：標(biāo)清1K1328 1328（1:1）1472 * 1104 （4:3）1584 * 1056（3:2）1664 * 936（16:9）2016 * 864（21:9）高清2K2048 * 2048（1:1）2304 * 1728 （4:3）2496 * 1664（3:2）2560 * 1440（16:9）3024 * 1296（21:9）注意：需同時(shí)傳width和height才會生效；
height	int	可選

Java實(shí)現(xiàn)Demo

package com.volcengine.example.visual;

import com.alibaba.fastjson.JSON;
import com.alibaba.fastjson.JSONObject;
import com.volcengine.service.visual.IVisualService;
import com.volcengine.service.visual.impl.VisualServiceImpl;

public class CVProcessDemo {

    public static void main(String[] args) {
        IVisualService visualService = VisualServiceImpl.getInstance();
        // call below method if you dont set ak and sk in ～/.vcloud/config
        visualService.setAccessKey("您的 AK");
        visualService.setSecretKey("您的 SK");

        JSONObject req=new JSONObject();
        //請求Body(查看接口文檔請求參數(shù)-請求示例，將請求參數(shù)內(nèi)容復(fù)制到此)
        req.put("req_key","jimeng_high_aes_general_v21_L");
        req.put("prompt","畫面展現(xiàn)詩句夕陽在西峰，疊翠縈殘雪，所描述的景象");
        req.put("return_url",true);
        try {
            Object response = visualService.cvProcess(req);
            System.out.println(JSON.toJSONString(response));
        } catch (Exception e) {
            e.printStackTrace();
        }
    }

}

注意：body內(nèi)容

在調(diào)用時(shí)需要注意在body中放 req.put("return_url",true);字段；否則會返回base64編碼。

開啟返回url后的response示例:

{
    "code": 10000,
    "data": {
        "mood_board_llm_tag": "",
        "pe_result": "",
        "vlm_result": "",
        "llm_result": "自然風(fēng)景攝影風(fēng)格，寧靜美學(xué)。 夕陽西下，山峰被晚霞染紅；山峰上覆蓋著積雪，與翠綠相間。 夕陽的余暉灑在西峰上，映照出疊翠和殘雪的輪廓；天空呈現(xiàn)出漸變的橙紅色調(diào)。 周圍環(huán)境寧靜，遠(yuǎn)處山巒起伏，近處樹木蒼翠。 光線柔和，暖色調(diào)的夕陽光線，全景鏡頭捕捉整個(gè)場景。 風(fēng)景詩畫風(fēng)，全景視角。",
        "image_urls": [
            "https://p9-aiop-sign.byteimg.com/tos-cn-i-vuqhorh59i/20251014212608A0A9611688290FE57B6D-6296-0~tplv-vuqhorh59i-image-v1.image?rk3s=7f9e702d&x-expires=1760534775&x-signature=PrFo2ZxVPQXwisBez95ePf36aik%3D"
        ],
        "algorithm_base_resp": {
            "status_message": "Success",
            "status_code": 0
        },
        "mood_board_llm_result": "",
        "rephraser_result": "自然風(fēng)景攝影風(fēng)格，寧靜美學(xué)。 夕陽西下，山峰被晚霞染紅；山峰上覆蓋著積雪，與翠綠相間。 夕陽的余暉灑在西峰上，映照出疊翠和殘雪的輪廓；天空呈現(xiàn)出漸變的橙紅色調(diào)。 周圍環(huán)境寧靜，遠(yuǎn)處山巒起伏，近處樹木蒼翠。 光線柔和，暖色調(diào)的夕陽光線，全景鏡頭捕捉整個(gè)場景。 風(fēng)景詩畫風(fēng)，全景視角。",
        "request_id": "bf33c0b54c6e6841df524481ae3402623fc558516459bd2d56b68f6c50562d24",
        "binary_data_base64": [

        ],
        "predict_tags_result": ""
    },
    "time_elapsed": "7.740080145s",
    "message": "Success",
    "request_id": "20251014212608A0A9611688290FE57B6D",
    "status": 10000
}