> ## Documentation Index
> Fetch the complete documentation index at: https://docs.omnicommerce.sg/llms.txt
> Use this file to discover all available pages before exploring further.

# Generate Ghost Mannequin Image

> Remove the visible mannequin from a product photo and return the generated image URL. The source image must be an HTTP(S) URL; data URIs are rejected. Authenticate with an OmniCommerce API key that has the `catalog:enrich` scope.



## OpenAPI

````yaml /openapi.json post /api/v1/images/ghost-mannequin
openapi: 3.1.0
info:
  title: OmniCommerce API
  version: 1.0.0
  license:
    name: Proprietary
    url: https://omnicommerce.sg/terms
  description: >-
    OmniCommerce API surface for agents and developer integrations. Includes
    public endpoints (merchant discovery, product search, compare, catalog, ACO
    retrieval) and authenticated endpoints (product management via API key
    Bearer tokens).
servers:
  - url: https://omnicommerce.sg
    description: Production
  - url: http://localhost:3000
    description: Local development
security: []
tags:
  - name: agentic-checkout
    description: Merchant-fulfilled agentic checkout
    x-group: Agentic Checkout
  - name: commerce
    description: Root commerce discovery
    x-group: Commerce
  - name: developer-platform
    description: Authenticated developer platform APIs
    x-group: Developer Platform
  - name: looks
    description: AI-styled product looks
    x-group: Looks
  - name: oauth
    description: OAuth token endpoints
    x-group: OAuth
  - name: orders
    description: Workspace and agentic orders
    x-group: Orders
  - name: organizations
    description: Organization management
    x-group: Organizations
  - name: price-books
    description: Marketplace list-price markup rules
    x-group: Price Books
  - name: products
    description: Product CRUD, bulk import, and publish
    x-group: Products
  - name: promotions
    description: Central promotions and marketplace sync
    x-group: Promotions
  - name: public-agent
    description: Public agent discovery and catalog APIs
    x-group: Public Agent
  - name: settlements
    description: settlements
    x-group: Settlements
  - name: ucp
    description: Universal Commerce Protocol
    x-group: UCP
paths:
  /api/v1/images/ghost-mannequin:
    post:
      tags:
        - developer-platform
      summary: Generate Ghost Mannequin Image
      description: >-
        Remove the visible mannequin from a product photo and return the
        generated image URL. The source image must be an HTTP(S) URL; data URIs
        are rejected. Authenticate with an OmniCommerce API key that has the
        `catalog:enrich` scope.
      operationId: post_v1_images_ghost_mannequin
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
              required:
                - imageUrl
              properties:
                imageUrl:
                  type: string
                  maxLength: 4096
                  description: >-
                    Publicly fetchable HTTP(S) image URL. Supported source
                    formats are JPEG, PNG, GIF, or WebP. Data URIs are not
                    accepted.
                productTitle:
                  type: string
                  maxLength: 160
                  description: >-
                    Optional product title used only as image-edit context so
                    the model preserves the correct garment or product type.
                categoryName:
                  type: string
                  maxLength: 160
                  description: Optional category label used only as image-edit context.
                categoryId:
                  type: string
                  maxLength: 80
                  description: >-
                    Optional category ID used as fallback image-edit context
                    when a category label is not available.
            example:
              imageUrl: https://cdn.example.com/products/dress-front.jpg
              productTitle: Linen Wrap Dress
              categoryName: Women Clothes > Dresses
      responses:
        '200':
          description: Ghost mannequin image generated.
          content:
            application/json:
              schema:
                type: object
                additionalProperties: false
                required:
                  - ok
                  - apiVersion
                  - operationId
                  - status
                  - warnings
                  - recommendations
                  - image
                properties:
                  ok:
                    type: boolean
                  apiVersion:
                    type: string
                    default: developer_v1
                  operationId:
                    type: string
                  status:
                    type: string
                    enum:
                      - completed
                  warnings:
                    type: array
                    items:
                      type: string
                  recommendations:
                    type: array
                    items:
                      type: string
                  image:
                    type: string
                    description: >-
                      Remote HTTP(S) URL for the generated ghost mannequin image
                      stored by OmniCommerce.
              example:
                ok: true
                apiVersion: developer_v1
                operationId: 8f7e8f8f-2b9e-46e6-a2c0-50d0f4612b2d
                status: completed
                warnings: []
                recommendations: []
                image: https://cdn.example.com/generated/ghost-mannequin.webp
        '400':
          description: Bad Request - invalid JSON or imageUrl
        '401':
          description: Unauthorized
        '403':
          description: Forbidden - missing catalog:enrich scope
        '502':
          description: >-
            Image generation failed or the generated image could not be
            retrieved.
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: >-
        Bearer API key for server-to-server access. Session auth is also
        supported in first-party UI flows.

````