Character (Generate Character)

POST

/higgsfield/character

Character generation from higgsfield.ai supports inputting up to 70 face images. The AI will analyze your images and, within a few minutes, understand your unique appearance to generate a personalized image model.

After successful generation, you can pass custom_reference_id when using Image Generation to create unlimited styles of selfies.

After submitting the task, obtain the "id" and go to the Fetch (Get Task Result) interface to check the result.

Price: 3 PTC / time

Request

Header Params

Authorization

string

optional

Example:

Bearer {{YOUR_API_KEY}}

Content-Type

string

optional

Example:

application/json

Body Params application/json

name

string

required

input_images

array[string]

required

Supports up to 70 images

Example

{
    "name": "abc123",
    "input_images": [
        "https://file.302ai.cn/gpt/photoshow/20240806/feed8cfd4dba495bb444a3de183fd385.jpeg",
        "https://file.302ai.cn/gpt/photoshow/20240806/feed8cfd4dba495bb444a3de183fd385.jpeg",
        "https://file.302ai.cn/gpt/photoshow/20240806/feed8cfd4dba495bb444a3de183fd385.jpeg"
    ]
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.302.ai/higgsfield/character' \
--header 'Authorization: Bearer sk-jls4AaVBGoe1GwZD64qZA1qyKTN1MPHa4NmvH1cT68z7K1Zz' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "abc123",
    "input_images": [
        "https://file.302ai.cn/gpt/photoshow/20240806/feed8cfd4dba495bb444a3de183fd385.jpeg",
        "https://file.302ai.cn/gpt/photoshow/20240806/feed8cfd4dba495bb444a3de183fd385.jpeg",
        "https://file.302ai.cn/gpt/photoshow/20240806/feed8cfd4dba495bb444a3de183fd385.jpeg"
    ]
}'

Responses

🟢200成功

application/json

Body

code

integer

required

data

object

required

task_id

string

required

Example

{
    "board_ids": [],
    "id": "higgsfield_472f8f0319ac",
    "result": null,
    "results": null,
    "status": "queued"
}

Modified at 2025-07-18 07:48:48

Soul (Text to Image)

Fetch (Retrieve task results)