Portrait (Portrait Photography)

POST

/doubao/drawing/portrait

Image-to-Image 3.0 - Portrait Photography
By referencing the facial features of a single real person in the input image and guiding with a text prompt, you can generate a variety of real-person portraits. This can be widely applied in interactive entertainment, portrait effects, and e-commerce marketing scenarios. Preset style keywords can be used as templates, or you can debug new template effects based on examples.

Reference: https://www.volcengine.com/docs/85128/1602212#wGHRz2FN

Price: 0.05 PTC/image

Request

Query Params

response_format

string

optional

Default data is the original data; by providing a URL, you can obtain data from the URL.

Example:

url

Header Params

Authorization

string

optional

Example:

Bearer {{YOUR_API_KEY}}

Body Params application/json

image_input

string

required

Example: "https://图片1.png"

prompt

string

optional

Raw image prompt

width

integer

optional

Width of the generated image
Default value: 1328
Value range: [512, 2048]

height

integer

optional

Height for generated image
Default value: 1328
Value range: [512, 2048]

gpen

number

optional

High-definition processing effect. The higher the value, the clearer the face. It is recommended to use the default value.
Default value: 0.4
Value range: [0, 0.1, 0.2, 0.3, 0.4, 0.5, 0.6, 0.7, 0.8, 0.9, 1]

skin

number

optional

Facial beautification effect. The higher the value, the more noticeable the beautification effect. It is recommended to use the default value.
Default value: 0.3
Value range: [0, 0.1, 0.2, 0.3, 0.4, 0.5, 0.6, 0.7, 0.8, 0.9, 1]

skin_unifi

number

optional

Skin smoothing effect. The higher the value, the more noticeable the even skin tone and blemish removal effect. It is recommended to use the default value.
Default value: 0
Value range: [0, 0.1, 0.2, 0.3, 0.4, 0.5, 0.6, 0.7, 0.8, 0.9, 1]

gen_mode

string

optional

Reference modes and value descriptions:
"creative": Prompt mode (automatically switches to this mode when there is a prompt) (only references the character's gender features)
"reference": Full reference mode (automatically switches to this mode when there is no prompt) References more dimensions of the character (gender, clothing, hairstyle, etc.) and background
"reference_char": Character reference mode, references more dimensions of the character (gender, clothing, hairstyle, etc.), does not reference the background
Manual input takes priority over automatic

seed

string

optional

Random seed, used as the basis for determining the initial state of diffusion. Default is -1 (random). If the random seed is the same positive integer and all other parameters are identical, the generated content will most likely be consistent.
Default value: -1

Example

{
    "image_input": "https://file.302.ai/gpt/imgs/fbe0b42817fb1301cdaca5301a2b1d38.jpg",
    "prompt": "长出满脸的胡子",
    "width": 2048,
    "height": 2048,
    "gpen": 1,
    "skin": 1,
    "skin_unifi": 1,
    "gen_mode": "creative",
    "seed": "-1"
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.302.ai/doubao/drawing/portrait?response_format=url' \
--header 'Authorization: Bearer sk-jls4AaVBGoe1GwZD64qZA1qyKTN1MPHa4NmvH1cT68z7K1Zz' \
--header 'Content-Type: application/json' \
--data-raw '{
    "image_input": "https://file.302.ai/gpt/imgs/fbe0b42817fb1301cdaca5301a2b1d38.jpg",
    "prompt": "长出满脸的胡子",
    "width": 2048,
    "height": 2048,
    "gpen": 1,
    "skin": 1,
    "skin_unifi": 1,
    "gen_mode": "creative",
    "seed": "-1"
}'

Responses

🟢200成功

application/json

Body

code

integer

required

data

object

required

task_id

string

required

message

string

required

request_id

string

required

status

integer

required

time_elapsed

string

required

Example

{
    "code": 10000,
    "data": {
        "task_id": "14389862081686367205"
    },
    "message": "Success",
    "request_id": "202507041142296A67D449FDFFE1221D21",
    "status": 10000,
    "time_elapsed": "939.89322ms"
}

Modified at 2025-07-07 05:39:37

SeedEdit_v3.0 (Result Acquisition)

Portrait (Result Acquisition)