Generate Additional Looks for Photo Avatar Group
POST
https://api.konpro.ai/v1/photo_avatar/look/generateCreate new avatar looks for a previously trained photo avatar group by providing descriptive prompts and appearance preferences. The photo avatar group must be trained before generating new looks.
Request History
Log in to see full request history
| TIME | STATUS | USER AGENT |
|---|---|---|
| Make a request to see history. | ||
0 Requests This Month
cURL Request
shell
curl --request POST \
--url https://api.konpro.ai/v1/photo_avatar/look/generate \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--header 'x-api-key: <your-api-key>' \
--data '{
"group_id": "avatarGroup123",
"prompt": "Create vibrant summer looks with bright colors and floral patterns",
"orientation": "square",
"pose": "half_body",
"style": "Realistic"
}'Request Body Parameters
| Field | Type | Description |
|---|---|---|
| group_id | string | Identifier of the trained photo avatar group to generate new looks for |
| prompt | string | Text prompt describing the desired new looks and variations |
| orientation | string | Image orientation of generated looks. Allowed values: square, horizontal, vertical |
| pose | string | Avatar pose style. Options: half_body, close_up, full_body |
| style | string | Artistic style to apply. Options: Realistic, Pixar, Cinematic, Vintage, Noir, Cyberpunk, Unspecified |
Response
Response Structure
Returns the status of the generation request and job ID. Includes error messages if generation fails.
Sample Successful Response
json
{
"generation_job_id": "gen_789012",
"group_id": "avatarGroup123",
"status": "processing",
"prompt": "Create vibrant summer looks with bright colors and floral patterns",
"orientation": "square",
"pose": "half_body",
"style": "Realistic",
"message": "Look generation started successfully",
"estimated_completion": "2024-01-15T11:30:00Z"
}Notes
- Requires API authentication.
- The group_id must reference a trained photo avatar group.
- All parameters are required for look generation.
- Generation is asynchronous and may take several minutes to complete.
- Use the generation_job_id to check generation status.
- Refer to Error Responses for error information.
Example Usage
Shell
curl --request POST \
--url https://api.konpro.ai/v1/photo_avatar/look/generate \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--header 'x-api-key: <your-api-key>' \
--data '{
"group_id": "avatarGroup123",
"prompt": "Create vibrant summer looks with bright colors and floral patterns",
"orientation": "square",
"pose": "half_body",
"style": "Realistic"
}'LANGUAGE
CREDENTIALS
HEADER
RESPONSE
Examples
Choose an example:
application/json
200 - Success
400 - Bad Request
LANGUAGE
CREDENTIALS
HEADER
RESPONSE
Examples
Choose an example:
application/json
200 - Success
400 - Bad Request