1600 lines
75 KiB
Markdown
1600 lines
75 KiB
Markdown
# FastAPI Backend — Production API Reference
|
||||
|
|
|
|||
|
|
Welcome to the production API reference documentation for the FastAPI backend engine. This document specifies all public and internal service group endpoints, exact HTTP methods, parameter tables, accepted file aliases, verified model effect encodings from disk, and response schemas.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## Service Overview & Base URLs
|
|||
|
|
|
|||
|
|
| Service Group | Production Base URL | Port / Gateway | Description |
|
|||
|
|
| :--- | :--- | :--- | :--- |
|
|||
|
|
| **FLUX Fill** | `https://apigp0006.creinnovations.in/apis/flxf` | Port 18001 | Inpainting & localized editing via FLUX.1 Fill |
|
|||
|
|
| **FLUX Kontext** | `https://apigp0006.creinnovations.in/apis/flxk` | Port 18002 | Full context image-to-image transformations via FLUX.1 Kontext |
|
|||
|
|
| **ML Models** | `https://apigp0006.creinnovations.in/apis/mlm` | Port 5925 | Classical & deep learning computer vision, segmentation, and SD1.5 routes |
|
|||
|
|
| **ComfyUI** | `https://apigp0905.creinnovations.in/apis/cmf` | Ports 19527–19529 | ComfyUI microservices (dress changing, YOLO + SAM multi-segmentation) |
|
|||
|
|
| **SDXL** | `https://apigp0905.creinnovations.in/apis/lxds` | Port 8005 | High-resolution Stable Diffusion XL generation & inpainting pipelines |
|
|||
|
|
| **Other Services** | `https://apigp0006.creinnovations.in/apis/mlm` | Port 5925 | Feedback submission, telemetry reporting, and traffic guard |
|
|||
|
|
| **Health Checks** | `http://localhost:5925/health` / `https://apigp0006.creinnovations.in/apis/flxk/` | Ports 5925 / 18002 | Microservice liveliness and health endpoints |
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 1. FLUX Fill Endpoints
|
|||
|
|
Base URL: `https://apigp0006.creinnovations.in/apis/flxf`
|
|||
|
|
|
|||
|
|
### 1.1 Hair Color Changer
|
|||
|
|
Replaces hair color in an input portrait using FLUX.1 Fill inpainting with precomputed text/image feature embeddings.
|
|||
|
|
|
|||
|
|
- **URL:** `https://apigp0006.creinnovations.in/apis/flxf/flux_fill/hair_color_changer/image/`
|
|||
|
|
- **Method:** `POST`
|
|||
|
|
- **Content-Type:** `multipart/form-data`
|
|||
|
|
|
|||
|
|
| Field | Type | Required | Default | Description |
|
|||
|
|
| :--- | :--- | :--- | :--- | :--- |
|
|||
|
|
| `image0` | UploadFile | **Required** | None | Input portrait image. Accepted field aliases: `image0`, `image`. |
|
|||
|
|
| `colorId` | string | **Required** | None | Effect identifier. Accepts 36 verified effects: `C1`–`C14`, `G1`–`G12`, `HL2`–`HL11`. |
|
|||
|
|
| `secretKey` | string | **Required** | `"abcdef"` | Authentication secret key. Must match `"abcdef"`. |
|
|||
|
|
| `mask_image` | UploadFile | Optional | None | Optional custom binary mask for hair. If omitted, automatically generated via internal hair segmentation. |
|
|||
|
|
|
|||
|
|
> [!NOTE]
|
|||
|
|
> Accepts `image0` or `image` for the portrait file. Verified on disk: 36 unique color presets (72 `.pt` files: 36 `_pe.pt` and 36 `_ppe.pt`).
|
|||
|
|
|
|||
|
|
- **Response:**
|
|||
|
|
- `200 OK`: Binary image stream (`image/png` or `image/jpeg`).
|
|||
|
|
- `400 Bad Request`: `{"detail": "Missing colorId"}` or `{"detail": "Missing image file (image0)"}`.
|
|||
|
|
- `401 Unauthorized`: `{"detail": "Unauthorized: Invalid secretKey"}`.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 1.2 Eye Changer
|
|||
|
|
Modifies eye color or removes eyewear using localized FLUX.1 Fill inpainting.
|
|||
|
|
|
|||
|
|
- **URL:** `https://apigp0006.creinnovations.in/apis/flxf/flux_fill/eye_changer/image/`
|
|||
|
|
- **Method:** `POST`
|
|||
|
|
- **Content-Type:** `multipart/form-data`
|
|||
|
|
|
|||
|
|
| Field | Type | Required | Default | Description |
|
|||
|
|
| :--- | :--- | :--- | :--- | :--- |
|
|||
|
|
| `image0` | UploadFile | **Required** | None | Input face portrait image. Accepted field aliases: `image0`, `image`. |
|
|||
|
|
| `effectId` | string | **Required** | None | Eye effect identifier. Accepts 25 verified effects: `E1`, `E2`, `E5`, `E6`, `E9`, `GM1`–`GM10`, `GW1`–`GW10`. |
|
|||
|
|
| `secretKey` | string | **Required** | `"abcdef"` | Authentication secret key. Must match `"abcdef"`. |
|
|||
|
|
| `eye_mask` | UploadFile | Optional | None | Optional eye mask. Required when using glasses removal effects (`E5`, `E6`, `E9`). Auto-generated internally for all other IDs. |
|
|||
|
|
|
|||
|
|
> [!NOTE]
|
|||
|
|
> Accepts `image0` or `image` for the input image. Verified on disk: 25 unique effect presets (50 `.pt` files: 25 `_pe.pt` and 25 `_ppe.pt`).
|
|||
|
|
|
|||
|
|
- **Response:**
|
|||
|
|
- `200 OK`: Binary image stream (`image/png` or `image/jpeg`).
|
|||
|
|
- `400 Bad Request`: `{"detail": "Missing effectId"}` or `{"detail": "Missing image file (image0)"}`.
|
|||
|
|
- `401 Unauthorized`: `{"detail": "Unauthorized: Invalid secretKey"}`.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 1.3 Couple Dress Changer
|
|||
|
|
Performs coordinated outfit replacement on couple portraits using dual-character FLUX.1 Fill encodings.
|
|||
|
|
|
|||
|
|
- **URL:** `https://apigp0006.creinnovations.in/apis/flxf/flux_fill/couple_dress_changer/image/`
|
|||
|
|
- **Method:** `POST`
|
|||
|
|
- **Content-Type:** `multipart/form-data`
|
|||
|
|
|
|||
|
|
| Field | Type | Required | Default | Description |
|
|||
|
|
| :--- | :--- | :--- | :--- | :--- |
|
|||
|
|
| `image0` | UploadFile | **Required** | None | Input couple photo. Accepted field aliases: `image0`, `image`. |
|
|||
|
|
| `effectId` | string | **Required** | None | Couple outfit preset ID. Accepts 620 verified presets (595 standard couple encodings across 17 categories + 25 couple wedding styles). |
|
|||
|
|
| `secretKey` | string | **Required** | `"abcdef"` | Authentication secret key. Must match `"abcdef"`. |
|
|||
|
|
| `mask_image` | UploadFile | Optional | None | Optional custom clothing mask. If omitted, automatically segmented via multi-person clothing parser. |
|
|||
|
|
|
|||
|
|
> [!NOTE]
|
|||
|
|
> Accepts `image0` or `image` for the couple portrait. Verified on disk: 620 unique couple outfit presets (1,240 `.pt` files: 620 `_pe.pt` and 620 `_ppe.pt`).
|
|||
|
|
|
|||
|
|
- **Response:**
|
|||
|
|
- `200 OK`: Binary image stream (`image/png`).
|
|||
|
|
- `400 Bad Request`: `{"detail": "Missing effectId"}` or `{"detail": "Missing image file (image0)"}`.
|
|||
|
|
- `401 Unauthorized`: `{"detail": "Unauthorized: Invalid secretKey"}`.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 1.4 Dress Changer
|
|||
|
|
Inpaints new garments and styles onto individual subjects using FLUX.1 Fill.
|
|||
|
|
|
|||
|
|
- **URL:** `https://apigp0006.creinnovations.in/apis/flxf/flux_fill/dress_changer/image/`
|
|||
|
|
- **Method:** `POST`
|
|||
|
|
- **Content-Type:** `multipart/form-data`
|
|||
|
|
|
|||
|
|
| Field | Type | Required | Default | Description |
|
|||
|
|
| :--- | :--- | :--- | :--- | :--- |
|
|||
|
|
| `image0` | UploadFile | **Required** | None | Input subject image. Accepted field aliases: `image0`, `image`. |
|
|||
|
|
| `effectId` | string | **Required** | None | Garment preset identifier. Accepts 1,676 verified outfit presets across 16 clothing categories. |
|
|||
|
|
| `secretKey` | string | **Required** | `"abcdef"` | Authentication secret key. Must match `"abcdef"`. |
|
|||
|
|
| `mask_image` | UploadFile | Optional | None | Optional custom garment mask. If omitted, automatically generated via internal clothing segmentation. |
|
|||
|
|
|
|||
|
|
> [!NOTE]
|
|||
|
|
> Accepts `image0` or `image` for the input image. Verified on disk: 1,676 unique outfit presets (3,352 `.pt` files: 1,676 `_pe.pt` and 1,676 `_ppe.pt`).
|
|||
|
|
|
|||
|
|
- **Response:**
|
|||
|
|
- `200 OK`: Binary image stream (`image/png`).
|
|||
|
|
- `400 Bad Request`: `{"detail": "Missing effectId"}` or `{"detail": "Missing image file (image0)"}`.
|
|||
|
|
- `401 Unauthorized`: `{"detail": "Unauthorized: Invalid secretKey"}`.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 2. FLUX Kontext Endpoints
|
|||
|
|
Base URL: `https://apigp0006.creinnovations.in/apis/flxk`
|
|||
|
|
|
|||
|
|
### 2.1 Professional Headshots
|
|||
|
|
Transforms casual portraits into corporate studio headshots with formal attire and studio lighting.
|
|||
|
|
|
|||
|
|
- **URL:** `https://apigp0006.creinnovations.in/apis/flxk/flux/headshots/image1_1/`
|
|||
|
|
- **Method:** `POST`
|
|||
|
|
- **Content-Type:** `multipart/form-data`
|
|||
|
|
|
|||
|
|
| Field | Type | Required | Default | Description |
|
|||
|
|
| :--- | :--- | :--- | :--- | :--- |
|
|||
|
|
| `image0` | UploadFile | **Required** | None | Input portrait photo. Accepted field aliases: `image0`, `image`. |
|
|||
|
|
| `effectId` | string | **Required** | None | Headshot style ID. Accepts 80 verified effects: 40 female (`female_Bg1`–`female_Bg40`), 40 male (`male_Bg1`–`male_Bg40`). Numeric IDs are automatically normalized. |
|
|||
|
|
| `secretKey` | string | **Required** | `"abcdef"` | Authentication secret key. Must match `"abcdef"`. |
|
|||
|
|
| `gender` | string | Optional | None | Gender filter (`male` or `female`). Accepted alias: `category`. Automatically prepended to `effectId` if numeric. |
|
|||
|
|
|
|||
|
|
> [!NOTE]
|
|||
|
|
> Accepts `image0` or `image` for the file upload. Accepts `gender` or `category` for gender specification. Verified on disk: 80 presets (160 `.pt` files).
|
|||
|
|
|
|||
|
|
- **Response:**
|
|||
|
|
- `200 OK`: Binary image stream (`image/png`).
|
|||
|
|
- `400 Bad Request`: `{"detail": "Missing effectId"}` or `{"detail": "Missing image file"}`.
|
|||
|
|
- `401 Unauthorized`: `{"detail": "Unauthorized: Invalid secretKey"}`.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 2.2 Head Cartoon Effect
|
|||
|
|
Transforms portraits into stylized 3D head cartoon avatars with preserved facial identity.
|
|||
|
|
|
|||
|
|
- **URL:** `https://apigp0006.creinnovations.in/apis/flxk/flux/head_cartoon_effect/image/`
|
|||
|
|
- **Method:** `POST`
|
|||
|
|
- **Content-Type:** `multipart/form-data`
|
|||
|
|
|
|||
|
|
| Field | Type | Required | Default | Description |
|
|||
|
|
| :--- | :--- | :--- | :--- | :--- |
|
|||
|
|
| `image0` | UploadFile | **Required** | None | Input face portrait. Accepted field aliases: `image0`, `image`. |
|
|||
|
|
| `effectId` | string | **Required** | None | Cartoon style preset ID. Accepts 2 verified presets: `Female_C12`, `Male_C12`. |
|
|||
|
|
| `secretKey` | string | **Required** | `"abcdef"` | Authentication secret key. Must match `"abcdef"`. |
|
|||
|
|
|
|||
|
|
> [!NOTE]
|
|||
|
|
> Accepts `image0` or `image`. Verified on disk: 2 presets (4 `.pt` files: `Female_C12_pe.pt`, `Female_C12_ppe.pt`, `Male_C12_pe.pt`, `Male_C12_ppe.pt`).
|
|||
|
|
|
|||
|
|
- **Response:**
|
|||
|
|
- `200 OK`: Binary image stream (`image/png`).
|
|||
|
|
- `400 Bad Request`: `{"detail": "Missing effectId"}` or `{"detail": "Missing image file"}`.
|
|||
|
|
- `401 Unauthorized`: `{"detail": "Unauthorized: Invalid secretKey"}`.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 2.3 Modified Head Cartoon Effects
|
|||
|
|
Applies stylized exaggerated 3D animated character styles to portraits.
|
|||
|
|
|
|||
|
|
- **URL:** `https://apigp0006.creinnovations.in/apis/flxk/flux/modified_head_cartoon_effects/image/`
|
|||
|
|
- **Method:** `POST`
|
|||
|
|
- **Content-Type:** `multipart/form-data`
|
|||
|
|
|
|||
|
|
| Field | Type | Required | Default | Description |
|
|||
|
|
| :--- | :--- | :--- | :--- | :--- |
|
|||
|
|
| `image0` | UploadFile | **Required** | None | Input face portrait. Accepted field aliases: `image0`, `image`. |
|
|||
|
|
| `effectId` | string | **Required** | None | Modified cartoon preset ID. Accepts 4 verified presets: `Female_C7`, `Female_C8`, `Male_C7`, `Male_C8`. |
|
|||
|
|
| `secretKey` | string | **Required** | `"abcdef"` | Authentication secret key. Must match `"abcdef"`. |
|
|||
|
|
|
|||
|
|
> [!NOTE]
|
|||
|
|
> Accepts `image0` or `image`. Verified on disk: 4 presets (8 `.pt` files).
|
|||
|
|
|
|||
|
|
- **Response:**
|
|||
|
|
- `200 OK`: Binary image stream (`image/png`).
|
|||
|
|
- `400 Bad Request`: `{"detail": "Missing effectId"}` or `{"detail": "Missing image file"}`.
|
|||
|
|
- `401 Unauthorized`: `{"detail": "Unauthorized: Invalid secretKey"}`.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 2.4 Comic Cover Art
|
|||
|
|
Renders the subject onto stylized comic book covers with graphic typography and pulp illustration aesthetics.
|
|||
|
|
|
|||
|
|
- **URL:** `https://apigp0006.creinnovations.in/apis/flxk/flux/comic_cover/image/`
|
|||
|
|
- **Method:** `POST`
|
|||
|
|
- **Content-Type:** `multipart/form-data`
|
|||
|
|
|
|||
|
|
| Field | Type | Required | Default | Description |
|
|||
|
|
| :--- | :--- | :--- | :--- | :--- |
|
|||
|
|
| `image0` | UploadFile | **Required** | None | Input subject photo. Accepted field aliases: `image0`, `image`. |
|
|||
|
|
| `effectId` | string | **Required** | None | Comic cover preset ID. Accepts 26 verified styles: 13 female (`female_ComicCover1`–`female_ComicCover13`), 13 male (`male_ComicCover1`–`male_ComicCover13`). |
|
|||
|
|
| `secretKey` | string | **Required** | `"abcdef"` | Authentication secret key. Must match `"abcdef"`. |
|
|||
|
|
|
|||
|
|
> [!NOTE]
|
|||
|
|
> Accepts `image0` or `image`. Verified on disk: 26 presets (52 `.pt` files).
|
|||
|
|
|
|||
|
|
- **Response:**
|
|||
|
|
- `200 OK`: Binary image stream (`image/png`).
|
|||
|
|
- `400 Bad Request`: `{"detail": "Missing effectId"}` or `{"detail": "Missing image file"}`.
|
|||
|
|
- `401 Unauthorized`: `{"detail": "Unauthorized: Invalid secretKey"}`.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 2.5 Hairstyles
|
|||
|
|
Generates contextual hairstyle transformations while preserving identity and face structure.
|
|||
|
|
|
|||
|
|
- **URL:** `https://apigp0006.creinnovations.in/apis/flxk/flux/hairstyles/image/`
|
|||
|
|
- **Method:** `POST`
|
|||
|
|
- **Content-Type:** `multipart/form-data`
|
|||
|
|
|
|||
|
|
| Field | Type | Required | Default | Description |
|
|||
|
|
| :--- | :--- | :--- | :--- | :--- |
|
|||
|
|
| `image0` | UploadFile | **Required** | None | Input face portrait. Accepted field aliases: `image0`, `image`. |
|
|||
|
|
| `effectId` | string | **Required** | None | Hairstyle preset ID. Accepts 60 verified styles: 30 female (`female_HF1`–`female_HF30`), 30 male (`male_HM1`–`male_HM30`). |
|
|||
|
|
| `secretKey` | string | **Required** | `"abcdef"` | Authentication secret key. Must match `"abcdef"`. |
|
|||
|
|
|
|||
|
|
> [!NOTE]
|
|||
|
|
> Accepts `image0` or `image`. Verified on disk: 60 presets (120 `.pt` files).
|
|||
|
|
|
|||
|
|
- **Response:**
|
|||
|
|
- `200 OK`: Binary image stream (`image/png`).
|
|||
|
|
- `400 Bad Request`: `{"detail": "Missing effectId"}` or `{"detail": "Missing image file"}`.
|
|||
|
|
- `401 Unauthorized`: `{"detail": "Unauthorized: Invalid secretKey"}`.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 2.6 Sculptures
|
|||
|
|
Renders the subject as fine art sculptures across classical materials (marble, bronze, clay, gold).
|
|||
|
|
|
|||
|
|
- **URL:** `https://apigp0006.creinnovations.in/apis/flxk/flux/sculptures/image/`
|
|||
|
|
- **Method:** `POST`
|
|||
|
|
- **Content-Type:** `multipart/form-data`
|
|||
|
|
|
|||
|
|
| Field | Type | Required | Default | Description |
|
|||
|
|
| :--- | :--- | :--- | :--- | :--- |
|
|||
|
|
| `image0` | UploadFile | **Required** | None | Input photo. Accepted field aliases: `image0`, `image`. |
|
|||
|
|
| `effectId` | string | **Required** | None | Sculpture preset ID. Accepts 26 verified presets: `E1`–`E26`. |
|
|||
|
|
| `secretKey` | string | **Required** | `"abcdef"` | Authentication secret key. Must match `"abcdef"`. |
|
|||
|
|
|
|||
|
|
> [!NOTE]
|
|||
|
|
> Accepts `image0` or `image`. Verified on disk: 26 presets (52 `.pt` files).
|
|||
|
|
|
|||
|
|
- **Response:**
|
|||
|
|
- `200 OK`: Binary image stream (`image/png`).
|
|||
|
|
- `400 Bad Request`: `{"detail": "Missing effectId"}` or `{"detail": "Missing image file"}`.
|
|||
|
|
- `401 Unauthorized`: `{"detail": "Unauthorized: Invalid secretKey"}`.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 2.7 Silhouette
|
|||
|
|
Produces artistic back-lit high-contrast silhouettes in dramatic environmental backdrops.
|
|||
|
|
|
|||
|
|
- **URL:** `https://apigp0006.creinnovations.in/apis/flxk/flux/silhouette/image/`
|
|||
|
|
- **Method:** `POST`
|
|||
|
|
- **Content-Type:** `multipart/form-data`
|
|||
|
|
|
|||
|
|
| Field | Type | Required | Default | Description |
|
|||
|
|
| :--- | :--- | :--- | :--- | :--- |
|
|||
|
|
| `image0` | UploadFile | **Required** | None | Input image. Accepted field aliases: `image0`, `image`. |
|
|||
|
|
| `effectId` | string | **Required** | None | Silhouette preset ID. Accepts 150 verified styles: 50 couple (`couple_E1`–`couple_E50`), 50 men (`men_E1`–`men_E50`), 50 women (`women_E1`–`women_E50`). |
|
|||
|
|
| `secretKey` | string | **Required** | `"abcdef"` | Authentication secret key. Must match `"abcdef"`. |
|
|||
|
|
|
|||
|
|
> [!NOTE]
|
|||
|
|
> Accepts `image0` or `image`. Verified on disk: 150 presets (300 `.pt` files).
|
|||
|
|
|
|||
|
|
- **Response:**
|
|||
|
|
- `200 OK`: Binary image stream (`image/png`).
|
|||
|
|
- `400 Bad Request`: `{"detail": "Missing effectId"}` or `{"detail": "Missing image file"}`.
|
|||
|
|
- `401 Unauthorized`: `{"detail": "Unauthorized: Invalid secretKey"}`.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 2.8 Glasses Maker
|
|||
|
|
Fits high-fashion eyeglasses and sunglasses onto portrait subjects with realistic refraction and reflections.
|
|||
|
|
|
|||
|
|
- **URL:** `https://apigp0006.creinnovations.in/apis/flxk/flux/glasses_maker/image/`
|
|||
|
|
- **Method:** `POST`
|
|||
|
|
- **Content-Type:** `multipart/form-data`
|
|||
|
|
|
|||
|
|
| Field | Type | Required | Default | Description |
|
|||
|
|
| :--- | :--- | :--- | :--- | :--- |
|
|||
|
|
| `image0` | UploadFile | **Required** | None | Input face portrait. Accepted field aliases: `image0`, `image`. |
|
|||
|
|
| `effectId` | string | **Required** | None | Eyewear preset ID. Accepts 45 verified styles: 25 men (`EM1`–`EM25`), 20 women (`EW1`–`EW20`). |
|
|||
|
|
| `secretKey` | string | **Required** | `"abcdef"` | Authentication secret key. Must match `"abcdef"`. |
|
|||
|
|
|
|||
|
|
> [!NOTE]
|
|||
|
|
> Accepts `image0` or `image`. Verified on disk: 45 presets (90 `.pt` files).
|
|||
|
|
|
|||
|
|
- **Response:**
|
|||
|
|
- `200 OK`: Binary image stream (`image/png`).
|
|||
|
|
- `400 Bad Request`: `{"detail": "Missing effectId"}` or `{"detail": "Missing image file"}`.
|
|||
|
|
- `401 Unauthorized`: `{"detail": "Unauthorized: Invalid secretKey"}`.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 2.9 Cartoon Effect
|
|||
|
|
Full context image-to-cartoon transformation preserving identity across animated, 3D Disney/Pixar, anime, and comic art styles.
|
|||
|
|
|
|||
|
|
- **URL:** `https://apigp0006.creinnovations.in/apis/flxk/flux/cartoon/image/`
|
|||
|
|
- **Method:** `POST`
|
|||
|
|
- **Content-Type:** `multipart/form-data`
|
|||
|
|
|
|||
|
|
| Field | Type | Required | Default | Description |
|
|||
|
|
| :--- | :--- | :--- | :--- | :--- |
|
|||
|
|
| `image0` | UploadFile | **Required** | None | Input photo. Accepted field aliases: `image0`, `image`. |
|
|||
|
|
| `effectId` | string | **Required** | None | Cartoon preset ID. Accepts 262 verified styles: 215 in `encodings` (`C1`–`C70`, `E1`–`E120`, `T1`–`T25`) + 47 in `new_cartoon_effects` (`E251`–`E297`). |
|
|||
|
|
| `secretKey` | string | **Required** | `"abcdef"` | Authentication secret key. Must match `"abcdef"`. |
|
|||
|
|
|
|||
|
|
> [!NOTE]
|
|||
|
|
> Accepts `image0` or `image`. Verified on disk: 262 presets (524 `.pt` files).
|
|||
|
|
|
|||
|
|
- **Response:**
|
|||
|
|
- `200 OK`: Binary image stream (`image/png`).
|
|||
|
|
- `400 Bad Request`: `{"detail": "Missing effectId"}` or `{"detail": "Missing image file"}`.
|
|||
|
|
- `401 Unauthorized`: `{"detail": "Unauthorized: Invalid secretKey"}`.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 2.10 Background With Depth
|
|||
|
|
Replaces backgrounds while maintaining accurate foreground depth of field, natural lighting wrap, and bokeh.
|
|||
|
|
|
|||
|
|
- **URL:** `https://apigp0006.creinnovations.in/apis/flxk/flux/background_with_depth/image/`
|
|||
|
|
*(Also available at alias: `https://apigp0006.creinnovations.in/apis/flxk/flux/background_with_depth/image_bg/`)*
|
|||
|
|
- **Method:** `POST`
|
|||
|
|
- **Content-Type:** `multipart/form-data`
|
|||
|
|
|
|||
|
|
| Field | Type | Required | Default | Description |
|
|||
|
|
| :--- | :--- | :--- | :--- | :--- |
|
|||
|
|
| `image0` | UploadFile | **Required** | None | Input portrait photo. Accepted field aliases: `image0`, `image`. |
|
|||
|
|
| `effectId` | string | **Required** | None | Environment preset ID. Accepts 193 verified presets across aesthetic, birthday, sports, travel, and nature categories. |
|
|||
|
|
| `secretKey` | string | **Required** | `"abcdef"` | Authentication secret key. Must match `"abcdef"`. |
|
|||
|
|
|
|||
|
|
> [!NOTE]
|
|||
|
|
> Accepts `image0` or `image`. Verified on disk: 193 presets (386 `.pt` files). Identical handler logic is shared between `/image/` and `/image_bg/`.
|
|||
|
|
|
|||
|
|
- **Response:**
|
|||
|
|
- `200 OK`: Binary image stream (`image/png`).
|
|||
|
|
- `400 Bad Request`: `{"detail": "Missing effectId"}` or `{"detail": "Missing image file"}`.
|
|||
|
|
- `401 Unauthorized`: `{"detail": "Unauthorized: Invalid secretKey"}`.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 2.11 Vintage Look
|
|||
|
|
Applies historical film photography aesthetics, retro grain, vintage color palettes, and period lighting.
|
|||
|
|
|
|||
|
|
- **URL:** `https://apigp0006.creinnovations.in/apis/flxk/flux/vintage_look/image/`
|
|||
|
|
- **Method:** `POST`
|
|||
|
|
- **Content-Type:** `multipart/form-data`
|
|||
|
|
|
|||
|
|
| Field | Type | Required | Default | Description |
|
|||
|
|
| :--- | :--- | :--- | :--- | :--- |
|
|||
|
|
| `image0` | UploadFile | **Required** | None | Input portrait photo. Accepted field aliases: `image0`, `image`. |
|
|||
|
|
| `effectId` | string | **Required** | None | Vintage preset ID. Accepts 131 verified styles: 68 female (`F1`–`F68`), 63 male (`M1`–`M63`). |
|
|||
|
|
| `secretKey` | string | **Required** | `"abcdef"` | Authentication secret key. Must match `"abcdef"`. |
|
|||
|
|
|
|||
|
|
> [!NOTE]
|
|||
|
|
> Accepts `image0` or `image`. Verified on disk: 131 presets (262 `.pt` files).
|
|||
|
|
|
|||
|
|
- **Response:**
|
|||
|
|
- `200 OK`: Binary image stream (`image/png`).
|
|||
|
|
- `400 Bad Request`: `{"detail": "Missing effectId"}` or `{"detail": "Missing image file"}`.
|
|||
|
|
- `401 Unauthorized`: `{"detail": "Unauthorized: Invalid secretKey"}`.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 2.12 FLUX Kontext Root Health
|
|||
|
|
Liveliness probe confirming the FLUX Kontext gateway service is running and accessible.
|
|||
|
|
|
|||
|
|
- **URL:** `https://apigp0006.creinnovations.in/apis/flxk/`
|
|||
|
|
- **Method:** `GET`
|
|||
|
|
- **Content-Type:** `application/json`
|
|||
|
|
|
|||
|
|
| Field | Type | Required | Default | Description |
|
|||
|
|
| :--- | :--- | :--- | :--- | :--- |
|
|||
|
|
| *None* | — | — | — | No query or body parameters required. |
|
|||
|
|
|
|||
|
|
- **Response:**
|
|||
|
|
- `200 OK`: `{"message": "Flux Kontext API is running"}`.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 3. ML Models Endpoints
|
|||
|
|
Base URL: `https://apigp0006.creinnovations.in/apis/mlm`
|
|||
|
|
|
|||
|
|
### 3.1 New Face & Image Enhancer (GFPGAN)
|
|||
|
|
Upscales and restores facial details, removes compression artifacts, and sharpens textures.
|
|||
|
|
|
|||
|
|
- **URL:** `https://apigp0006.creinnovations.in/apis/mlm/new_enhancer/image/`
|
|||
|
|
*(Also available at alias: `https://apigp0006.creinnovations.in/apis/mlm/new_enhancer/image_previous/`)*
|
|||
|
|
- **Method:** `POST`
|
|||
|
|
- **Content-Type:** `multipart/form-data`
|
|||
|
|
|
|||
|
|
| Field | Type | Required | Default | Description |
|
|||
|
|
| :--- | :--- | :--- | :--- | :--- |
|
|||
|
|
| `image0` | UploadFile | **Required** | None | Input degraded image file. Accepted field aliases: `image0`, `image`. |
|
|||
|
|
| `src` | string | Optional | None | Base64-encoded image string alternative to multipart file upload. |
|
|||
|
|
| `scale_ratio` | float | Optional | `2.0` | Upscaling magnification factor (e.g. `2.0` or `4.0`). |
|
|||
|
|
| `noise_level` | integer | Optional | `3` | Denoising intensity parameter. |
|
|||
|
|
|
|||
|
|
> [!NOTE]
|
|||
|
|
> Accepts `image0` or `image` file uploads. If neither file is attached, falls back to `src` base64 string.
|
|||
|
|
|
|||
|
|
- **Response:**
|
|||
|
|
- `200 OK`: Binary restored image (`image/png` or `image/jpeg`).
|
|||
|
|
- `400 Bad Request`: `{"detail": "Either image or src must be provided"}`.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 3.2 Photo Colorization
|
|||
|
|
Restores lifelike color to black-and-white or faded archival photography using deep colorization models.
|
|||
|
|
|
|||
|
|
- **URL:** `https://apigp0006.creinnovations.in/apis/mlm/colorization/image/`
|
|||
|
|
- **Method:** `POST`
|
|||
|
|
- **Content-Type:** `multipart/form-data`
|
|||
|
|
|
|||
|
|
| Field | Type | Required | Default | Description |
|
|||
|
|
| :--- | :--- | :--- | :--- | :--- |
|
|||
|
|
| `image` | UploadFile | **Required** | None | Monochrome input image file. Accepted field aliases: `image`, `image0`. |
|
|||
|
|
| `src` | string | Optional | None | Base64-encoded image string fallback. |
|
|||
|
|
| `option` | integer | Optional | `1` | Architecture selector: `1` for ECCV16 model, `2` for SIGGRAPH17 model. |
|
|||
|
|
|
|||
|
|
- **Response:**
|
|||
|
|
- `200 OK`: Binary colorized image (`image/png` or `image/jpeg`).
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 3.3 Old Photo Restoration
|
|||
|
|
Removes physical scratches, creases, film grain, and sepia degradation from vintage photographs.
|
|||
|
|
|
|||
|
|
- **URL:** `https://apigp0006.creinnovations.in/apis/mlm/oldPhotoRestore/image/`
|
|||
|
|
- **Method:** `POST`
|
|||
|
|
- **Content-Type:** `multipart/form-data`
|
|||
|
|
|
|||
|
|
| Field | Type | Required | Default | Description |
|
|||
|
|
| :--- | :--- | :--- | :--- | :--- |
|
|||
|
|
| `image` | UploadFile | **Required** | None | Scanned vintage photo file. Accepted field aliases: `image`, `image0`. |
|
|||
|
|
| `src` | string | Optional | None | Base64-encoded image fallback string. |
|
|||
|
|
|
|||
|
|
- **Response:**
|
|||
|
|
- `200 OK`: Binary restored image (`image/png`).
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 3.4 Dichotomous Image Segmentation (DIS / IS-Net)
|
|||
|
|
Extracts ultra-high-precision foreground silhouettes with sub-pixel boundary accuracy.
|
|||
|
|
|
|||
|
|
- **URL:** `https://apigp0006.creinnovations.in/apis/mlm/advance_image_segment_anything_dichotomous/image/`
|
|||
|
|
- **Method:** `POST`
|
|||
|
|
- **Content-Type:** `multipart/form-data`
|
|||
|
|
|
|||
|
|
| Field | Type | Required | Default | Description |
|
|||
|
|
| :--- | :--- | :--- | :--- | :--- |
|
|||
|
|
| `image0` | UploadFile | **Required** | None | Input image file. Accepted field aliases: `image0`, `image`. |
|
|||
|
|
|
|||
|
|
- **Response:**
|
|||
|
|
- `200 OK`: Binary matte / segmented PNG mask stream.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 3.5 Clothing Identifier & Segmentation (Legacy)
|
|||
|
|
Segments clothing items and identifies individual apparel regions.
|
|||
|
|
|
|||
|
|
- **URL:** `https://apigp0006.creinnovations.in/apis/mlm/cloth_segmentation/image`
|
|||
|
|
- **Method:** `POST`
|
|||
|
|
- **Content-Type:** `multipart/form-data`
|
|||
|
|
|
|||
|
|
| Field | Type | Required | Default | Description |
|
|||
|
|
| :--- | :--- | :--- | :--- | :--- |
|
|||
|
|
| `image` | UploadFile | **Required** | None | Input photo. Accepted field aliases: `image`, `image0`. |
|
|||
|
|
|
|||
|
|
- **Response:**
|
|||
|
|
- `200 OK`: Binary garment mask PNG stream.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 3.6 Dress Segmentation Auto NewURL
|
|||
|
|
Automatic clothing boundary detection and mask extraction.
|
|||
|
|
|
|||
|
|
- **URL:** `https://apigp0006.creinnovations.in/apis/mlm/dress_segmentation_auto_newurl/image/`
|
|||
|
|
- **Method:** `POST`
|
|||
|
|
- **Content-Type:** `multipart/form-data`
|
|||
|
|
|
|||
|
|
| Field | Type | Required | Default | Description |
|
|||
|
|
| :--- | :--- | :--- | :--- | :--- |
|
|||
|
|
| `image0` | UploadFile | **Required** | None | Input photo. Accepted field aliases: `image0`, `image`. |
|
|||
|
|
|
|||
|
|
- **Response:**
|
|||
|
|
- `200 OK`: Binary clothing mask image stream.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 3.7 LaMa Cleaner (Object & Watermark Removal)
|
|||
|
|
Large Mask Inpainting (LaMa) for seamless object, text, and blemish erasing.
|
|||
|
|
|
|||
|
|
- **URL:** `https://apigp0006.creinnovations.in/apis/mlm/lamaCleaner/image/`
|
|||
|
|
- **Method:** `POST`
|
|||
|
|
- **Content-Type:** `multipart/form-data`
|
|||
|
|
|
|||
|
|
| Field | Type | Required | Default | Description |
|
|||
|
|
| :--- | :--- | :--- | :--- | :--- |
|
|||
|
|
| `image` | UploadFile | **Required** | None | Source input image. Accepted field aliases: `image`, `image0`. |
|
|||
|
|
| `mask` | UploadFile | **Required** | None | Inpainting mask (white pixels indicate areas to remove). |
|
|||
|
|
| `paintByExampleImage` | UploadFile | Optional | None | Optional exemplar reference image for guided inpainting replacement. |
|
|||
|
|
|
|||
|
|
- **Response:**
|
|||
|
|
- `200 OK`: Binary cleaned output image stream (`image/png` or `image/jpeg`).
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 3.8 Background Remover P3M
|
|||
|
|
High-fidelity portrait matting (P3M-Net) for human subject extraction with hair strands preserved.
|
|||
|
|
|
|||
|
|
- **URL:** `https://apigp0006.creinnovations.in/apis/mlm/background_remover_p3m/image/`
|
|||
|
|
- **Method:** `POST`
|
|||
|
|
- **Content-Type:** `multipart/form-data`
|
|||
|
|
|
|||
|
|
| Field | Type | Required | Default | Description |
|
|||
|
|
| :--- | :--- | :--- | :--- | :--- |
|
|||
|
|
| `image` | UploadFile | **Required** | None | Input portrait image. Accepted field aliases: `image`, `image0`. |
|
|||
|
|
|
|||
|
|
- **Response:**
|
|||
|
|
- `200 OK`: Transparent PNG image stream with background removed.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 3.9 Cartoon Effects (Legacy Route)
|
|||
|
|
Legacy cartoon effects endpoint.
|
|||
|
|
|
|||
|
|
- **URL:** `https://apigp0006.creinnovations.in/apis/mlm/cartoon_effects/image/`
|
|||
|
|
- **Method:** `POST`
|
|||
|
|
- **Status:** **NOT FOUND**
|
|||
|
|
|
|||
|
|
> [!WARNING]
|
|||
|
|
> This route (`/cartoon_effects/image/`) was referenced in legacy Django configurations but is **NOT FOUND** in the active FastAPI router codebase. Active cartoon generation is serviced via `https://apigp0006.creinnovations.in/apis/mlm/cartoonify_caricature_effects/image/` (CartoonGAN) and `https://apigp0006.creinnovations.in/apis/mlm/stable_diffusion_new_cartoon_effects/image/`.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 3.10 Face Landmark & Iris Mask Extraction
|
|||
|
|
Extracts MediaPipe 468/478 face mesh landmarks, facial bounding boxes, eye contours, and iris masks.
|
|||
|
|
|
|||
|
|
- **URL:** `https://apigp0006.creinnovations.in/apis/mlm/face_landmark/image/`
|
|||
|
|
*(Sub-endpoints: `/image2/`, `/image3/`, `/image4/`, `/image5/`, `/image6/`, `/image7/`, `/get_eye_mask`)*
|
|||
|
|
- **Method:** `POST` (for images) / `GET` (for `get_eye_mask`)
|
|||
|
|
- **Content-Type:** `multipart/form-data` (or query param for `get_eye_mask`)
|
|||
|
|
|
|||
|
|
| Field | Type | Required | Default | Description |
|
|||
|
|
| :--- | :--- | :--- | :--- | :--- |
|
|||
|
|
| `image` | UploadFile | **Required** | None | Input face image for `/image/` through `/image7/`. Accepted field aliases: `image`, `image0`. |
|
|||
|
|
| `id` | string | **Required** | None | Unique facial detection cache ID (only for `GET /get_eye_mask?id=...`). |
|
|||
|
|
|
|||
|
|
- **Sub-endpoint operations:**
|
|||
|
|
- `/image/`: Returns facial bounding boxes and 2D landmark coordinates JSON.
|
|||
|
|
- `/image2/`: Returns high-resolution iris contour masks.
|
|||
|
|
- `/image3/`: Returns mouth and lips polygon segmentation.
|
|||
|
|
- `/image4/`: Returns nose and eyebrow landmark points.
|
|||
|
|
- `/image5/`: Returns eye socket boundary masks.
|
|||
|
|
- `/image6/`: Returns full facial oval contour mask.
|
|||
|
|
- `/image7/`: Returns combined eye and face mesh geometry.
|
|||
|
|
- `/get_eye_mask`: Returns cached eye binary mask PNG by detection ID.
|
|||
|
|
- **Response:** JSON geometry / landmarks array or binary PNG mask.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 3.11 Face & Hair Segmentation
|
|||
|
|
Dual-class segmentation separating face skin and hair regions.
|
|||
|
|
|
|||
|
|
- **URL:** `https://apigp0006.creinnovations.in/apis/mlm/face_hair_segmentation/image/`
|
|||
|
|
*(Also available: `https://apigp0006.creinnovations.in/apis/mlm/face_hair_segmentation/image_couple/`)*
|
|||
|
|
- **Method:** `POST`
|
|||
|
|
- **Content-Type:** `multipart/form-data`
|
|||
|
|
|
|||
|
|
| Field | Type | Required | Default | Description |
|
|||
|
|
| :--- | :--- | :--- | :--- | :--- |
|
|||
|
|
| `image` | UploadFile | **Required** | None | Input portrait photo. Accepted field aliases: `image`, `image0`. |
|
|||
|
|
| `src` | string | Optional | None | Base64-encoded image string fallback. |
|
|||
|
|
|
|||
|
|
- **Response:**
|
|||
|
|
- `/image/`: Binary PNG multiclass segmentation mask stream.
|
|||
|
|
- `/image_couple/`: JSON dictionary containing individual masks for both subjects.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 3.12 CartoonGAN (Artistic Anime Transfer)
|
|||
|
|
Transforms real photos into classic anime styles (Hayao Miyazaki, Makoto Shinkai, Mamoru Hosoda, Satoshi Kon / Paprika).
|
|||
|
|
|
|||
|
|
- **URL:** `https://apigp0006.creinnovations.in/apis/mlm/cartoonify_caricature_effects/image/`
|
|||
|
|
- **Method:** `POST`
|
|||
|
|
- **Content-Type:** `multipart/form-data`
|
|||
|
|
|
|||
|
|
| Field | Type | Required | Default | Description |
|
|||
|
|
| :--- | :--- | :--- | :--- | :--- |
|
|||
|
|
| `image0` | UploadFile | **Required** | None | Input photo file. Accepted field aliases: `image0`, `image`. |
|
|||
|
|
| `style_id` | string | Optional | `"hayao"` | Target anime art style: `"hayao"`, `"shinkai"`, `"hosoda"`, or `"paprika"`. |
|
|||
|
|
| `src` | string | Optional | None | Base64-encoded image fallback string. |
|
|||
|
|
| `secretKey` | string | Optional | None | Optional authorization token. |
|
|||
|
|
|
|||
|
|
- **Response:**
|
|||
|
|
- `200 OK`: Binary cartoonified image stream (`image/png` or `image/jpeg`).
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 3.13 Hair Segmentation (Classic)
|
|||
|
|
Extracts isolated binary hair masks from portrait photography.
|
|||
|
|
|
|||
|
|
- **URL:** `https://apigp0006.creinnovations.in/apis/mlm/hair_segmentation/image/`
|
|||
|
|
- **Method:** `POST`
|
|||
|
|
- **Content-Type:** `multipart/form-data`
|
|||
|
|
|
|||
|
|
| Field | Type | Required | Default | Description |
|
|||
|
|
| :--- | :--- | :--- | :--- | :--- |
|
|||
|
|
| `image0` | UploadFile | **Required** | None | Input portrait. Accepted field aliases: `image0`, `image`. |
|
|||
|
|
| `src` | string | Optional | None | Base64-encoded image fallback string. |
|
|||
|
|
|
|||
|
|
- **Response:**
|
|||
|
|
- `200 OK`: Binary hair mask PNG stream.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 3.14 Hair Segmentation YOLO + SAM
|
|||
|
|
State-of-the-art hair boundary extraction combining YOLOv8 bounding box detection with Segment Anything Model (SAM).
|
|||
|
|
|
|||
|
|
- **URL:** `https://apigp0006.creinnovations.in/apis/mlm/hair_segmentation_yolo_sam/image/`
|
|||
|
|
- **Method:** `POST`
|
|||
|
|
- **Content-Type:** `multipart/form-data`
|
|||
|
|
|
|||
|
|
| Field | Type | Required | Default | Description |
|
|||
|
|
| :--- | :--- | :--- | :--- | :--- |
|
|||
|
|
| `image0` | UploadFile | **Required** | None | Input portrait. Accepted field aliases: `image0`, `image`. |
|
|||
|
|
| `src` | string | Optional | None | Base64-encoded image fallback string. |
|
|||
|
|
|
|||
|
|
- **Response:**
|
|||
|
|
- `200 OK`: Binary hair mask PNG stream with fine-strand detail.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 3.15 Stable Diffusion Hair Segmentation
|
|||
|
|
Hair segmentation service utilizing Stable Diffusion latent attention maps.
|
|||
|
|
|
|||
|
|
- **URL:** `https://apigp0006.creinnovations.in/apis/mlm/stable_diffusion_hair_segmentation/image/`
|
|||
|
|
*(Sub-endpoints: `/image1/`, `/cleanup/`)*
|
|||
|
|
- **Method:** `POST`
|
|||
|
|
- **Content-Type:** `multipart/form-data`
|
|||
|
|
|
|||
|
|
| Field | Type | Required | Default | Description |
|
|||
|
|
| :--- | :--- | :--- | :--- | :--- |
|
|||
|
|
| `image0` | UploadFile | **Required** | None | Input photo file for `/image/` and `/image1/`. Accepted field aliases: `image0`, `image`. |
|
|||
|
|
| `src` | string | Optional | None | Base64-encoded image string fallback. |
|
|||
|
|
|
|||
|
|
- **Response:**
|
|||
|
|
- `/image/`, `/image1/`: Binary hair mask PNG stream.
|
|||
|
|
- `/cleanup/`: JSON status `{"status": "ok", "message": "temporary files cleaned"}`.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 3.16 Eye Bag Remover
|
|||
|
|
Dermatological inpainting model smoothing and removing infraorbital dark circles and under-eye puffiness.
|
|||
|
|
|
|||
|
|
- **URL:** `https://apigp0006.creinnovations.in/apis/mlm/eye_bag_remover/image/`
|
|||
|
|
- **Method:** `POST`
|
|||
|
|
- **Content-Type:** `multipart/form-data`
|
|||
|
|
|
|||
|
|
| Field | Type | Required | Default | Description |
|
|||
|
|
| :--- | :--- | :--- | :--- | :--- |
|
|||
|
|
| `image` | UploadFile | **Required** | None | Input face portrait. Accepted field aliases: `image`, `image0`. |
|
|||
|
|
|
|||
|
|
- **Response:**
|
|||
|
|
- `200 OK`: Binary retouched portrait image stream.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 3.17 Skin Detection
|
|||
|
|
Pixel-level skin region classifier isolating bare skin from background and clothing.
|
|||
|
|
|
|||
|
|
- **URL:** `https://apigp0006.creinnovations.in/apis/mlm/skin_detection/image/`
|
|||
|
|
- **Method:** `POST`
|
|||
|
|
- **Content-Type:** `multipart/form-data`
|
|||
|
|
|
|||
|
|
| Field | Type | Required | Default | Description |
|
|||
|
|
| :--- | :--- | :--- | :--- | :--- |
|
|||
|
|
| `image` | UploadFile | **Required** | None | Input portrait photo. Accepted field aliases: `image`, `image0`. |
|
|||
|
|
|
|||
|
|
- **Response:**
|
|||
|
|
- `200 OK`: Binary skin mask PNG stream.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 3.18 Sky Detection
|
|||
|
|
Isolates outdoor sky regions for sky replacement and landscape relighting.
|
|||
|
|
|
|||
|
|
- **URL:** `https://apigp0006.creinnovations.in/apis/mlm/sky_detection/image/`
|
|||
|
|
- **Method:** `POST`
|
|||
|
|
- **Content-Type:** `multipart/form-data`
|
|||
|
|
|
|||
|
|
| Field | Type | Required | Default | Description |
|
|||
|
|
| :--- | :--- | :--- | :--- | :--- |
|
|||
|
|
| `image0` | UploadFile | **Required** | None | Input landscape or outdoor photo. Accepted field aliases: `image0`, `image`. |
|
|||
|
|
|
|||
|
|
- **Response:**
|
|||
|
|
- `200 OK`: Binary sky region mask PNG stream.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 3.19 Cloth Segmentation V2
|
|||
|
|
Multi-class apparel parser separating garments by category (upper, lower, dress, full outfit).
|
|||
|
|
|
|||
|
|
- **URL:** `https://apigp0006.creinnovations.in/apis/mlm/cloth_segmentation_v2/segment/`
|
|||
|
|
- **Method:** `POST`
|
|||
|
|
- **Content-Type:** `multipart/form-data`
|
|||
|
|
|
|||
|
|
| Field | Type | Required | Default | Description |
|
|||
|
|
| :--- | :--- | :--- | :--- | :--- |
|
|||
|
|
| `file` | UploadFile | **Required** | None | Input image file. Accepted field aliases: `file`, `image`, `image0`, `source`. |
|
|||
|
|
| `cloth_part` | string | Optional | `"full"` | Target anatomical garment region: `"upper"`, `"lower"`, `"dress"`, or `"full"`. |
|
|||
|
|
|
|||
|
|
- **Response:**
|
|||
|
|
- `200 OK`: Binary segmented garment mask PNG stream.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 3.20 Pose Detection
|
|||
|
|
Extracts 33 human skeletal keypoints, joint angles, and pose geometry via MediaPipe Pose.
|
|||
|
|
|
|||
|
|
- **URL:** `https://apigp0006.creinnovations.in/apis/mlm/pose_detection/image/`
|
|||
|
|
- **Method:** `POST`
|
|||
|
|
- **Content-Type:** `multipart/form-data`
|
|||
|
|
|
|||
|
|
| Field | Type | Required | Default | Description |
|
|||
|
|
| :--- | :--- | :--- | :--- | :--- |
|
|||
|
|
| `image` | UploadFile | **Required** | None | Full-body or upper-body photo. Accepted field aliases: `image`, `image0`. |
|
|||
|
|
|
|||
|
|
- **Response:**
|
|||
|
|
- `200 OK`: JSON array containing 3D skeletal landmark coordinates `[{"x": float, "y": float, "z": float, "visibility": float}, ...]`.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 3.21 Caricature Avatar Suite
|
|||
|
|
Generates stylized caricature avatars from portrait photography.
|
|||
|
|
|
|||
|
|
- **URL:** `https://apigp0006.creinnovations.in/apis/mlm/caricature_avatar/image/`
|
|||
|
|
*(Sub-endpoints: `/image1/`, `/single_couple_image/`)*
|
|||
|
|
- **Method:** `POST`
|
|||
|
|
- **Content-Type:** `multipart/form-data`
|
|||
|
|
|
|||
|
|
| Field | Type | Required | Default | Description |
|
|||
|
|
| :--- | :--- | :--- | :--- | :--- |
|
|||
|
|
| `image` | UploadFile | **Required** | None | Single portrait photo for `/image/`. Accepted field aliases: `image`, `image0`, `source`. |
|
|||
|
|
| `source1` | UploadFile | **Required** | None | First subject face photo (for `/image1/`). |
|
|||
|
|
| `source2` | UploadFile | **Required** | None | Second subject face photo (for `/image1/`). |
|
|||
|
|
| `source` | UploadFile | **Required** | None | Input photo (for `/single_couple_image/`). |
|
|||
|
|
| `reference` | string | Optional | `"test_ref"` | Template artwork reference ID. |
|
|||
|
|
| `app_name` | string | Optional | `"test_app"` | Calling client application identifier. |
|
|||
|
|
|
|||
|
|
- **Response:**
|
|||
|
|
- `200 OK`: Binary caricature avatar output image (`image/png` or `image/jpeg`).
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 3.22 Teeth Whitener
|
|||
|
|
Cosmetic dental enhancement detecting teeth and adjusting CIELAB color values to whiten smiles naturally.
|
|||
|
|
|
|||
|
|
- **URL:** `https://apigp0006.creinnovations.in/apis/mlm/teeth_whitener/image/`
|
|||
|
|
*(Also available: `https://apigp0006.creinnovations.in/apis/mlm/teeth_whitener/image_full/`)*
|
|||
|
|
- **Method:** `POST`
|
|||
|
|
- **Content-Type:** `multipart/form-data`
|
|||
|
|
|
|||
|
|
| Field | Type | Required | Default | Description |
|
|||
|
|
| :--- | :--- | :--- | :--- | :--- |
|
|||
|
|
| `image` | UploadFile | **Required** | None | Input portrait photo. Accepted field aliases: `image`, `image0`. |
|
|||
|
|
|
|||
|
|
- **Response:**
|
|||
|
|
- `/image/`: Cropped high-resolution enhanced smile patch.
|
|||
|
|
- `/image_full/`: Full enhanced portrait with whitened teeth blended seamlessly.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 3.23 Blemish Remover & Skin Improver
|
|||
|
|
Removes acne, scars, and blemishes while preserving authentic skin pores via frequency separation.
|
|||
|
|
|
|||
|
|
- **URL:** `https://apigp0006.creinnovations.in/apis/mlm/blemish_remover/image/`
|
|||
|
|
*(Sub-endpoints: `/improver/`, `/eye_fix/`)*
|
|||
|
|
- **Method:** `POST`
|
|||
|
|
- **Content-Type:** `multipart/form-data`
|
|||
|
|
|
|||
|
|
| Field | Type | Required | Default | Description |
|
|||
|
|
| :--- | :--- | :--- | :--- | :--- |
|
|||
|
|
| `image0` | UploadFile | **Required** | None | Input face portrait. Accepted field aliases: `image0`, `image`, `file`. |
|
|||
|
|
|
|||
|
|
- **Response:**
|
|||
|
|
- `200 OK`: Binary retouched portrait image stream.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 3.24 Eye Redness Remover
|
|||
|
|
Corrects bloodshot sclera and camera flash redness in portrait photography.
|
|||
|
|
|
|||
|
|
- **URL:** `https://apigp0006.creinnovations.in/apis/mlm/eye_redness_remover/image/`
|
|||
|
|
- **Method:** `POST`
|
|||
|
|
- **Content-Type:** `multipart/form-data`
|
|||
|
|
|
|||
|
|
| Field | Type | Required | Default | Description |
|
|||
|
|
| :--- | :--- | :--- | :--- | :--- |
|
|||
|
|
| `image0` | UploadFile | **Required** | None | Input portrait photo. Accepted field aliases: `image0`, `image`. |
|
|||
|
|
|
|||
|
|
- **Response:**
|
|||
|
|
- `200 OK`: Binary corrected portrait image stream.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 3.25 Polaroid Effect
|
|||
|
|
Applies authentic instant-film color grading presets and film emulsion tone curves.
|
|||
|
|
|
|||
|
|
- **URL:** `https://apigp0006.creinnovations.in/apis/mlm/polaroid_effect/image/`
|
|||
|
|
- **Method:** `POST`
|
|||
|
|
- **Content-Type:** `multipart/form-data`
|
|||
|
|
|
|||
|
|
| Field | Type | Required | Default | Description |
|
|||
|
|
| :--- | :--- | :--- | :--- | :--- |
|
|||
|
|
| `image0` | UploadFile | **Required** | None | Input photo file. Accepted field aliases: `image0`, `image`. |
|
|||
|
|
| `config` | string | Optional | None | Color grading configuration / tone curve preset name. |
|
|||
|
|
|
|||
|
|
- **Response:**
|
|||
|
|
- `200 OK`: Binary Polaroid-graded image stream (`image/png` or `image/jpeg`).
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 3.26 Face Swapper Suite
|
|||
|
|
Comprehensive deep face swapping supporting single face, couple swaps, and gaze correction.
|
|||
|
|
|
|||
|
|
- **URL:** `https://apigp0006.creinnovations.in/apis/mlm/face_swapper/image/`
|
|||
|
|
*(Sub-endpoints: `/couple_swap/`, `/eyes/`, `/open_eye_new/`, `/couple_swap_single/`)*
|
|||
|
|
- **Method:** `POST`
|
|||
|
|
- **Content-Type:** `multipart/form-data`
|
|||
|
|
|
|||
|
|
| Field | Type | Required | Default | Description |
|
|||
|
|
| :--- | :--- | :--- | :--- | :--- |
|
|||
|
|
| `image` | UploadFile | **Required** | None | Source face image for `/image/`. Accepted field aliases: `image`, `image0`, `source`. |
|
|||
|
|
| `target` | UploadFile | Optional | None | Target body/face image to receive the donor face. |
|
|||
|
|
| `source1` | UploadFile | **Required** | None | First partner face for `/couple_swap/`. |
|
|||
|
|
| `source2` | UploadFile | **Required** | None | Second partner face for `/couple_swap/`. |
|
|||
|
|
| `source` | UploadFile | **Required** | None | Source portrait for `/eyes/`, `/open_eye_new/`, and `/couple_swap_single/`. |
|
|||
|
|
| `reference` | string | Optional | `"test_ref"` | Reference template key. **Required** for `/couple_swap/` and `/couple_swap_single/`. |
|
|||
|
|
| `app_name` | string | Optional | `"test_app"` | Client application identifier. |
|
|||
|
|
|
|||
|
|
- **Response:**
|
|||
|
|
- `200 OK`: Binary swapped portrait image stream.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 3.27 Relighting Effect
|
|||
|
|
Relights human subjects using the environmental illumination and color temperature of a background image.
|
|||
|
|
|
|||
|
|
- **URL:** `https://apigp0006.creinnovations.in/apis/mlm/relighting_effect/image/`
|
|||
|
|
- **Method:** `POST`
|
|||
|
|
- **Content-Type:** `multipart/form-data`
|
|||
|
|
|
|||
|
|
| Field | Type | Required | Default | Description |
|
|||
|
|
| :--- | :--- | :--- | :--- | :--- |
|
|||
|
|
| `image` | UploadFile | **Required** | None | Foreground portrait image. Accepted field aliases: `image`, `image0`. |
|
|||
|
|
| `bg_image` | UploadFile | **Required** | None | Background lighting reference image. |
|
|||
|
|
|
|||
|
|
- **Response:**
|
|||
|
|
- `200 OK`: Binary relit portrait blended seamlessly into the background lighting.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 3.28 Skin Health Analyzer
|
|||
|
|
Performs 18 clinical dermatological diagnostic assessments on facial skin (wrinkles, pores, acne, moisture, texture).
|
|||
|
|
|
|||
|
|
- **URL:** `https://apigp0006.creinnovations.in/apis/mlm/skin_analyzer/analyze`
|
|||
|
|
- **Method:** `POST`
|
|||
|
|
- **Content-Type:** `multipart/form-data`
|
|||
|
|
|
|||
|
|
| Field | Type | Required | Default | Description |
|
|||
|
|
| :--- | :--- | :--- | :--- | :--- |
|
|||
|
|
| `image` | UploadFile | **Required** | None | High-resolution face portrait. Accepted field aliases: `image`, `image0`, `file`. |
|
|||
|
|
|
|||
|
|
- **Response:**
|
|||
|
|
- `200 OK`: JSON report containing skin age, metric scores (0–100), severity grades, and localized diagnostic masks.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 3.29 Trendy Traffic Guard & Reverse Proxy
|
|||
|
|
Intelligent traffic gateway validating payloads against preflight schemas and forwarding requests to target APIs.
|
|||
|
|
|
|||
|
|
- **URL:** `https://apigp0006.creinnovations.in/apis/mlm/trendy/`
|
|||
|
|
- **Method:** `POST` / `OPTIONS` / `GET`
|
|||
|
|
- **Content-Type:** `multipart/form-data` or `application/json`
|
|||
|
|
|
|||
|
|
| Field | Type | Required | Default | Description |
|
|||
|
|
| :--- | :--- | :--- | :--- | :--- |
|
|||
|
|
| `api_url` | string | **Required** | None | Target base API URL (e.g. `http://127.0.0.1:8005/sdxl/dress_pattern/`). |
|
|||
|
|
| `api_endpoint` | string | **Required** | None | Target sub-endpoint (e.g. `image/` or `ping`). |
|
|||
|
|
| `api_key` | string | Optional | None | Optional API authorization token forwarded in request headers. |
|
|||
|
|
| *Additional* | any | Optional | None | All forwarded parameters, prompts, and file attachments expected by the target service. |
|
|||
|
|
|
|||
|
|
- **Response:**
|
|||
|
|
- Proxied response payload and media headers from destination backend service.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 3.30 Multi-Segmentation YOLO + SAM (ML Models Port)
|
|||
|
|
High-precision multi-class object and garment segmentation router.
|
|||
|
|
|
|||
|
|
- **URL:** `https://apigp0006.creinnovations.in/apis/mlm/multi_segmentation_yolo_sam/image/`
|
|||
|
|
- **Method:** `POST`
|
|||
|
|
- **Content-Type:** `multipart/form-data`
|
|||
|
|
|
|||
|
|
| Field | Type | Required | Default | Description |
|
|||
|
|
| :--- | :--- | :--- | :--- | :--- |
|
|||
|
|
| `image` | UploadFile | **Required** | None | Input image to segment. Accepted field aliases: `image`, `file`. |
|
|||
|
|
| `secretKey` | string | **Required** | `"abcdef"` | Authentication secret key. Must match `"abcdef"`. |
|
|||
|
|
| `effect_id` | string | Optional | `"Upper_Body"` | Segmentation class target (e.g. `"Upper_Body"`, `"Lower_Body"`, `"Dress"`, `"Hair"`). |
|
|||
|
|
| `custom_prompt` | string | Optional | None | Optional custom text prompt for open-vocabulary YOLO segmentation. |
|
|||
|
|
|
|||
|
|
- **Response:**
|
|||
|
|
- `200 OK`: Binary category mask PNG stream.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 3.31 Stable Diffusion Generation (SD 1.5)
|
|||
|
|
Classic Stable Diffusion 1.5 generation and text-to-image pipeline.
|
|||
|
|
|
|||
|
|
- **URL:** `https://apigp0006.creinnovations.in/apis/mlm/stable_diffusion/image/`
|
|||
|
|
- **Method:** `POST`
|
|||
|
|
- **Content-Type:** `multipart/form-data`
|
|||
|
|
|
|||
|
|
| Field | Type | Required | Default | Description |
|
|||
|
|
| :--- | :--- | :--- | :--- | :--- |
|
|||
|
|
| `image0` | UploadFile | **Required** | None | Input initial image. Accepted field aliases: `image0`, `image`. |
|
|||
|
|
| `effectId` | string | **Required** | None | Preset effect identifier or prompt key. |
|
|||
|
|
| `width` | integer | Optional | `512` | Output image width. |
|
|||
|
|
| `height` | integer | Optional | `512` | Output image height. |
|
|||
|
|
|
|||
|
|
- **Response:**
|
|||
|
|
- `200 OK`: Binary generated image stream (`image/png`).
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 3.32 SD Avatar With Original Face
|
|||
|
|
Generates themed avatar portraits while preserving the user's authentic facial identity.
|
|||
|
|
|
|||
|
|
- **URL:** `https://apigp0006.creinnovations.in/apis/mlm/stable_diffusion_avatar_with_original_face/image/`
|
|||
|
|
*(Sub-endpoints: `/inpaint/`, `/super/`)*
|
|||
|
|
- **Method:** `POST`
|
|||
|
|
- **Content-Type:** `multipart/form-data`
|
|||
|
|
|
|||
|
|
| Field | Type | Required | Default | Description |
|
|||
|
|
| :--- | :--- | :--- | :--- | :--- |
|
|||
|
|
| `image0` | UploadFile | **Required** | None | Input face portrait. Accepted field aliases: `image0`, `image`. |
|
|||
|
|
| `face_segmented_image` | UploadFile | Optional | None | Optional face mask. Accepted field alias: `mask`. |
|
|||
|
|
| `effectId` | string | **Required** | None | Avatar style preset ID. |
|
|||
|
|
| `width` | integer | Optional | `512` | Image width. |
|
|||
|
|
| `height` | integer | Optional | `512` | Image height. |
|
|||
|
|
| `secretKey` | string | Optional | `"abcdef"` | Authentication secret key for `/inpaint/` and `/super/`. |
|
|||
|
|
| `prompt` | string | Optional | None | Optional custom text prompt for `/inpaint/` and `/super/`. |
|
|||
|
|
|
|||
|
|
- **Response:**
|
|||
|
|
- `200 OK`: Binary avatar image stream (`image/png`).
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 3.33 SD Art Style Transfer
|
|||
|
|
Neural style transfer applying classical painting styles onto photographs.
|
|||
|
|
|
|||
|
|
- **URL:** `https://apigp0006.creinnovations.in/apis/mlm/stable_diffusion_art_style_transfer/image/`
|
|||
|
|
- **Method:** `POST`
|
|||
|
|
- **Content-Type:** `multipart/form-data`
|
|||
|
|
|
|||
|
|
| Field | Type | Required | Default | Description |
|
|||
|
|
| :--- | :--- | :--- | :--- | :--- |
|
|||
|
|
| `image0` | UploadFile | **Required** | None | Input content photo. Accepted field aliases: `image0`, `image`. |
|
|||
|
|
| `artId` | string | **Required** | None | Art style preset identifier (e.g. `art1`–`art29`). |
|
|||
|
|
| `pose` | string | Optional | None | Optional pose conditioning vector. |
|
|||
|
|
| `width` | integer | Optional | `512` | Output image width. |
|
|||
|
|
| `height` | integer | Optional | `512` | Output image height. |
|
|||
|
|
|
|||
|
|
- **Response:**
|
|||
|
|
- `200 OK`: Binary stylized image stream.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 3.34 SD Realistic Background Changer
|
|||
|
|
Replaces portrait background with realistic scenes using depth-aware SD 1.5 inpainting.
|
|||
|
|
|
|||
|
|
- **URL:** `https://apigp0006.creinnovations.in/apis/mlm/stable_diffusion_realistic_background_changer/image/`
|
|||
|
|
- **Method:** `POST`
|
|||
|
|
- **Content-Type:** `multipart/form-data`
|
|||
|
|
|
|||
|
|
| Field | Type | Required | Default | Description |
|
|||
|
|
| :--- | :--- | :--- | :--- | :--- |
|
|||
|
|
| `image0` | UploadFile | **Required** | None | Input portrait photo. Accepted field aliases: `image0`, `image`. |
|
|||
|
|
| `mask_image` | UploadFile | Optional | None | Optional background mask. Accepted field alias: `mask`. |
|
|||
|
|
| `colorId` | string | Optional | None | Background scene / color preset ID. |
|
|||
|
|
| `userPrompt` | string | Optional | None | Custom prompt describing the background scene. |
|
|||
|
|
| `isFromCustomUserPrompt` | boolean | Optional | `False` | Flag indicating whether to prioritize `userPrompt`. |
|
|||
|
|
| `pose` | string | Optional | None | Optional pose constraint vector. |
|
|||
|
|
| `width` | integer | Optional | `512` | Output image width. |
|
|||
|
|
| `height` | integer | Optional | `512` | Output image height. |
|
|||
|
|
|
|||
|
|
- **Response:**
|
|||
|
|
- `200 OK`: Binary image with replaced background.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 3.35 SD Silhouette Maker
|
|||
|
|
Generates dramatic backlit silhouette portraits from input photos.
|
|||
|
|
|
|||
|
|
- **URL:** `https://apigp0006.creinnovations.in/apis/mlm/stable_diffusion_silhouette_maker/image/`
|
|||
|
|
- **Method:** `POST`
|
|||
|
|
- **Content-Type:** `multipart/form-data`
|
|||
|
|
|
|||
|
|
| Field | Type | Required | Default | Description |
|
|||
|
|
| :--- | :--- | :--- | :--- | :--- |
|
|||
|
|
| `image0` | UploadFile | **Required** | None | Input subject photo. |
|
|||
|
|
| `mask` | UploadFile | **Required** | None | Silhouette cutout mask image. |
|
|||
|
|
| `secretKey` | string | **Required** | `"abcdef"` | Authentication secret key. Must match `"abcdef"`. |
|
|||
|
|
| `effectId` | string | Optional | None | Silhouette lighting / atmosphere preset ID. |
|
|||
|
|
| `width` | integer | Optional | `512` | Output image width. |
|
|||
|
|
| `height` | integer | Optional | `512` | Output image height. |
|
|||
|
|
|
|||
|
|
- **Response:**
|
|||
|
|
- `200 OK`: Binary silhouette image stream.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 3.36 SD Caricature Effects
|
|||
|
|
Generates exaggerated caricature portrait illustrations using Stable Diffusion fine-tunes.
|
|||
|
|
|
|||
|
|
- **URL:** `https://apigp0006.creinnovations.in/apis/mlm/stable_diffusion_caricature_effects/image/`
|
|||
|
|
- **Method:** `POST`
|
|||
|
|
- **Content-Type:** `multipart/form-data`
|
|||
|
|
|
|||
|
|
| Field | Type | Required | Default | Description |
|
|||
|
|
| :--- | :--- | :--- | :--- | :--- |
|
|||
|
|
| `image0` | UploadFile | **Required** | None | Input face portrait. Accepted field aliases: `image0`, `image`. |
|
|||
|
|
| `effectId` | string | Optional | None | Caricature style preset ID (forwards to FLUX caricature pipeline). |
|
|||
|
|
|
|||
|
|
- **Response:**
|
|||
|
|
- `200 OK`: Binary caricature image stream.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 3.37 SD Comic Generator
|
|||
|
|
Generates multi-panel or illustrated comic art from input photography and text prompts.
|
|||
|
|
|
|||
|
|
- **URL:** `https://apigp0006.creinnovations.in/apis/mlm/stable_diffusion_comic_generator/image/`
|
|||
|
|
- **Method:** `POST`
|
|||
|
|
- **Content-Type:** `multipart/form-data`
|
|||
|
|
|
|||
|
|
| Field | Type | Required | Default | Description |
|
|||
|
|
| :--- | :--- | :--- | :--- | :--- |
|
|||
|
|
| `image0` | UploadFile | **Required** | None | Input image. Accepted field aliases: `image0`, `image`. |
|
|||
|
|
| `userPrompt` | string | Optional | None | Custom narrative text prompt. |
|
|||
|
|
| `isFromCustomUserPrompt` | boolean | Optional | `False` | Flag indicating whether to override preset prompts. |
|
|||
|
|
| `width` | integer | Optional | `512` | Output image width. |
|
|||
|
|
| `height` | integer | Optional | `512` | Output image height. |
|
|||
|
|
|
|||
|
|
- **Response:**
|
|||
|
|
- `200 OK`: Binary comic panel image stream.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 3.38 SD Photo to Caricature
|
|||
|
|
Converts portrait photos into cartoon caricature illustrations categorized by gender.
|
|||
|
|
|
|||
|
|
- **URL:** `https://apigp0006.creinnovations.in/apis/mlm/stable_diffusion_photo_2_caricature/image/`
|
|||
|
|
- **Method:** `POST`
|
|||
|
|
- **Content-Type:** `multipart/form-data`
|
|||
|
|
|
|||
|
|
| Field | Type | Required | Default | Description |
|
|||
|
|
| :--- | :--- | :--- | :--- | :--- |
|
|||
|
|
| `image0` | UploadFile | **Required** | None | Input portrait photo. Accepted field aliases: `image0`, `image`. |
|
|||
|
|
| `category` | string | Optional | `"male"` | Subject category (`"male"` or `"female"`). |
|
|||
|
|
| `width` | integer | Optional | `512` | Output image width. |
|
|||
|
|
| `height` | integer | Optional | `512` | Output image height. |
|
|||
|
|
|
|||
|
|
- **Response:**
|
|||
|
|
- `200 OK`: Binary caricature image stream.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 3.39 SD Caricature Hair & Face Effect
|
|||
|
|
Inpaints stylized caricature hair and facial features onto portrait photos using automatic CHF mask generation.
|
|||
|
|
|
|||
|
|
- **URL:** `https://apigp0006.creinnovations.in/apis/mlm/stable_diffusion_caricature_hair_face_effect/image/`
|
|||
|
|
- **Method:** `POST`
|
|||
|
|
- **Content-Type:** `multipart/form-data`
|
|||
|
|
|
|||
|
|
| Field | Type | Required | Default | Description |
|
|||
|
|
| :--- | :--- | :--- | :--- | :--- |
|
|||
|
|
| `image0` | UploadFile | **Required** | None | Input portrait photo. Accepted field aliases: `image0`, `image`. |
|
|||
|
|
| `effectId` | string | **Required** | None | Caricature hair/face preset ID (e.g. `CHF1`). |
|
|||
|
|
| `width` | integer | Optional | `512` | Output image width. |
|
|||
|
|
| `height` | integer | Optional | `512` | Output image height. |
|
|||
|
|
|
|||
|
|
- **Response:**
|
|||
|
|
- `200 OK`: Binary rendered caricature image stream.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 3.40 SD New Cartoon Effects
|
|||
|
|
Renders modern cel-shaded and anime cartoon illustrations from portrait photography.
|
|||
|
|
|
|||
|
|
- **URL:** `https://apigp0006.creinnovations.in/apis/mlm/stable_diffusion_new_cartoon_effects/image/`
|
|||
|
|
- **Method:** `POST`
|
|||
|
|
- **Content-Type:** `multipart/form-data`
|
|||
|
|
|
|||
|
|
| Field | Type | Required | Default | Description |
|
|||
|
|
| :--- | :--- | :--- | :--- | :--- |
|
|||
|
|
| `image0` | UploadFile | **Required** | None | Input portrait photo. Accepted field aliases: `image0`, `image`. |
|
|||
|
|
| `cartoonId` | string | **Required** | None | Cartoon style preset ID. |
|
|||
|
|
| `userPrompt` | string | Optional | None | Optional supplementary text prompt. |
|
|||
|
|
| `width` | integer | Optional | `512` | Output image width. |
|
|||
|
|
| `height` | integer | Optional | `512` | Output image height. |
|
|||
|
|
|
|||
|
|
- **Response:**
|
|||
|
|
- `200 OK`: Binary cartoon image stream.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 3.41 SD Artistic Effects
|
|||
|
|
Renders expressive artistic painterly styles (oil painting, sketch, watercolor).
|
|||
|
|
|
|||
|
|
- **URL:** `https://apigp0006.creinnovations.in/apis/mlm/stable_diffusion_artistic_effects/image/`
|
|||
|
|
- **Method:** `POST`
|
|||
|
|
- **Content-Type:** `multipart/form-data`
|
|||
|
|
|
|||
|
|
| Field | Type | Required | Default | Description |
|
|||
|
|
| :--- | :--- | :--- | :--- | :--- |
|
|||
|
|
| `image0` | UploadFile | **Required** | None | Input image. Accepted field aliases: `image0`, `image`. |
|
|||
|
|
| `artid` | string | **Required** | None | Artistic effect preset ID. |
|
|||
|
|
| `category` | string | Optional | None | Style category. |
|
|||
|
|
| `width` | integer | Optional | `512` | Output image width. |
|
|||
|
|
| `height` | integer | Optional | `512` | Output image height. |
|
|||
|
|
|
|||
|
|
- **Response:**
|
|||
|
|
- `200 OK`: Binary artistic image stream.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 3.42 User Feedback Submission
|
|||
|
|
Records end-user sentiment (`like` / `dislike`), feedback text, device details, and telemetry.
|
|||
|
|
|
|||
|
|
- **URL:** `https://apigp0006.creinnovations.in/apis/mlm/feedback/submit/`
|
|||
|
|
- **Method:** `POST`
|
|||
|
|
- **Content-Type:** `multipart/form-data` or `application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
| Field | Type | Required | Default | Description |
|
|||
|
|
| :--- | :--- | :--- | :--- | :--- |
|
|||
|
|
| `feedback` | string | **Required** | None | User sentiment rating. Must be strictly `"like"` or `"dislike"`. |
|
|||
|
|
| `feedback_content` | string | Optional | None | Optional user comments or textual feedback. |
|
|||
|
|
| `platform` | string | Optional | None | Client operating system (e.g. `"ios"`, `"android"`, `"web"`). |
|
|||
|
|
| `app_name` | string | Optional | None | Client application name. |
|
|||
|
|
| `version` | string | Optional | None | Application release version. |
|
|||
|
|
| `feature` | string | Optional | None | Feature or endpoint being rated. |
|
|||
|
|
| `developer_account` | string | Optional | None | Developer organizational account identifier. |
|
|||
|
|
| `bundle_id` | string | Optional | None | iOS application bundle identifier. |
|
|||
|
|
| `package_name` | string | Optional | None | Android application package name. |
|
|||
|
|
| `is_paid_user` | string | Optional | None | Subscription flag (`"true"` / `"false"`). |
|
|||
|
|
|
|||
|
|
- **Response:**
|
|||
|
|
- `201 Created`: `{"message": "Feedback submitted successfully", "id": 123}`.
|
|||
|
|
- `400 Bad Request`: `{"status": "error", "message": "Mandatory parameter 'feedback' must be 'like' or 'dislike'."}`.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 3.43 Error & Bug Telemetry Reporting
|
|||
|
|
Collects detailed client error diagnostics, crash logs, request bodies, and before/after image attachments.
|
|||
|
|
|
|||
|
|
- **URL:** `https://apigp0006.creinnovations.in/apis/mlm/reports/data/`
|
|||
|
|
- **Method:** `POST`
|
|||
|
|
- **Content-Type:** `multipart/form-data`
|
|||
|
|
|
|||
|
|
| Field | Type | Required | Default | Description |
|
|||
|
|
| :--- | :--- | :--- | :--- | :--- |
|
|||
|
|
| `api_url` | string | Optional | None | The backend API endpoint URL where the error or bug occurred. |
|
|||
|
|
| `feature` | string | Optional | None | The specific feature name. |
|
|||
|
|
| `rqst_body` | string | Optional | None | Serialized request body JSON or string payload that triggered the issue. |
|
|||
|
|
| `user_message` | string | Optional | None | Error description or user issue message. |
|
|||
|
|
| `app_name` | string | Optional | None | Client application name. |
|
|||
|
|
| `version` | string | Optional | None | Application release version. |
|
|||
|
|
| `platform` | string | Optional | None | Client OS platform (`ios`, `android`, etc.). |
|
|||
|
|
| `bundle_id` | string | Optional | None | iOS application bundle identifier (assigned automatically if platform is iOS). |
|
|||
|
|
| `package_name` | string | Optional | None | Android package name (assigned automatically if platform is Android). |
|
|||
|
|
| `dev_account` | string | Optional | None | Developer account identifier. |
|
|||
|
|
| `ispaiduser` | string | Optional | None | Subscription status flag. |
|
|||
|
|
| `image_init` | UploadFile | Optional | None | Attached original input image file before failure. |
|
|||
|
|
| `image_res` | UploadFile | Optional | None | Attached resulting output image file (if any). |
|
|||
|
|
|
|||
|
|
- **Response:**
|
|||
|
|
- `201 Created`: `{"message": "Report submitted successfully", "id": 456}`.
|
|||
|
|
- `400 Bad Request`: `{"status": "error", "message": "<error_details>"}`.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 4. ComfyUI Endpoints
|
|||
|
|
Base URL: `https://apigp0905.creinnovations.in/apis/cmf`
|
|||
|
|
|
|||
|
|
### 4.1 ComfyUI Dress Changer Inpainting
|
|||
|
|
Automated wardrobe replacement utilizing Sapiens 1B full-body skin protection and round-robin ComfyUI inpainting backends.
|
|||
|
|
|
|||
|
|
- **URL:** `https://apigp0905.creinnovations.in/apis/cmf/dress-changer/image/`
|
|||
|
|
*(Sub-endpoints: `/image-with-op/`, `/presets`, `/models`)*
|
|||
|
|
- **Method:** `POST` (for images) / `GET` (for metadata)
|
|||
|
|
- **Content-Type:** `multipart/form-data` (for POST endpoints)
|
|||
|
|
|
|||
|
|
| Field | Type | Required | Default | Description |
|
|||
|
|
| :--- | :--- | :--- | :--- | :--- |
|
|||
|
|
| `original_image` | UploadFile | **Required** | None | Source portrait photo of the person. |
|
|||
|
|
| `secretKey` | string | **Required** | `"abcdef"` | Authentication secret key. Must match `"abcdef"`. |
|
|||
|
|
| `mask_image` | UploadFile | Optional | None | Optional custom clothing mask. If omitted, segmented automatically via port 19527. |
|
|||
|
|
| `category` | string | Optional | `"Woman"` | Wardrobe category (e.g. `"Woman"`, `"Man"`, `"Couple"`). |
|
|||
|
|
| `dress` | string | Optional | None | Preset dress name key (from `/presets`). |
|
|||
|
|
| `prompt` | string | Optional | None | Custom dress description prompt (used if `dress` key is not provided). |
|
|||
|
|
| `model` | string | Optional | None | Inpainting model checkpoint swap (e.g. `"epicrealism"` from `/models`). |
|
|||
|
|
|
|||
|
|
- **Sub-endpoint operations:**
|
|||
|
|
- `/image/`: Active pipeline featuring Sapiens 1B full-body skin protection without ControlNet.
|
|||
|
|
- `/image-with-op/`: Legacy pipeline featuring MediaPipe FaceMesh face protection with OpenPose ControlNet.
|
|||
|
|
- `GET /presets`: Returns catalog of all available preset outfits grouped by category.
|
|||
|
|
- `GET /models`: Returns list of available Stable Diffusion inpainting checkpoint models.
|
|||
|
|
- **Response:**
|
|||
|
|
- `200 OK`: Binary inpaint JPEG image stream (`image/jpeg`) with custom headers:
|
|||
|
|
- `X-Prompt-Used`: Prompt text resolved for generation.
|
|||
|
|
- `X-Model-Used`: Checkpoint name used.
|
|||
|
|
- `X-Inpaint-Backend`: Downstream internal ComfyUI instance URL.
|
|||
|
|
- `400 Bad Request`: `{"detail": "Missing original_image attachment"}` or `{"detail": "Unknown model '<name>'"}`.
|
|||
|
|
- `401 Unauthorized`: `{"detail": "Invalid API key"}`.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 5. SDXL Endpoints
|
|||
|
|
Base URL: `https://apigp0905.creinnovations.in/apis/lxds`
|
|||
|
|
|
|||
|
|
### 5.1 SDXL Text to Image
|
|||
|
|
High-resolution 1024x1024 text-to-image synthesis using Stable Diffusion XL Base + Refiner.
|
|||
|
|
|
|||
|
|
- **URL:** `https://apigp0905.creinnovations.in/apis/lxds/sdxl/text_to_image/image/`
|
|||
|
|
- **Method:** `POST`
|
|||
|
|
- **Content-Type:** `multipart/form-data`
|
|||
|
|
|
|||
|
|
| Field | Type | Required | Default | Description |
|
|||
|
|
| :--- | :--- | :--- | :--- | :--- |
|
|||
|
|
| `prompt` | string | Optional | None | Text prompt describing the target image. |
|
|||
|
|
| `userPrompt` | string | Optional | None | User-supplied custom prompt string. |
|
|||
|
|
| `effectId` | string | Optional | None | Style preset identifier. Accepted alias: `effect_id`. |
|
|||
|
|
| `secretKey` | string | Optional | None | Security access key. Accepted alias: `secretkey`. |
|
|||
|
|
| `width` | integer | Optional | `1024` | Generated image width. |
|
|||
|
|
| `height` | integer | Optional | `1024` | Generated image height. |
|
|||
|
|
| `cfg_scale` | float | Optional | `7.0` | Classifier-free guidance scale. |
|
|||
|
|
| `steps` | integer | Optional | `30` | Number of denoising inference steps. |
|
|||
|
|
| `seed` | integer | Optional | Random | Deterministic generation seed integer. |
|
|||
|
|
| `output_format` | string | Optional | `"png"` | Target output format (`"png"` or `"jpeg"`). |
|
|||
|
|
|
|||
|
|
- **Response:**
|
|||
|
|
- `200 OK`: Binary high-resolution rendered image stream.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 5.2 SDXL Outpainting
|
|||
|
|
Extends image canvas boundaries seamlessly in any direction using SDXL inpainting.
|
|||
|
|
|
|||
|
|
- **URL:** `https://apigp0905.creinnovations.in/apis/lxds/sdxl/outpainting/image/`
|
|||
|
|
- **Method:** `POST`
|
|||
|
|
- **Content-Type:** `multipart/form-data`
|
|||
|
|
|
|||
|
|
| Field | Type | Required | Default | Description |
|
|||
|
|
| :--- | :--- | :--- | :--- | :--- |
|
|||
|
|
| `image0` | UploadFile | **Required** | None | Source center image. Accepted field aliases: `image0`, `image`, `original_image`. |
|
|||
|
|
| `mask` | UploadFile | **Required** | None | Canvas extension binary mask (white pixels represent outpainted regions). Accepted field aliases: `mask`, `mask0`, `mask_image`. |
|
|||
|
|
| `prompt` | string | Optional | None | Prompt describing the extended scene environment. |
|
|||
|
|
| `effectId` | string | Optional | None | Environment style preset ID. |
|
|||
|
|
| `strength` | float | Optional | `0.99` | Inpainting denoising strength (0.0 to 1.0). |
|
|||
|
|
| `width` | integer | Optional | Capped at 720 | Output extended canvas width. |
|
|||
|
|
| `height` | integer | Optional | Capped at 720 | Output extended canvas height. |
|
|||
|
|
| `seed` | integer | Optional | Random | Generation seed. |
|
|||
|
|
| `output_format` | string | Optional | `"png"` | Output image format. |
|
|||
|
|
|
|||
|
|
> [!NOTE]
|
|||
|
|
> Accepts `image0` / `image` / `original_image` for input photo; accepts `mask` / `mask0` / `mask_image` for outpaint mask.
|
|||
|
|
|
|||
|
|
- **Response:**
|
|||
|
|
- `200 OK`: Binary outpainted image stream.
|
|||
|
|
- `400 Bad Request`: `{"detail": "Missing required file: 'image0'"}` or `{"detail": "Missing required file: 'mask'"}`.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 5.3 SDXL Inpaint Object Replacer
|
|||
|
|
Replaces masked objects, props, accessories, or clothing items using SDXL inpainting.
|
|||
|
|
|
|||
|
|
- **URL:** `https://apigp0905.creinnovations.in/apis/lxds/sdxl/inpaint_object_replacer/image/`
|
|||
|
|
- **Method:** `POST`
|
|||
|
|
- **Content-Type:** `multipart/form-data`
|
|||
|
|
|
|||
|
|
| Field | Type | Required | Default | Description |
|
|||
|
|
| :--- | :--- | :--- | :--- | :--- |
|
|||
|
|
| `image0` | UploadFile | **Required** | None | Source photo. Accepted field aliases: `image0`, `image`, `original_image`. |
|
|||
|
|
| `mask_image` | UploadFile | **Required** | None | Inpainting mask indicating object to replace. Accepted field aliases: `mask_image`, `mask`, `mask0`. |
|
|||
|
|
| `colorId` | string | Optional | None | Target replacement object preset ID. |
|
|||
|
|
| `userPrompt` | string | Optional | None | Custom prompt describing the replacement object. |
|
|||
|
|
| `isFromCustomUserPrompt` | boolean | Optional | `False` | Flag to prioritize `userPrompt`. |
|
|||
|
|
| `strength` | float | Optional | `0.99` | Denoising inpaint strength. |
|
|||
|
|
| `width` | integer | Optional | Capped at 720 | Output image width. |
|
|||
|
|
| `height` | integer | Optional | Capped at 720 | Output image height. |
|
|||
|
|
| `seed` | integer | Optional | Random | Generation seed integer. |
|
|||
|
|
| `output_format` | string | Optional | `"png"` | Output format (`"png"` or `"jpeg"`). |
|
|||
|
|
|
|||
|
|
- **Response:**
|
|||
|
|
- `200 OK`: Binary inpaint replaced image stream.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 5.4 SDXL Advanced Dress Pattern
|
|||
|
|
Applies custom fabric patterns, textures, and prints onto existing clothing using SDXL inpainting.
|
|||
|
|
|
|||
|
|
- **URL:** `https://apigp0905.creinnovations.in/apis/lxds/sdxl/advanced_dress_pattern/image/`
|
|||
|
|
- **Method:** `POST`
|
|||
|
|
- **Content-Type:** `multipart/form-data`
|
|||
|
|
|
|||
|
|
| Field | Type | Required | Default | Description |
|
|||
|
|
| :--- | :--- | :--- | :--- | :--- |
|
|||
|
|
| `original_image` | UploadFile | **Required** | None | Input photo of person. Accepted field aliases: `original_image`, `image`, `image0`. |
|
|||
|
|
| `mask_image` | UploadFile | **Required** | None | Clothing mask where pattern should be applied. Accepted field aliases: `mask_image`, `mask`, `mask0`. |
|
|||
|
|
| `effectId` | string | Optional | None | Pattern preset ID. Accepted alias: `effect_id`. |
|
|||
|
|
| `category` | string | Optional | None | Garment style category. |
|
|||
|
|
| `dress` | string | Optional | None | Dress name identifier. |
|
|||
|
|
| `prompt` | string | Optional | None | Text prompt describing fabric pattern/texture. |
|
|||
|
|
| `strength` | float | Optional | `0.99` | Denoising inpaint strength. |
|
|||
|
|
| `width` | integer | Optional | Capped at 720 | Output width. |
|
|||
|
|
| `height` | integer | Optional | Capped at 720 | Output height. |
|
|||
|
|
| `seed` | integer | Optional | Random | Random seed. |
|
|||
|
|
| `output_format` | string | Optional | `"png"` | Image format (`"png"` or `"jpeg"`). |
|
|||
|
|
|
|||
|
|
- **Response:**
|
|||
|
|
- `200 OK`: Binary pattern-transferred image stream.
|
|||
|
|
- `400 Bad Request`: `{"detail": "Missing required file: 'original_image'"}` or `{"detail": "Missing required file: 'mask_image'"}`.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 5.5 SDXL Blend Collage
|
|||
|
|
Blends multiple thematic elements, foreground portraits, and collage backgrounds seamlessly.
|
|||
|
|
|
|||
|
|
- **URL:** `https://apigp0905.creinnovations.in/apis/lxds/sdxl/blend_collage/image/`
|
|||
|
|
- **Method:** `POST`
|
|||
|
|
- **Content-Type:** `multipart/form-data`
|
|||
|
|
|
|||
|
|
| Field | Type | Required | Default | Description |
|
|||
|
|
| :--- | :--- | :--- | :--- | :--- |
|
|||
|
|
| `image0` | UploadFile | **Required** | None | Input subject photo. Accepted field aliases: `image0`, `image`, `original_image`. |
|
|||
|
|
| `effectId` | string | Optional | None | Collage composition preset ID. Accepted alias: `effect_id`. |
|
|||
|
|
| `category` | string | Optional | None | Collage theme category. |
|
|||
|
|
| `gender` | string | Optional | None | Subject gender constraint. |
|
|||
|
|
| `prompt` | string | Optional | None | Descriptive prompt for blending. |
|
|||
|
|
| `userPrompt` | string | Optional | None | User custom prompt override. |
|
|||
|
|
| `secretKey` | string | Optional | None | Authentication key. Accepted alias: `secretkey`. |
|
|||
|
|
| `width` | integer | Optional | Capped at 720 | Canvas width. |
|
|||
|
|
| `height` | integer | Optional | Capped at 720 | Canvas height. |
|
|||
|
|
| `seed` | integer | Optional | Random | Generation seed. |
|
|||
|
|
| `output_format` | string | Optional | `"png"` | Image format (`"png"` or `"jpeg"`). |
|
|||
|
|
|
|||
|
|
- **Response:**
|
|||
|
|
- `200 OK`: Binary blended collage image stream.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 5.6 SDXL Dress Replacer
|
|||
|
|
High-resolution mask-based outfit changer using RealVisXL V5.0 inpainting.
|
|||
|
|
|
|||
|
|
- **URL:** `https://apigp0905.creinnovations.in/apis/lxds/sdxl/dress_replacer/image/`
|
|||
|
|
- **Method:** `POST`
|
|||
|
|
- **Content-Type:** `multipart/form-data`
|
|||
|
|
|
|||
|
|
| Field | Type | Required | Default | Description |
|
|||
|
|
| :--- | :--- | :--- | :--- | :--- |
|
|||
|
|
| `original_image` | UploadFile | **Required** | None | Source portrait of subject. Accepted field aliases: `original_image`, `image`, `image0`. |
|
|||
|
|
| `mask_image` | UploadFile | **Required** | None | Mask of garment area to replace. Accepted field aliases: `mask_image`, `mask`, `mask0`. |
|
|||
|
|
| `effectId` | string | Optional | None | Outfit preset identifier. Accepted alias: `effect_id`. |
|
|||
|
|
| `category` | string | Optional | None | Outfit category. |
|
|||
|
|
| `dress` | string | Optional | None | Preset dress name. |
|
|||
|
|
| `gender` | string | Optional | None | Subject gender (`male` / `female`). |
|
|||
|
|
| `prompt` | string | Optional | None | Detailed garment description prompt. |
|
|||
|
|
| `strength` | float | Optional | `0.99` | Inpainting replacement strength. |
|
|||
|
|
| `secretKey` | string | Optional | None | API security key. Accepted alias: `secretkey`. |
|
|||
|
|
| `width` | integer | Optional | Capped at 720 | Output width. |
|
|||
|
|
| `height` | integer | Optional | Capped at 720 | Output height. |
|
|||
|
|
| `seed` | integer | Optional | Random | Deterministic generation seed. |
|
|||
|
|
| `output_format` | string | Optional | `"png"` | Output image format. |
|
|||
|
|
|
|||
|
|
- **Response:**
|
|||
|
|
- `200 OK`: Binary rendered dress-replacement image stream.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 5.7 SDXL Text to Cartoon
|
|||
|
|
SDXL-powered text and image-guided cartoon character synthesis.
|
|||
|
|
|
|||
|
|
- **URL:** `https://apigp0905.creinnovations.in/apis/lxds/sdxl/text_to_cartoon/image/`
|
|||
|
|
- **Method:** `POST`
|
|||
|
|
- **Content-Type:** `multipart/form-data`
|
|||
|
|
|
|||
|
|
| Field | Type | Required | Default | Description |
|
|||
|
|
| :--- | :--- | :--- | :--- | :--- |
|
|||
|
|
| `prompt` | string | Optional | None | Cartoon style and character prompt. |
|
|||
|
|
| `userPrompt` | string | Optional | None | Custom prompt override. |
|
|||
|
|
| `effectId` | string | Optional | None | Cartoon style preset ID. Accepted alias: `effect_id`. |
|
|||
|
|
| `secretKey` | string | Optional | None | Access key. Accepted alias: `secretkey`. |
|
|||
|
|
| `width` | integer | Optional | `1024` | Image width. |
|
|||
|
|
| `height` | integer | Optional | `1024` | Image height. |
|
|||
|
|
| `cfg_scale` | float | Optional | `7.0` | Guidance scale. |
|
|||
|
|
| `steps` | integer | Optional | `30` | Inference steps. |
|
|||
|
|
| `seed` | integer | Optional | Random | Generation seed. |
|
|||
|
|
| `output_format` | string | Optional | `"png"` | Output format. |
|
|||
|
|
|
|||
|
|
- **Response:**
|
|||
|
|
- `200 OK`: Binary high-resolution cartoon image stream.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 5.8 SDXL Text to Caricature
|
|||
|
|
SDXL-powered synthesis of whimsical caricature illustrations with exaggerated proportions.
|
|||
|
|
|
|||
|
|
- **URL:** `https://apigp0905.creinnovations.in/apis/lxds/sdxl/text_to_caricature/image/`
|
|||
|
|
- **Method:** `POST`
|
|||
|
|
- **Content-Type:** `multipart/form-data`
|
|||
|
|
|
|||
|
|
| Field | Type | Required | Default | Description |
|
|||
|
|
| :--- | :--- | :--- | :--- | :--- |
|
|||
|
|
| `prompt` | string | Optional | None | Caricature scene and subject prompt. |
|
|||
|
|
| `userPrompt` | string | Optional | None | Custom user prompt override. |
|
|||
|
|
| `effectId` | string | Optional | None | Caricature style preset ID. Accepted alias: `effect_id`. |
|
|||
|
|
| `secretKey` | string | Optional | None | Authentication key. Accepted alias: `secretkey`. |
|
|||
|
|
| `width` | integer | Optional | `1024` | Image width. |
|
|||
|
|
| `height` | integer | Optional | `1024` | Image height. |
|
|||
|
|
| `cfg_scale` | float | Optional | `7.0` | Guidance scale. |
|
|||
|
|
| `steps` | integer | Optional | `30` | Inference steps. |
|
|||
|
|
| `seed` | integer | Optional | Random | Generation seed. |
|
|||
|
|
| `output_format` | string | Optional | `"png"` | Output format. |
|
|||
|
|
|
|||
|
|
- **Response:**
|
|||
|
|
- `200 OK`: Binary high-resolution caricature image stream.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 5.9 SDXL Expressions Changer
|
|||
|
|
Transforms facial expressions (smile, surprised, wink, laughing) while retaining facial identity through automated face swap and GFPGAN face restoration.
|
|||
|
|
|
|||
|
|
- **URL:** `https://apigp0905.creinnovations.in/apis/lxds/sdxl/expressions_changer/image/`
|
|||
|
|
- **Method:** `POST`
|
|||
|
|
- **Content-Type:** `multipart/form-data`
|
|||
|
|
|
|||
|
|
| Field | Type | Required | Default | Description |
|
|||
|
|
| :--- | :--- | :--- | :--- | :--- |
|
|||
|
|
| `original_image` | UploadFile | **Required** | None | Source portrait photo. Accepted field aliases: `original_image`, `image`, `image0`. |
|
|||
|
|
| `mask_image` | UploadFile | Optional | None | Optional face mask. If omitted, automatically generated via internal MediaPipe FaceLandmarker convex hull. Accepted field aliases: `mask_image`, `mask`, `mask0`. |
|
|||
|
|
| `expression` | string | Optional | None | Target facial expression preset. |
|
|||
|
|
| `effectId` | string | Optional | None | Expression preset ID. Accepted alias: `effect_id`. |
|
|||
|
|
| `category` | string | Optional | None | Category filter. |
|
|||
|
|
| `dress` | string | Optional | None | Optional dress identifier. |
|
|||
|
|
| `prompt` | string | Optional | None | Prompt describing facial expression. |
|
|||
|
|
| `strength` | float | Optional | `0.85` | Denoising inpaint strength. |
|
|||
|
|
| `width` | integer | Optional | Capped at 720 | Output width. |
|
|||
|
|
| `height` | integer | Optional | Capped at 720 | Output height. |
|
|||
|
|
| `seed` | integer | Optional | Random | Deterministic seed. |
|
|||
|
|
| `output_format` | string | Optional | `"png"` | Output image format. |
|
|||
|
|
|
|||
|
|
> [!NOTE]
|
|||
|
|
> Accepts `original_image` / `image` / `image0`. `mask_image` is optional and automatically constructed if omitted. Result is enhanced through face identity restoration and GFPGAN.
|
|||
|
|
|
|||
|
|
- **Response:**
|
|||
|
|
- `200 OK`: Binary facial expression modified image stream (`image/png`).
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 6. Other Endpoints
|
|||
|
|
Base URL: `https://apigp0006.creinnovations.in/apis/mlm`
|
|||
|
|
|
|||
|
|
### 6.1 Feedback Submission (General)
|
|||
|
|
Standard endpoint for collecting application feedback, user ratings, and feature analytics.
|
|||
|
|
|
|||
|
|
- **URL:** `https://apigp0006.creinnovations.in/apis/mlm/feedback/submit/`
|
|||
|
|
- **Method:** `POST`
|
|||
|
|
- **Content-Type:** `multipart/form-data` or `application/x-www-form-urlencoded`
|
|||
|
|
|
|||
|
|
| Field | Type | Required | Default | Description |
|
|||
|
|
| :--- | :--- | :--- | :--- | :--- |
|
|||
|
|
| `feedback` | string | **Required** | None | User sentiment rating (`"like"` or `"dislike"`). |
|
|||
|
|
| `feedback_content` | string | Optional | None | Text comments or descriptive feedback. |
|
|||
|
|
| `platform` | string | Optional | None | Platform identifier (`"ios"`, `"android"`, `"web"`). |
|
|||
|
|
| `developer_account` | string | Optional | None | Developer account identifier. |
|
|||
|
|
| `app_name` | string | Optional | None | Application name. |
|
|||
|
|
| `bundle_id` | string | Optional | None | iOS bundle identifier. |
|
|||
|
|
| `package_name` | string | Optional | None | Android package name. |
|
|||
|
|
| `version` | string | Optional | None | App version string. |
|
|||
|
|
| `feature` | string | Optional | None | Rated feature / API name. |
|
|||
|
|
| `is_paid_user` | string | Optional | None | Subscription flag (`"true"` / `"false"`). |
|
|||
|
|
|
|||
|
|
- **Response:**
|
|||
|
|
- `201 Created`: `{"message": "Feedback submitted successfully", "id": 123}`.
|
|||
|
|
- `400 Bad Request`: `{"status": "error", "message": "Mandatory parameter 'feedback' must be 'like' or 'dislike'."}`.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 6.2 Telemetry Reports Data Submission
|
|||
|
|
Submits runtime error logs, network failure traces, request payloads, and debug image attachments.
|
|||
|
|
|
|||
|
|
- **URL:** `https://apigp0006.creinnovations.in/apis/mlm/reports/data/`
|
|||
|
|
- **Method:** `POST`
|
|||
|
|
- **Content-Type:** `multipart/form-data`
|
|||
|
|
|
|||
|
|
| Field | Type | Required | Default | Description |
|
|||
|
|
| :--- | :--- | :--- | :--- | :--- |
|
|||
|
|
| `api_url` | string | Optional | None | Target API URL that failed or threw an exception. |
|
|||
|
|
| `feature` | string | Optional | None | The feature being executed. |
|
|||
|
|
| `rqst_body` | string | Optional | None | Request payload JSON or raw string that caused the issue. |
|
|||
|
|
| `user_message` | string | Optional | None | User or error description text. |
|
|||
|
|
| `app_name` | string | Optional | None | Client application name. |
|
|||
|
|
| `version` | string | Optional | None | Client app version. |
|
|||
|
|
| `platform` | string | Optional | None | Platform name (`ios`, `android`, etc.). |
|
|||
|
|
| `bundle_id` | string | Optional | None | iOS bundle ID (routed if platform is iOS). |
|
|||
|
|
| `package_name` | string | Optional | None | Android package name (routed if platform is Android). |
|
|||
|
|
| `dev_account` | string | Optional | None | Developer account string. |
|
|||
|
|
| `ispaiduser` | string | Optional | None | Paid subscriber status. |
|
|||
|
|
| `image_init` | UploadFile | Optional | None | Initial input image attachment before processing. |
|
|||
|
|
| `image_res` | UploadFile | Optional | None | Resulting output or corrupted image attachment. |
|
|||
|
|
|
|||
|
|
- **Response:**
|
|||
|
|
- `201 Created`: `{"message": "Report submitted successfully", "id": 789}`.
|
|||
|
|
- `400 Bad Request`: `{"status": "error", "message": "<reason>"}`.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 7. Health Checks
|
|||
|
|
|
|||
|
|
### 7.1 Backend Microservice Health Probe
|
|||
|
|
Primary liveness and operational readiness health probe for the ML Models backend engine.
|
|||
|
|
|
|||
|
|
- **URL:** `http://localhost:5925/health`
|
|||
|
|
*(Also accessible via Nginx proxy at: `https://apigp0006.creinnovations.in/apis/mlm/health`)*
|
|||
|
|
- **Method:** `GET`
|
|||
|
|
- **Content-Type:** `application/json`
|
|||
|
|
|
|||
|
|
| Field | Type | Required | Default | Description |
|
|||
|
|
| :--- | :--- | :--- | :--- | :--- |
|
|||
|
|
| *None* | — | — | — | No query or body parameters required. |
|
|||
|
|
|
|||
|
|
- **Response:**
|
|||
|
|
- `200 OK`: `{"status": "ok", "app": "ML Models FastAPI Backend"}`.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 7.2 FLUX Kontext Gateway Health
|
|||
|
|
Liveness probe for the FLUX Kontext gateway server.
|
|||
|
|
|
|||
|
|
- **URL:** `https://apigp0006.creinnovations.in/apis/flxk/`
|
|||
|
|
- **Method:** `GET`
|
|||
|
|
- **Content-Type:** `application/json`
|
|||
|
|
|
|||
|
|
| Field | Type | Required | Default | Description |
|
|||
|
|
| :--- | :--- | :--- | :--- | :--- |
|
|||
|
|
| *None* | — | — | — | No query or body parameters required. |
|
|||
|
|
|
|||
|
|
- **Response:**
|
|||
|
|
- `200 OK`: `{"message": "Flux Kontext API is running"}`.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## Summary of Verification & Status Anomalies
|
|||
|
|
|
|||
|
|
- **Total Documented Endpoints:** 70 endpoints (covering all requested service groups).
|
|||
|
|
- **Disk Verified Effect Encodings:**
|
|||
|
|
- `flux_fill_hair_color_changer`: 36 effects (`C1`–`C14`, `G1`–`G12`, `HL2`–`HL11`) across 72 `.pt` files.
|
|||
|
|
- `flux_fill_eye_changer`: 25 effects (`E1`, `E2`, `E5`, `E6`, `E9`, `GM1`–`GM10`, `GW1`–`GW10`) across 50 `.pt` files.
|
|||
|
|
- `flux_fill_couple_dress_changer`: 620 effects (595 standard couple encodings + 25 couple wedding outfits) across 1,240 `.pt` files.
|
|||
|
|
- `flux_fill_dress_changer`: 1,676 effects across 3,352 `.pt` files.
|
|||
|
|
- `flux/headshots`: 80 effects (40 female `female_Bg1`–`female_Bg40`, 40 male `male_Bg1`–`male_Bg40`) across 160 `.pt` files.
|
|||
|
|
- `flux/head_cartoon_effect`: 2 effects (`Female_C12`, `Male_C12`) across 4 `.pt` files.
|
|||
|
|
- `flux/modified_head_cartoon_effects`: 4 effects (`Female_C7`, `Female_C8`, `Male_C7`, `Male_C8`) across 8 `.pt` files.
|
|||
|
|
- `flux/comic_cover`: 26 effects (13 female `female_ComicCover1`–`female_ComicCover13`, 13 male `male_ComicCover1`–`male_ComicCover13`) across 52 `.pt` files.
|
|||
|
|
- `flux/hairstyles`: 60 effects (30 female `female_HF1`–`female_HF30`, 30 male `male_HM1`–`male_HM30`) across 120 `.pt` files.
|
|||
|
|
- `flux/sculptures`: 26 effects (`E1`–`E26`) across 52 `.pt` files.
|
|||
|
|
- `flux/silhouette`: 150 effects (50 couple `couple_E1`–`couple_E50`, 50 men `men_E1`–`men_E50`, 50 women `women_E1`–`women_E50`) across 300 `.pt` files.
|
|||
|
|
- `flux/glasses_maker`: 45 effects (25 men `EM1`–`EM25`, 20 women `EW1`–`EW20`) across 90 `.pt` files.
|
|||
|
|
- `flux/cartoon`: 262 effects (215 in `encodings` [`C1`–`C70`, `E1`–`E120`, `T1`–`T25`] + 47 in `new_cartoon_effects` [`E251`–`E297`]) across 524 `.pt` files.
|
|||
|
|
- `flux/background_with_depth`: 193 effects across aesthetic, birthday, sports, travel, and nature categories across 386 `.pt` files.
|
|||
|
|
- `flux/vintage_look`: 131 effects (68 female `F1`–`F68`, 63 male `M1`–`M63`) across 262 `.pt` files.
|
|||
|
|
- **Source Code Anomalies / NOT FOUND:**
|
|||
|
|
- `cartoon_effects/image/` with prefix `/cartoon_effects`: **NOT FOUND** in the FastAPI codebase. Active cartoon conversion is handled via `cartoonify_caricature_effects/image/` (CartoonGAN) and `stable_diffusion_new_cartoon_effects/image/`.
|