zylim0702/perspective_net

Public

11 runs

Run zylim0702/perspective_net with an API

Use one of our client libraries to get started quickly. Clicking on a library will take you to the Playground tab where you can tweak different inputs, see the results, and copy the corresponding code to use in your own project.

Input schema

The fields you can use to run this model with an API. If you don't give a value for a field its default value will be used.

Field	Type	Default value	Description
input_image	string		Input image to transform into 4 views
num_inference_steps	integer	50 Min: 10 Max: 200	Number of inference steps (10-200, higher = better quality but slower)
cfg_scale	number	2.5 Min: 1 Max: 10	CFG scale (1.0-10.0, higher = follows prompt more closely)
seed	integer	42	Random seed for reproducible results (set to -1 for random)
maintain_aspect_ratio	boolean	True	Preserve original image aspect ratio
target_size	integer	1024 Min: 512 Max: 2048	Target size for longer dimension when maintaining ratio (512-2048)
custom_pose	string		Custom pose description (e.g., 'heroic stance', 'sitting', 'fighting pose')
pose_reference_image	string		Reference image to extract pose from (overrides custom_pose)
clothing_type	string		Type of clothing (e.g., 'armor', 'dress', 'suit', 'casual clothes')
clothing_color	string		Clothing colors (e.g., 'red and blue', 'gold and silver')
clothing_pattern	string		Clothing pattern (e.g., 'stripes', 'geometric', 'plain')
clothing_material	string		Clothing material (e.g., 'metal', 'fabric', 'leather')
accessories	string		Accessories to add (comma-separated, e.g., 'hat, glasses', 'crown, earrings')
holding_objects	string		Objects to hold (comma-separated, e.g., 'sword, shield', 'magic wand')
hair_style	string		Hair style (e.g., 'long', 'short', 'curly', 'ponytail')
hair_color	string		Hair color (e.g., 'blonde', 'black', 'red', 'blue')
facial_expression	string		Facial expression (e.g., 'smiling', 'serious', 'angry')
eye_color	string		Eye color (e.g., 'blue', 'brown', 'green', 'red')
body_type	string		Body type (e.g., 'muscular', 'slim', 'tall', 'short')
art_style	None	3d_object	Art style preset
art_style_custom	string		Custom art style description (only used if art_style='custom')
additional_prompt	string		Additional details to add
negative_prompt_extra	string		Things you specifically don't want
printing_friendly	boolean	True	Optimize for 3D printing
detail_level	None	high	Detail level
consistency_threshold	number	0.7 Max: 1	Minimum consistency score required (0.0-1.0, lower = more retries)
max_retries	integer	3 Min: 1 Max: 5	Maximum number of retry attempts for low consistency
view_count	None	4_views	Number of views to generate (1 view = front only, 4 views = all angles)
body_style	None	same_as_input	Body style (same as input image or full body view)

{
  "type": "object",
  "title": "Input",
  "required": [
    "input_image"
  ],
  "properties": {
    "seed": {
      "type": "integer",
      "title": "Seed",
      "default": 42,
      "x-order": 3,
      "description": "Random seed for reproducible results (set to -1 for random)"
    },
    "art_style": {
      "enum": [
        "3d_object",
        "3d_cartoon",
        "anime",
        "realistic",
        "stylized",
        "chibi",
        "steampunk",
        "cyberpunk",
        "fantasy",
        "sci_fi",
        "big_eyes",
        "small_eyes",
        "round_face",
        "long_face",
        "exaggerated_features",
        "3d_cartoon_big_head",
        "3d_cartoon_small_head",
        "3d_cartoon_tiny_body",
        "3d_cartoon_heroic_body",
        "3d_cartoon_stick_body",
        "3d_cartoon_round_body",
        "custom"
      ],
      "type": "string",
      "title": "art_style",
      "description": "Art style preset",
      "default": "3d_object",
      "x-order": 19
    },
    "body_type": {
      "type": "string",
      "title": "Body Type",
      "default": "",
      "x-order": 18,
      "description": "Body type (e.g., 'muscular', 'slim', 'tall', 'short')"
    },
    "cfg_scale": {
      "type": "number",
      "title": "Cfg Scale",
      "default": 2.5,
      "maximum": 10,
      "minimum": 1,
      "x-order": 2,
      "description": "CFG scale (1.0-10.0, higher = follows prompt more closely)"
    },
    "eye_color": {
      "type": "string",
      "title": "Eye Color",
      "default": "",
      "x-order": 17,
      "description": "Eye color (e.g., 'blue', 'brown', 'green', 'red')"
    },
    "body_style": {
      "enum": [
        "same_as_input",
        "full_body"
      ],
      "type": "string",
      "title": "body_style",
      "description": "Body style (same as input image or full body view)",
      "default": "same_as_input",
      "x-order": 28
    },
    "hair_color": {
      "type": "string",
      "title": "Hair Color",
      "default": "",
      "x-order": 15,
      "description": "Hair color (e.g., 'blonde', 'black', 'red', 'blue')"
    },
    "hair_style": {
      "type": "string",
      "title": "Hair Style",
      "default": "",
      "x-order": 14,
      "description": "Hair style (e.g., 'long', 'short', 'curly', 'ponytail')"
    },
    "view_count": {
      "enum": [
        "1_view",
        "4_views"
      ],
      "type": "string",
      "title": "view_count",
      "description": "Number of views to generate (1 view = front only, 4 views = all angles)",
      "default": "4_views",
      "x-order": 27
    },
    "accessories": {
      "type": "string",
      "title": "Accessories",
      "default": "",
      "x-order": 12,
      "description": "Accessories to add (comma-separated, e.g., 'hat, glasses', 'crown, earrings')"
    },
    "custom_pose": {
      "type": "string",
      "title": "Custom Pose",
      "default": "",
      "x-order": 6,
      "description": "Custom pose description (e.g., 'heroic stance', 'sitting', 'fighting pose')"
    },
    "input_image": {
      "type": "string",
      "title": "Input Image",
      "format": "uri",
      "x-order": 0,
      "description": "Input image to transform into 4 views"
    },
    "max_retries": {
      "type": "integer",
      "title": "Max Retries",
      "default": 3,
      "maximum": 5,
      "minimum": 1,
      "x-order": 26,
      "description": "Maximum number of retry attempts for low consistency"
    },
    "target_size": {
      "type": "integer",
      "title": "Target Size",
      "default": 1024,
      "maximum": 2048,
      "minimum": 512,
      "x-order": 5,
      "description": "Target size for longer dimension when maintaining ratio (512-2048)"
    },
    "detail_level": {
      "enum": [
        "low",
        "medium",
        "high"
      ],
      "type": "string",
      "title": "detail_level",
      "description": "Detail level",
      "default": "high",
      "x-order": 24
    },
    "clothing_type": {
      "type": "string",
      "title": "Clothing Type",
      "default": "",
      "x-order": 8,
      "description": "Type of clothing (e.g., 'armor', 'dress', 'suit', 'casual clothes')"
    },
    "clothing_color": {
      "type": "string",
      "title": "Clothing Color",
      "default": "",
      "x-order": 9,
      "description": "Clothing colors (e.g., 'red and blue', 'gold and silver')"
    },
    "holding_objects": {
      "type": "string",
      "title": "Holding Objects",
      "default": "",
      "x-order": 13,
      "description": "Objects to hold (comma-separated, e.g., 'sword, shield', 'magic wand')"
    },
    "art_style_custom": {
      "type": "string",
      "title": "Art Style Custom",
      "default": "",
      "x-order": 20,
      "description": "Custom art style description (only used if art_style='custom')"
    },
    "clothing_pattern": {
      "type": "string",
      "title": "Clothing Pattern",
      "default": "",
      "x-order": 10,
      "description": "Clothing pattern (e.g., 'stripes', 'geometric', 'plain')"
    },
    "additional_prompt": {
      "type": "string",
      "title": "Additional Prompt",
      "default": "",
      "x-order": 21,
      "description": "Additional details to add"
    },
    "clothing_material": {
      "type": "string",
      "title": "Clothing Material",
      "default": "",
      "x-order": 11,
      "description": "Clothing material (e.g., 'metal', 'fabric', 'leather')"
    },
    "facial_expression": {
      "type": "string",
      "title": "Facial Expression",
      "default": "",
      "x-order": 16,
      "description": "Facial expression (e.g., 'smiling', 'serious', 'angry')"
    },
    "printing_friendly": {
      "type": "boolean",
      "title": "Printing Friendly",
      "default": true,
      "x-order": 23,
      "description": "Optimize for 3D printing"
    },
    "num_inference_steps": {
      "type": "integer",
      "title": "Num Inference Steps",
      "default": 50,
      "maximum": 200,
      "minimum": 10,
      "x-order": 1,
      "description": "Number of inference steps (10-200, higher = better quality but slower)"
    },
    "pose_reference_image": {
      "type": "string",
      "title": "Pose Reference Image",
      "format": "uri",
      "x-order": 7,
      "nullable": true,
      "description": "Reference image to extract pose from (overrides custom_pose)"
    },
    "consistency_threshold": {
      "type": "number",
      "title": "Consistency Threshold",
      "default": 0.7,
      "maximum": 1,
      "minimum": 0,
      "x-order": 25,
      "description": "Minimum consistency score required (0.0-1.0, lower = more retries)"
    },
    "maintain_aspect_ratio": {
      "type": "boolean",
      "title": "Maintain Aspect Ratio",
      "default": true,
      "x-order": 4,
      "description": "Preserve original image aspect ratio"
    },
    "negative_prompt_extra": {
      "type": "string",
      "title": "Negative Prompt Extra",
      "default": "",
      "x-order": 22,
      "description": "Things you specifically don't want"
    }
  }
}

Output schema

The shape of the response you’ll get when you run this model with an API.

Schema

{
  "type": "array",
  "items": {
    "type": "string",
    "format": "uri"
  },
  "title": "Output"
}