Character（キャラクター特徴の保持）

POST

/doubao/drawing/character

豆包（Doubao）による画像生成モデル
汎用2.0-キャラクター特徴の保持（旧名称：汎用2.0S-主体保持）は、自社開発の主体保持機能を統合しています。この機能には、主体の外観保持と顔の特徴保持が含まれます。主体の外観情報には、人間、動物、物体など、さまざまな主体が含まれます。外観と顔の特徴は、画像生成プロセスにおいて入力されたテキストと共に作用し、参照画像内の主体と一致し、かつテキスト記述に合致した画像を生成します。
紹介：https://www.volcengine.com/docs/6791/1361423

価格：0.05 PTC/回

Request

Header Params

Body Params application/json

Example

{
    "image_urls": ["https://xxx"],
    "prompt": "千军万马",
    "desc_pushback": true,
    "seed": -1,
    "scale": 3.5,
    "ddim_steps": 9,
    "width": 512,
    "height": 512,
    "cfg_rescale": 0.7,
    "ref_ip_weight": 0.7,
    "ref_id_weight": 0.36,
    "use_sr": true,
    "return_url": true,
    "logo_info": {
        "add_logo": false,
        "position": 0,
        "language": 0,
        "opacity": 0.3,
        "logo_text_content": "这里是明水印内容"
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.302.ai/doubao/drawing/character' \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data-raw '{
    "image_urls": ["https://xxx"],
    "prompt": "千军万马",
    "desc_pushback": true,
    "seed": -1,
    "scale": 3.5,
    "ddim_steps": 9,
    "width": 512,
    "height": 512,
    "cfg_rescale": 0.7,
    "ref_ip_weight": 0.7,
    "ref_id_weight": 0.36,
    "use_sr": true,
    "return_url": true,
    "logo_info": {
        "add_logo": false,
        "position": 0,
        "language": 0,
        "opacity": 0.3,
        "logo_text_content": "这里是明水印内容"
    }
}'

Responses

🟢200OK

application/json

Body

Example

{
    "code": 10000,
    "data": {
        "algorithm_base_resp": {
            "status_code": 0,
            "status_message": "Success"
        },
        "binary_data_base64": [],
        "image_urls": [
            "https://file.302.ai/gpt/imgs/20260115/05fbb9658f7550ad2549c7b5d714afc5.jpg"
        ],
        "llm_result": "",
        "pe_result": "",
        "predict_tags_result": "",
        "rephraser_result": "",
        "request_id": "e463c5433c5c0089d25e4a680e18819867550ff98f93eef17fb3d8d41f75712c",
        "vlm_result": ""
    },
    "message": "Success",
    "request_id": "202601151345177F35B5791227A1072306",
    "status": 10000,
    "time_elapsed": "8.073566173s"
}

Modified at 2026-01-15 05:46:39

SeedEdit（画像コマンド編集）

Seed3D（画像から3Dモデル生成）