---
title: "hf-soul-image-to-image"
method: POST
path: "/api/v1/hf-soul-image-to-image"
tags: ["Image: Enhance"]
---

# hf-soul-image-to-image

`POST /api/v1/hf-soul-image-to-image`

## Request

- Base URL: `https://api.muapi.ai`
- URL: `https://api.muapi.ai/api/v1/hf-soul-image-to-image`
- Auth: one of:
  - API key in header `x-api-key`
  - OAuth 2 (client credentials, token URL `https://api.muapi.ai/oauth/token`)

Transform images using HF Soul style transfer. Input: image, style prompt. Output: image. Use for: artistic style transfer.

## Query parameters

- `webhook` string
- `team_id` integer, nullable

## Headers

- `x-api-key` string
- `x-embed-code` string, nullable
- `x-agent-embed-code` string, nullable
- `x-whitelabel-studio` string, nullable
- `authorization` string, nullable

## Request body

- HfSoulImageRequest
  - `prompt` string, required
  - `image_url` string, uri, required
  - `webhook_url` string, uri, nullable
  - `style` 'Creatures' | 'Medieval' | 'Spotlight' | 'Giant People' | 'Red balloon' | 'green editorial' | 'Subway' | 'Library' | 'Realistic' | 'DigitalCam' | 'Grillz Selfie' | 'Bleached Brows' | 'Sitting on the Street' | 'Crossing the street' | 'Angel Wings' | 'Duplicate' | 'cocktail' | 'Quiet luxury' | 'Fireproof' | 'Elevator Mirror' | '360 cam' | 'Glitch' | 'FashionShow' | 'PixeletedFace' | 'Sunbathing' | 'Paper Face' | '90s Grain' | 'Geominimal' | 'Foggy Morning' | 'Overexposed' | 'Sunset beach' | 'Giant Accessory' | 'RingSelfie' | 'Street view' | '90’s Editorial' | 'Rhyme & blues' | '2000s Cam' | 'CCTV' | '0.5 Outfit' | 'Amalfi Summer' | 'Bimbocore' | '0.5 Selfie' | 'Sand' | 'Vintage PhotoBooth' | 'afterparty cam' | 'Babydoll MakeUp' | 'Through The Glass' | 'Gallery' | 'Eating Food' | 'Swords Hill' | 'Office beach' | 'Help It's Too Big' | 'Japandi' | 'iPhone' | 'Gorpcore' | 'Indie sleaze' | 'Fairycore' | 'Tumblr' | 'Avant-garde' | 'HairClips' | 'birthday mess' | 'Clouded Dream' | 'Y2K Posters' | 'tokyo drift' | 'Object Makeup' | 'Graffiti' | 'Sunburnt' | 'hallway noir' | '2000s Fashion' | 'Night Beach' | 'Movie' | 'Long legs' | '7\' | 'General' | 'Nail Check' | 'Coquette core' | 'Mixed Media' | 'Selfcare' | 'Grunge' | 'Double take' | '505room' | 'Flight mode' | 'Escalator' | 'burgundy suit' | 'Fisheye' | 'Shoe Check' | 'Rainy Day' | 'Mt. Fuji' | 'Sea breeze' | 'Invertethereal' | 'Y2K' | 'Tokyo Streetstyle' | 'chrome exit' | 'Night rider' | 'Artwork' | 'Glazed doll skin makeup' | 'mount view' | '2049' | 'blackout fit' | 'Bike mafia' | 'static glow' | 'Nicotine glow' | 'brick shade' | 'dmv' | 'Fish-eye twin' | 'It’s french'
  - `aspect_ratio` '16:9' | '9:16' | '1:1' | '4:3' | '3:4' | '4:5' | '5:4' | '21:9' | '9:21'
  - `strength` number
  - `quality` 'medium' | 'high'

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/muapi/apis/muapi-api.md) · [All operations](https://skmtc.dev/muapi/apis/muapi-api/llms.txt) · [OpenAPI document](https://skmtc.dev/muapi/apis/muapi-api/revisions/e4b7374381e5?raw)