Generate Additional Looks for Photo Avatar Group

POSThttps://api.konpro.ai/v1/photo_avatar/look/generate

Create 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

TIMESTATUSUSER 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

FieldTypeDescription
group_idstringIdentifier of the trained photo avatar group to generate new looks for
promptstringText prompt describing the desired new looks and variations
orientationstringImage orientation of generated looks. Allowed values: square, horizontal, vertical
posestringAvatar pose style. Options: half_body, close_up, full_body
stylestringArtistic 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