---
title: "Create product avatar image"
method: POST
path: "/v2/product_avatar/generation"
tags: ["Avatar"]
---

# Create product avatar image

`POST /v2/product_avatar/generation`

## Request

- Base URL: `https://api.jogg.ai`
- URL: `https://api.jogg.ai/v2/product_avatar/generation`
- Auth: API key in header `x-api-key`

Generate product avatar images using AI with specified parameters

## Request body

- object
  - `product_image_url` string, uri, required: Product image URL for avatar generation
  - `avatar_source` object, required: Avatar source configuration
    - `type` 'id' | 'image' | 'description', required: Avatar source type
    - `value` string: Avatar value (image URL for "image" type, description for "description" type)
    - `avatar_id` integer: Avatar ID (required when type is "id")
    - `avatar_type` 'public' | 'photo' | 'custom': Avatar type (required when type is "id")
  - `prompt` string: Image generation prompt
  - `quality` 'medium' | 'high' | 'low', required: Image generation quality
  - `aspect_ratio` '3:2' | '2:3' | '1:1', required: Aspect ratio(3:2, 2:3, 1:1)
  - `num_images` integer, required: Number of images to generate
  - `webhook_url` string, uri: Webhook URL for status notifications

## Response `200`

Success

- object
  - `code` integer, required: Business status code: * 0 - Success * 10104 - Record not found * 10105 - Invalid API key * 18020 - Insufficient credit * 18025 - No permission to call APIs * 40000 - Parameter error * 50000 - System error
  - `msg` string, required: Response message
  - `data` object
    - `batch_id` string: Batch ID to check generation status
    - `total_submitted` integer: Total number of images submitted for generation
    - `generations` object[]: List of generation tasks
      - `generation_id` string: Generation task ID
      - `status` 'pending' | 'processing' | 'completed' | 'failed': Generation status
      - `created_at` integer: Creation timestamp

## Changes

- **2026-11-03** `22021dd81934`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/jogg/apis/joggai-openapi-v2/changes/v2/product_avatar/generation/post.md)

---

[API](https://skmtc.dev/jogg/apis/joggai-openapi-v2.md) - [All operations](https://skmtc.dev/jogg/apis/joggai-openapi-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/jogg/apis/joggai-openapi-v2/revisions/22021dd81934?raw)