renyurui / controllable-person-synthesis

Human pose manipulation for fashion

Cold

Public
3.6K runs
T4
GitHub
Paper
License

Run with an API

Playground API Examples README Versions

Input

Run this model in Node.js with one line of code:

npx create-replicate --model=renyurui/controllable-person-synthesis

or set up a project from scratch

Install Replicate’s Node.js client library:

npm install replicate

Set the REPLICATE_API_TOKEN environment variable:

export REPLICATE_API_TOKEN=<paste-your-token-here>

Find your API token in your account settings.

Import and set up the client:

import Replicate from "replicate";

const replicate = new Replicate({
  auth: process.env.REPLICATE_API_TOKEN,
});

Run renyurui/controllable-person-synthesis using Replicate’s API. Check out the model's schema for an overview of inputs and outputs.

const output = await replicate.run(
  "renyurui/controllable-person-synthesis:f2a5c4525dcd2868f7db9013e0ad82f82992ab5ce7418d6cc414e0ceca5861ec",
  {
    input: {
      seed: 729973005,
      desired_pose: "https://replicate.delivery/mgxm/6be92c88-c882-48de-ac93-153cc87e2ae3/fashionWOMENBlouses_Shirtsid0000121702_1front.txt",
      reference_image: "https://replicate.delivery/mgxm/f7be1e5b-d1f8-4ab9-83c3-fa20ab7aa249/fashionWOMENDressesid0000628801_1front.jpg"
    }
  }
);
console.log(output);

To learn more, take a look at the guide on getting started with Node.js.

Install Replicate’s Python client library:

pip install replicate

Set the REPLICATE_API_TOKEN environment variable:

export REPLICATE_API_TOKEN=<paste-your-token-here>

Find your API token in your account settings.

Import the client:

import replicate

Run renyurui/controllable-person-synthesis using Replicate’s API. Check out the model's schema for an overview of inputs and outputs.

output = replicate.run(
    "renyurui/controllable-person-synthesis:f2a5c4525dcd2868f7db9013e0ad82f82992ab5ce7418d6cc414e0ceca5861ec",
    input={
        "seed": 729973005,
        "desired_pose": "https://replicate.delivery/mgxm/6be92c88-c882-48de-ac93-153cc87e2ae3/fashionWOMENBlouses_Shirtsid0000121702_1front.txt",
        "reference_image": "https://replicate.delivery/mgxm/f7be1e5b-d1f8-4ab9-83c3-fa20ab7aa249/fashionWOMENDressesid0000628801_1front.jpg"
    }
)
print(output)

To learn more, take a look at the guide on getting started with Python.

Set the REPLICATE_API_TOKEN environment variable:

export REPLICATE_API_TOKEN=<paste-your-token-here>

Find your API token in your account settings.

Run renyurui/controllable-person-synthesis using Replicate’s API. Check out the model's schema for an overview of inputs and outputs.

curl -s -X POST \
  -H "Authorization: Bearer $REPLICATE_API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Prefer: wait" \
  -d $'{
    "version": "f2a5c4525dcd2868f7db9013e0ad82f82992ab5ce7418d6cc414e0ceca5861ec",
    "input": {
      "seed": 729973005,
      "desired_pose": "https://replicate.delivery/mgxm/6be92c88-c882-48de-ac93-153cc87e2ae3/fashionWOMENBlouses_Shirtsid0000121702_1front.txt",
      "reference_image": "https://replicate.delivery/mgxm/f7be1e5b-d1f8-4ab9-83c3-fa20ab7aa249/fashionWOMENDressesid0000628801_1front.jpg"
    }
  }' \
  https://api.replicate.com/v1/predictions

To learn more, take a look at Replicate’s HTTP API reference docs.

Output

result

target_skeleton

Generated in

2.0 seconds

Tweak itReport

Examples

View more examples

Run time and cost

This model costs approximately $0.00042 to run on Replicate, or 2380 runs per $1, but this varies depending on your inputs. It is also open source and you can run it on your own computer with Docker.

This model runs on Nvidia T4 GPU hardware. Predictions typically complete within 2 seconds. The predict time for this model varies significantly based on the inputs.

Readme

ArXiv | Get Start

Neural-Texture-Extraction-Distribution

The PyTorch implementation for our paper “Neural Texture Extraction and Distribution for Controllable Person Image Synthesis” (CVPR2022 Oral)

We propose a Neural-Texture-Extraction-Distribution operation for controllable person image synthesis. Our model can be used to control the pose and appearance of a reference image:

NOTE: This demo only supports pose control. For appearance control, please see the original repo to run models locally.

Pose Control

Usage

The model takes in as input a reference image, as well a .txt file containing a 18x2 array of OpenPose keypoints. See Pose Output Format: COCO here.

Ensure that the reference image has a clean, monocolor background to optimize feature extraction and prevent artifacts. Also note that the model is trained on a limited range of demographics, which may cause potential artifacts.

The model outputs a visualization of the target skeleton, as well as the reference model manipulated to fit the target skeleton pose.