Drawing（即梦图片生成）

正式环境

https://api.302.ai

POST

/doubao/drawing

来自即梦的图片生成模型
支持模型：
general_v3.0
最新的豆包3.0，文字渲染能力再次升级

general_v2.1_L
本次升级 (对比通用2.0和通用2.0 PRO），除了结构准确和美感明显提升外，重点支持了中英文字符渲染，推荐在通用类别（不局限于人像人体）使用

general_v2.0_L
通用2.0Pro模型（历史名称通用2.0L模型），是原生中英文双语模型，模型在图文匹配度、美感上均有进一步的提升，推荐在通用类别（不局限于人像人体）使用。
与通用2.0模型（历史名称通用2.0S模型）对比，效果进一步提升，延迟稍有增加。

general_v2.0
通用2.0模型（历史名称：通用2.0S模型），是原生中英文双语模型，模型在图文匹配度、美感上均有大幅提升。
推荐在通用类别（不局限于人像人体）、效果要求极高、延迟要求较高的场景进行使用。

介绍：https://www.volcengine.com/docs/6791/1366783

价格：0.05 PTC/次

请求参数

Header 参数

Body 参数application/json

示例

{
    "prompt": "千军万马",
    "model_version": "general_v3.0",
    "llm_seed": -1,
    "seed": -1,
    "scale": 3.5,
    "ddim_steps": 25,
    "width": 512,
    "height": 512,
    "use_pre_llm": true,
    "use_sr": true,
    "sr_seed": -1,
    "sr_strength": 0.4,
    "sr_scale": 3.5,
    "sr_steps": 20,
    "is_only_sr": false,
    "return_url": true,
    "logo_info": {
        "add_logo": false,
        "position": 0,
        "language": 0,
        "opacity": 0.3,
        "logo_text_content": "这里是明水印内容"
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.302.ai/doubao/drawing' \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data-raw '{
    "prompt": "千军万马",
    "model_version": "general_v3.0",
    "llm_seed": -1,
    "seed": -1,
    "scale": 3.5,
    "ddim_steps": 25,
    "width": 512,
    "height": 512,
    "use_pre_llm": true,
    "use_sr": true,
    "sr_seed": -1,
    "sr_strength": 0.4,
    "sr_scale": 3.5,
    "sr_steps": 20,
    "is_only_sr": false,
    "return_url": true,
    "logo_info": {
        "add_logo": false,
        "position": 0,
        "language": 0,
        "opacity": 0.3,
        "logo_text_content": "这里是明水印内容"
    }
}'

返回响应

🟢200成功

application/json

Body

示例

{
    "code": 10000,
    "data": {
        "algorithm_base_resp": {
            "status_code": 0,
            "status_message": "Success"
        },
        "binary_data_base64": [],
        "image_urls": [
            "https://file.302.ai/gpt/imgs/20260113/79f713f8236bbb1003d56ac4f1ff587a.jpg"
        ],
        "llm_result": "中国水墨画，浓墨重彩，俯视视角，千军万马在战场奔腾，战士们身穿古代战甲，手持长矛和盾牌，远处山脉与云海，动态构图，宣纸质感。",
        "pe_result": "中国水墨画，浓墨重彩，俯视视角，千军万马在战场奔腾，战士们身穿古代战甲，手持长矛和盾牌，远处山脉与云海，动态构图，宣纸质感。",
        "predict_tags_result": "",
        "rephraser_result": "",
        "request_id": "e6a8593c38b4a9b55c167aa19792d559cad70674d70e87004a252fd354eefc44",
        "vlm_result": ""
    },
    "message": "Success",
    "request_id": "202601131532344AC9081D2B4945047F92",
    "status": 10000,
    "time_elapsed": "5.408057968s"
}

修改于 2026-01-13 07:32:51

Generations（SeedEdit 3.0）

image（文字生成图片）