Avatar Generation (form-data 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 multipart/form-data

image

file

required

style

string

optional

Preset avatar style ID. For the detailed list, please refer to the API documentation.

Example:

person_type

enum<string>

required

Character type

Allowed values:

femalemalekid

custom_prompt

string

optional

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

num

integer

optional

Number of avatars to generate. Values outside the supported range will be treated as 1

>= 1<= 4

Example:

width

integer

optional

Avatar width. Values outside the supported range will be treated as 1024

>= 256<= 1036

Example:

1024

height

integer

optional

Avatar height. Values outside the supported range will be treated as 1024

>= 256<= 1036

Example:

768

model

string

optional

Language model used to optimize the avatar description prompt

Default:

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' \
--form 'image=@""' \
--form 'style="1"' \
--form 'person_type=""' \
--form 'custom_prompt=""' \
--form 'num="1"' \
--form 'width="1024"' \
--form 'height="768"' \
--form 'model=""'

Responses

🟢200成功

application/json

Body

headshot_url_list

array[string]

头像链接列表

required

Example

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

Modified at 2025-05-15 02:08:10

Generate Avatar (JSON Parameter Example)

Generate Knowledge Card