Character（Character Feature Preservation）

POST

/doubao/drawing/character

Image generation model from SeedEdit
The General 2.0 - Character Feature Preservation model (formerly known as General 2.0S - Subject Preservation) integrates proprietary subject preservation technology, which includes both subject appearance preservation and facial feature preservation.The subject appearance information covers a wide range of subjects, including humans, animals, and objects. During the image generation process, both subject appearance and facial features work together with the input text to produce images that not only align with the appearance of the subject in the reference image but also match the textual description.

Introduction：https://www.volcengine.com/docs/6791/1361423

Price：0.05 PTC/call

Request

Authorization

Header Params

Authorization

string

required

Example:

Bearer {{YOUR_API_KEY}}

Body Params application/json

prompt

string

required

Prompts for generating images， input in both Chinese and English
You can input prompts in either Chinese or English to generate images. To improve the accuracy of the text written in the image, enclose the desired text in quotation marks. For example:
"A Christmas poster with the text 'Merry Christmas' written on it."

image_urls

string

required

Image File URL.This algorithm requires a input image

seed

integer

optional

Random seed，Used as the basis to determine the initial state of diffusion. The default value is -1 (random). If the random seed is set to the same positive integer and all other parameters remain identical, the generated images are highly likely to be consistent.
Default value: -1

scale

number

optional

Influence of Text Description
Default value: 3.5
Value range: [1, 10]

return_url

boolean

optional

Specifies whether the output should include an image link (the link will be valid for 24 hours)

logo_info

object

optional

Watermark information

add_logo

boolean

optional

position

integer

optional

The position of the watermark can be set as follows:

0: Bottom right (default)

1: Bottom left

2: Top left

3: Top right

language

integer

optional

The language of the watermark can be set as follows:

0: Chinese (AI生成) (default)

1: English (Generated by AI)

opacity

number

optional

The opacity of the watermark can be set within the range of 0 to 1, where 1 represents fully opaque. The default value is 0.3

logo_text_content

string

optional

Custom content for visible watermark

ddim_steps

integer

optional

Steps for Image Generation
Default Value：9
Value Range：[1, 200]

width

integer

optional

Width of Generated Image (Before Upscaling)
Default Value：512
Value Range：[256, 768]

height

integer

optional

Height of Generated Image (Before Upscaling)
Default Value：512
Value Range：[256, 768]

cfg_rescale

number

optional

Default Value：0.7

ref_ip_weight

number

optional

Weight of Reference Image's Subject Appearance
The higher the weight, the greater the similarity between the generated result and the subject in the reference image.
Default Value：0.7
Value Range：[0, 1]

ref_id_weight

number

optional

Weight of facial features from reference image，the higher the weight, the greater the similarity between the generated result and the facial features in the reference image.
Default Value: 0.36
Value Range: [0, 1]
Recommended Range: [0.2, 0.4]

use_sr

boolean

optional

true：Text-to-Image + AIGC Upscaling
false：Text-to-Image
Default Value：true

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 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 sk-jls4AaVBGoe1GwZD64qZA1qyKTN1MPHa4NmvH1cT68z7K1Zz' \
--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

completed_at

string

required

created_at

string

required

error

string

required

string

required

model

string

required

output

string

required

started_at

string

required

status

string

required

Example

{
  "completed_at": "",
  "created_at": "",
  "error": "",
  "id": "",
  "model": "",
  "output": "",
  "started_at": "",
  "status": ""
}

Modified at 2025-01-14 09:36:56

SeedEdit（Image Command Editing）

Virtual-Try-On