Generate Avatar (JSON Parameter Example)

Developing

POST

/302/headshot/generate

Price：Optimize the interface cost of tokens+avatars generated by prompts(/302/submit/flux-selfie)

Request Parameters
Supports two types Content-Type：

application/json
multipart/form-data

Note： The priority of user-defined prompts is higher than the preset styles. If the custom_prompt parameter is not empty, the style parameter will be ignored

Preset Style List (Please enter the corresponding id when passing parameters to the API)：

id	Styles
1	Comic
2	Line Art
3	Impressionism
4	Clay
5	Watercolor
6	Cyberpunk
7	Elf
8	Clown
9	Robot
10	Vampire
11	Zombie
12	Low Poly
13	Retro Portrait
14	Ancient Style
15	Cartoon Illustration
16	Pencil Sketch
17	Steampunk

Request

Header Params

Authorization

string

required

Example:

Bearer {{YOUR_API_KEY}}

Body Params application/json

image

string

图片

required

Supports image links that are publicly accessible or base64 images starting with data:image

style

integer

预设风格id

optional

For the detailed list, please refer to the API documentation

person_type

enum<string>

人物类型

required

Allowed values:

femalemalekid

custom_prompt

string

用户自定义提示词

optional

If the user-defined prompt field has a value, the style parameter will be ignored.

num

integer

生成的头像数量

optional

Values outside the supported range will be treated as 1

>= 1<= 4

Default:

width

integer

头像宽度

optional

Values outside the supported range will be treated as 1024

>= 256<= 1036

Default:

1024

height

integer

头像高度

optional

Values outside the supported range will be treated as 1024

>= 256<= 1036

Default:

768

model

string

优化头像描述词使用的语言模型

optional

Default:

gpt-4.1

Example

{
  "image": "string",
  "style": 0,
  "person_type": "female",
  "custom_prompt": "string",
  "num": 1,
  "width": 1024,
  "height": 768,
  "model": "gpt-4.1"
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.302.ai/302/headshot/generate' \
--header 'Authorization: Bearer sk-jls4AaVBGoe1GwZD64qZA1qyKTN1MPHa4NmvH1cT68z7K1Zz' \
--header 'Content-Type: application/json' \
--data-raw '{
    "image": "string",
    "style": 0,
    "person_type": "female",
    "custom_prompt": "string",
    "num": 1,
    "width": 1024,
    "height": 768,
    "model": "gpt-4.1"
}'

Responses

🟢200成功

application/json

Body

headshot_url_list

array[string]

头像链接列表

required

Example

{
  "headshot_url_list": [
    "https://file.302.ai/gpt/imgs/a9fc94141b20b92b39679afda38ef28f.webp"
  ]
}

Query the List of Hosted Projects under an API Key

Avatar Generation (form-data parameter example)