Create Photo Avatar Group

POSThttps://api.konpro.ai/v1/photo_avatar/avatar_group/create

Organize and manage your AI-generated photo avatars efficiently by creating avatar groups. This allows for better customization and categorization of related avatars.

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/avatar_group/create \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--header 'x-api-key: <your-api-key>' \
--data '{
  "name": "Team Photos",
  "image_key": "imgkey12345",
  "generation_id": "genid67890"
}'

Request Body Parameters

Field	Type	Description
name	string	Name of the avatar group to be created
image_key	string	Key or identifier referencing the group's cover image
generation_id	string	Identifier of the photo/avatar generation linked to the group

Response

Response Structure

Confirms group creation with a unique group ID. Provides error messages if creation fails.

Sample Successful Response

json

{
  "group_id": "group_123456",
  "name": "Team Photos",
  "image_key": "imgkey12345",
  "generation_id": "genid67890",
  "status": "created",
  "created_at": "2024-01-15T10:30:00Z"
}

Notes

Requires API authentication.
All fields are required for group creation.
The generation_id must reference a valid photo avatar generation.
Groups help organize and categorize related avatars for better management.
Refer to Error Responses for error information.

Example Usage

Shell

curl --request POST \
--url https://api.konpro.ai/v1/photo_avatar/avatar_group/create \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--header 'x-api-key: <your-api-key>' \
--data '{
  "name": "Team Photos",
  "image_key": "imgkey12345",
  "generation_id": "genid67890"
}'

LANGUAGE

CREDENTIALS

Header

HEADER

RESPONSE

Examples

Choose an example:

application/json

200 - Success

400 - Bad Request

Check Photo Avatar Generation Status Create Train Photo Avatar Groups