Meshy 7 Retexture

{
  "model_id": "fal-ai/meshy/retexture"
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fmeshy%2Fretexture",
  "title": "Meshy 7 Retexture generation request",
  "description": "Request body accepted by POST /api/v1/generate for fal-ai/meshy/retexture.",
  "type": "object",
  "properties": {
    "model_id": {
      "type": "string",
      "const": "fal-ai/meshy/retexture",
      "description": "ArtEmotion model identifier."
    },
    "extra": {
      "type": "object",
      "additionalProperties": true,
      "description": "Model-specific settings may also be nested here."
    },
    "max_credits": {
      "type": "number",
      "minimum": 1,
      "description": "Reject before submission if the estimated list price exceeds this cap."
    },
    "webhook_url": {
      "type": "string",
      "format": "uri",
      "maxLength": 2048
    },
    "webhook_secret": {
      "type": "string",
      "maxLength": 512
    },
    "folder_id": {
      "type": "string"
    },
    "prompt": {
      "type": "string"
    },
    "input_task_id": {
      "title": "Input Task ID",
      "description": "Source Meshy task ID — auto-filled when retexturing a Meshy-generated model. Takes priority over Model URL.",
      "type": "string"
    },
    "model_url": {
      "title": "Model URL",
      "description": "URL of the 3D mesh to retexture. Supports GLB, GLTF, OBJ, FBX, STL — must be a publicly accessible URL. Used when no Input Task ID is available.",
      "type": "string"
    },
    "image_style_url": {
      "title": "Single Style Image",
      "description": "Use one JPG or PNG as the texture style. An image style takes priority over the text prompt.",
      "type": "string"
    },
    "multiview_front_url": {
      "title": "Multi-View Style — Front",
      "description": "Primary front style view. Adding any multi-view image makes the multi-view set the exclusive style input.",
      "type": "string"
    },
    "multiview_left_url": {
      "title": "Multi-View Style — View 2",
      "description": "Optional second view of the same object.",
      "type": "string"
    },
    "multiview_back_url": {
      "title": "Multi-View Style — View 3",
      "description": "Optional third view of the same object.",
      "type": "string"
    },
    "multiview_right_url": {
      "title": "Multi-View Style — View 4",
      "description": "Optional fourth view of the same object.",
      "type": "string"
    },
    "ai_model": {
      "title": "AI Model",
      "description": "Meshy 7 is required for multi-view style images.",
      "default": "meshy-7",
      "type": "string",
      "enum": [
        "meshy-7",
        "latest",
        "meshy-6",
        "meshy-5"
      ]
    },
    "enable_pbr": {
      "title": "Enable PBR",
      "description": "Generate metallic, roughness, and normal maps. Meshy 7 does not produce an emission map.",
      "default": false,
      "type": "boolean"
    },
    "texture_resolution": {
      "title": "Texture Resolution",
      "description": "Base-color texture resolution. 8K has a higher generation price.",
      "default": "2k",
      "type": "string",
      "enum": [
        "2k",
        "4k",
        "8k"
      ]
    },
    "remove_lighting": {
      "title": "Remove Lighting",
      "description": "Remove baked highlights and shadows. Meshy currently supports this option only with Meshy 6.",
      "default": true,
      "type": "boolean"
    },
    "enable_original_uv": {
      "title": "Preserve Original UVs",
      "description": "Use the existing UV map from the model instead of generating new UVs.",
      "default": false,
      "type": "boolean"
    },
    "alpha_thumbnail": {
      "title": "Alpha Thumbnail",
      "description": "Generate a thumbnail image with a transparent background.",
      "default": false,
      "type": "boolean"
    }
  },
  "required": [
    "model_id"
  ],
  "additionalProperties": false
}