Request
デフォルトではdataの元データを使用し、urlを指定するとurlのデータを取得できます。
Example:Bearer {{YOUR_API_KEY}}
Body Params application/json
画像の幅
デフォルト値:1328
値の範囲:[512, 2048]
画像の高さ
デフォルト値:1328
値の範囲:[512, 2048]
高精細処理効果。値が高いほど顔の鮮明度が向上します。デフォルト値の使用を推奨します。
デフォルト値:0.4
設定可能範囲:[0, 0.1, 0.2, 0.3, 0.4, 0.5, 0.6, 0.7, 0.8, 0.9, 1]
顔補正効果。値が高いほど美顔効果がより顕著になります。デフォルト値の使用を推奨します。
デフォルト値:0.3
値の範囲:[0, 0.1, 0.2, 0.3, 0.4, 0.5, 0.6, 0.7, 0.8, 0.9, 1]
肌の均一化効果。値が高いほど肌色を均一にし、欠点を除去する効果がより顕著になります。デフォルト値の使用を推奨します。
デフォルト値:0
取値範囲:[0, 0.1, 0.2, 0.3, 0.4, 0.5, 0.6, 0.7, 0.8, 0.9, 1]
参考モード、値の説明:
"creative":プロンプトモード(プロンプトがある場合は自動的にこのモードに切り替わります)(人物の性別特徴のみを参照)
"reference":全参照モード(プロンプトがない場合は自動的にこのモードに切り替わります)人物のより多くの特徴(性別、服装、髪型など)および背景を参照
"reference_char":人物参照モード、人物のより多くの特徴(性別、服装、髪型など)を参照し、背景は参照しません
手動入力は自動より優先されます
ランダムシード。拡散の初期状態を決定するための基礎となります。デフォルトは-1(ランダム)です。ランダムシードが同じ正の整数で、他のパラメータもすべて同じ場合、生成される内容は非常に高い確率で同じ結果になります。
デフォルト値:-1
{
"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
curl --location --request POST 'https://api.302.ai/doubao/drawing/portrait?response_format=url' \
--header 'Authorization: Bearer sk-mfYQzy0XTFfz4P16vRE4gFrKK1Nly4TozsMqbbb9PSiJUvFO' \
--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
application/json {
"code": 10000,
"data": {
"task_id": "14389862081686367205"
},
"message": "Success",
"request_id": "202507041142296A67D449FDFFE1221D21",
"status": 10000,
"time_elapsed": "939.89322ms"
}
Modified at 2025-07-07 05:42:41