easyrender

Remote image-to-3D MCP: preview a product photo, then build a textured GLB with account credits.

Sollte ich dies verwenden

Qualität und Sicherheit

A
Qualität der Beschreibung
100%
Vollständigkeit des Schemas
78%
Qualität der Benennung
96%
Risiko der Vergiftung
100%
Übereinstimmung der Berechtigungen
100%
Einhaltung des Protokolls
100%

Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.

Kontextkosten

~7,691Tokens (Tool-Definitionen)
~4.8 KBTypische Antwortgröße
Erhebliche Auswirkung auf die Aufmerksamkeit (6.01% von 128k Kontext)

Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.

Installieren

Installation mit einem Klick

Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:

{
  "mcpServers": {
    "easyrender": {
      "url": "https://easyrender.ai/api/mcp"
    }
  }
}

Remote-Endpunkte

https://easyrender.ai/api/mcpstreamable-http

Was es kann

Tool-Inventar

Tools (16)

🟢 Nur lesen🟡 Schreiben🔴 Löschen⚪ Unbekannt
🟡create_render(upload_id, image_url, image_base64, content_type, prompt, ...)

Create a private preview from one product photo. Supply exactly one upload_id, image_url or image_base64. Upload larger local photos with authenticated POST /api/uploads (multipart image), then pass its id. Inline images: at most 3129344 decoded bytes. URL/upload photos: up to 4 MiB. Reuse idempotency_key after a timeout. Poll get_render, inspect hasSheet, then approve pending_credits before render_3d.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "upload_id": {
      "description": "Owner-scoped id from authenticated POST /api/uploads; expires after one hour",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "image_url": {
      "description": "Public HTTPS JPEG, PNG or WebP URL; up to 4 MiB",
      "type": "string",
      "maxLength": 4096,
      "format": "uri"
    },
    "image_base64": {
      "description": "Canonical base64, at most 3129344 decoded bytes; requires content_type",
      "type": "string",
      "maxLength": 4172460
    },
    "content_type": {
      "type": "string",
      "enum": [
        "image/jpeg",
        "image/png",
        "image/webp"
      ]
    },
    "prompt": {
      "type": "string",
      "maxLength": 500
    },
    "name": {
      "type": "string",
      "maxLength": 120
    },
    "idempotency_key": {
      "type": "string",
      "minLength": 1,
      "maxLength": 128
    },
    "is_public": {
      "type": "boolean"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Ausgabe-Schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "status": {
      "type": "string",
      "enum": [
        "drafting",
        "preview_ready",
        "rendering",
        "ready",
        "failed"
      ]
    },
    "prompt": {
      "type": [
        "string",
        "null"
      ]
    },
    "name": {
      "type": [
        "string",
        "null"
      ]
    },
    "error": {
      "type": [
        "string",
        "null"
      ]
    },
    "hasPreview": {
      "type": "boolean"
    },
    "hasSheet": {
      "type": "boolean"
    },
    "sheetNote": {
      "type": [
        "string",
        "null"
      ]
    },
    "hasModel": {
      "type": "boolean"
    },
    "modelVersion": {
      "type": "number"
    },
    "credits": {
      "type": "number",
      "minimum": 0
    },
    "renderCredits": {
      "type": "number",
      "minimum": 0
    },
    "sheetCredits": {
      "type": "number",
      "minimum": 0
    },
    "upscaleCredits": {
      "type": "number",
      "minimum": 0
    },
    "canUpscale": {
      "type": "boolean"
    },
    "isPublic": {
      "type": "boolean"
    },
    "source": {
      "type": "string",
      "enum": [
        "web",
        "mcp",
        "api"
      ]
    },
    "createdAt": {
      "type": "string"
    },
    "pending_credits": {
      "type": "number",
      "minimum": 0
    },
    "links": {
      "type": "object",
      "properties": {
        "page": {
          "type": "string",
          "format": "uri"
        },
        "preview": {
          "type": "string",
          "format": "uri"
        },
        "model_glb": {
          "type": "string",
          "format": "uri"
        }
      },
      "required": [
        "page",
        "preview",
        "model_glb"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "id",
    "status",
    "prompt",
    "name",
    "error",
    "hasPreview",
    "hasSheet",
    "sheetNote",
    "hasModel",
    "modelVersion",
    "credits",
    "renderCredits",
    "sheetCredits",
    "upscaleCredits",
    "canUpscale",
    "isPublic",
    "source",
    "createdAt",
    "pending_credits",
    "links"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}
🟢get_render(id)

Read render status, artifact links and pending credits. Poll every 5–15 seconds. This may advance an already-authorized job; it does not authorize another paid generation. Private links need the same bearer authentication.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    }
  },
  "required": [
    "id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Ausgabe-Schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "status": {
      "type": "string",
      "enum": [
        "drafting",
        "preview_ready",
        "rendering",
        "ready",
        "failed"
      ]
    },
    "prompt": {
      "type": [
        "string",
        "null"
      ]
    },
    "name": {
      "type": [
        "string",
        "null"
      ]
    },
    "error": {
      "type": [
        "string",
        "null"
      ]
    },
    "hasPreview": {
      "type": "boolean"
    },
    "hasSheet": {
      "type": "boolean"
    },
    "sheetNote": {
      "type": [
        "string",
        "null"
      ]
    },
    "hasModel": {
      "type": "boolean"
    },
    "modelVersion": {
      "type": "number"
    },
    "credits": {
      "type": "number",
      "minimum": 0
    },
    "renderCredits": {
      "type": "number",
      "minimum": 0
    },
    "sheetCredits": {
      "type": "number",
      "minimum": 0
    },
    "upscaleCredits": {
      "type": "number",
      "minimum": 0
    },
    "canUpscale": {
      "type": "boolean"
    },
    "isPublic": {
      "type": "boolean"
    },
    "source": {
      "type": "string",
      "enum": [
        "web",
        "mcp",
        "api"
      ]
    },
    "createdAt": {
      "type": "string"
    },
    "pending_credits": {
      "type": "number",
      "minimum": 0
    },
    "links": {
      "type": "object",
      "properties": {
        "page": {
          "type": "string",
          "format": "uri"
        },
        "preview": {
          "type": "string",
          "format": "uri"
        },
        "model_glb": {
          "type": "string",
          "format": "uri"
        }
      },
      "required": [
        "page",
        "preview",
        "model_glb"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "id",
    "status",
    "prompt",
    "name",
    "error",
    "hasPreview",
    "hasSheet",
    "sheetNote",
    "hasModel",
    "modelVersion",
    "credits",
    "renderCredits",
    "sheetCredits",
    "upscaleCredits",
    "canUpscale",
    "isPublic",
    "source",
    "createdAt",
    "pending_credits",
    "links"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}
🔴render_3d(id, max_credits)

Build an approved preview for its pending_credits. Send max_credits as the authorized ceiling. Repeating the same running/ready render does not charge again. On timeout query the same id before retrying; never create another paid render automatically.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "max_credits": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Ausgabe-Schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "status": {
      "type": "string",
      "enum": [
        "drafting",
        "preview_ready",
        "rendering",
        "ready",
        "failed"
      ]
    },
    "prompt": {
      "type": [
        "string",
        "null"
      ]
    },
    "name": {
      "type": [
        "string",
        "null"
      ]
    },
    "error": {
      "type": [
        "string",
        "null"
      ]
    },
    "hasPreview": {
      "type": "boolean"
    },
    "hasSheet": {
      "type": "boolean"
    },
    "sheetNote": {
      "type": [
        "string",
        "null"
      ]
    },
    "hasModel": {
      "type": "boolean"
    },
    "modelVersion": {
      "type": "number"
    },
    "credits": {
      "type": "number",
      "minimum": 0
    },
    "renderCredits": {
      "type": "number",
      "minimum": 0
    },
    "sheetCredits": {
      "type": "number",
      "minimum": 0
    },
    "upscaleCredits": {
      "type": "number",
      "minimum": 0
    },
    "canUpscale": {
      "type": "boolean"
    },
    "isPublic": {
      "type": "boolean"
    },
    "source": {
      "type": "string",
      "enum": [
        "web",
        "mcp",
        "api"
      ]
    },
    "createdAt": {
      "type": "string"
    },
    "pending_credits": {
      "type": "number",
      "minimum": 0
    },
    "links": {
      "type": "object",
      "properties": {
        "page": {
          "type": "string",
          "format": "uri"
        },
        "preview": {
          "type": "string",
          "format": "uri"
        },
        "model_glb": {
          "type": "string",
          "format": "uri"
        }
      },
      "required": [
        "page",
        "preview",
        "model_glb"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "id",
    "status",
    "prompt",
    "name",
    "error",
    "hasPreview",
    "hasSheet",
    "sheetNote",
    "hasModel",
    "modelVersion",
    "credits",
    "renderCredits",
    "sheetCredits",
    "upscaleCredits",
    "canUpscale",
    "isPublic",
    "source",
    "createdAt",
    "pending_credits",
    "links"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}
🟢get_credits

Balance, current operation costs, buyer currency, public offers and actual account top-up rate. Prices are in currency; no purchase is made.

Eingabe-Schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Ausgabe-Schema

{
  "type": "object",
  "properties": {
    "pricing_variant": {
      "type": "string",
      "enum": [
        "control",
        "test"
      ]
    },
    "currency": {
      "type": "string",
      "enum": [
        "usd",
        "eur"
      ]
    },
    "balance": {
      "type": "number"
    },
    "render_credits": {
      "type": "number"
    },
    "sheet_credits": {
      "type": "number"
    },
    "product_views_credits": {
      "type": "number"
    },
    "view_polish_credits": {
      "type": "number"
    },
    "upscale_credits": {
      "type": "number"
    },
    "build_from_views_credits": {
      "type": "number"
    },
    "plans": {
      "type": "object",
      "properties": {
        "pay_as_you_go": {
          "type": "object",
          "properties": {
            "price_per_credit": {
              "type": "number"
            },
            "min_credits": {
              "type": "number"
            },
            "max_credits": {
              "type": "number"
            }
          },
          "required": [
            "price_per_credit",
            "min_credits",
            "max_credits"
          ],
          "additionalProperties": false
        },
        "pro": {
          "type": "object",
          "properties": {
            "price_per_month": {
              "type": "number"
            },
            "credits_per_month": {
              "type": "number"
            }
          },
          "required": [
            "price_per_month",
            "credits_per_month"
          ],
          "additionalProperties": false
        },
        "enterprise": {
          "type": "object",
          "properties": {
            "book_a_call": {
              "type": "string",
              "format": "uri"
            }
          },
          "required": [
            "book_a_call"
          ],
          "additionalProperties": false
        }
      },
      "required": [
        "pay_as_you_go",
        "pro",
        "enterprise"
      ],
      "additionalProperties": false
    },
    "topup": {
      "type": "object",
      "properties": {
        "plan": {
          "type": [
            "string",
            "null"
          ]
        },
        "currency": {
          "type": "string",
          "enum": [
            "usd",
            "eur"
          ]
        },
        "price_cents": {
          "type": "number"
        },
        "credits_per_unit": {
          "type": "number"
        }
      },
      "required": [
        "plan",
        "currency",
        "price_cents",
        "credits_per_unit"
      ],
      "additionalProperties": false
    },
    "buy": {
      "type": "string",
      "format": "uri"
    }
  },
  "required": [
    "pricing_variant",
    "currency",
    "balance",
    "render_credits",
    "sheet_credits",
    "product_views_credits",
    "view_polish_credits",
    "upscale_credits",
    "build_from_views_credits",
    "plans",
    "topup",
    "buy"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}
🟢list_renders(cursor, limit, status)

Find and recover your renders, newest first. Follow next_cursor to retrieve more. Only this account’s renders are listed.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "cursor": {
      "type": "string",
      "minLength": 1,
      "maxLength": 512
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "status": {
      "type": "string",
      "enum": [
        "drafting",
        "preview_ready",
        "rendering",
        "ready",
        "failed"
      ]
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Ausgabe-Schema

{
  "type": "object",
  "properties": {
    "renders": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "minLength": 1,
            "maxLength": 200
          },
          "status": {
            "type": "string",
            "enum": [
              "drafting",
              "preview_ready",
              "rendering",
              "ready",
              "failed"
            ]
          },
          "prompt": {
            "type": [
              "string",
              "null"
            ]
          },
          "name": {
            "type": [
              "string",
              "null"
            ]
          },
          "error": {
            "type": [
              "string",
              "null"
            ]
          },
          "hasPreview": {
            "type": "boolean"
          },
          "hasSheet": {
            "type": "boolean"
          },
          "sheetNote": {
            "type": [
              "string",
              "null"
            ]
          },
          "hasModel": {
            "type": "boolean"
          },
          "modelVersion": {
            "type": "number"
          },
          "credits": {
            "type": "number",
            "minimum": 0
          },
          "renderCredits": {
            "type": "number",
            "minimum": 0
          },
          "sheetCredits": {
            "type": "number",
            "minimum": 0
          },
          "upscaleCredits": {
            "type": "number",
            "minimum": 0
          },
          "canUpscale": {
            "type": "boolean"
          },
          "isPublic": {
            "type": "boolean"
          },
          "source": {
            "type": "string",
            "enum": [
              "web",
              "mcp",
              "api"
            ]
          },
          "createdAt": {
            "type": "string"
          },
          "pending_credits": {
            "type": "number",
            "minimum": 0
          },
          "links": {
            "type": "object",
            "properties": {
              "page": {
                "type": "string",
                "format": "uri"
              },
              "preview": {
                "type": "string",
                "format": "uri"
              },
              "model_glb": {
                "type": "string",
                "format": "uri"
              }
            },
            "required": [
              "page",
              "preview",
              "model_glb"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "id",
          "status",
          "prompt",
          "name",
          "error",
          "hasPreview",
          "hasSheet",
          "sheetNote",
          "hasModel",
          "modelVersion",
          "credits",
          "renderCredits",
          "sheetCredits",
          "upscaleCredits",
          "canUpscale",
          "isPublic",
          "source",
          "createdAt",
          "pending_credits",
          "links"
        ],
        "additionalProperties": false
      }
    },
    "next_cursor": {
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "renders",
    "next_cursor"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}
🔴set_render_visibility(id, is_public)

Explicitly publish a finished model in the public gallery or make it private. Requires share permission; publishing exposes the render to other people.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "is_public": {
      "type": "boolean"
    }
  },
  "required": [
    "id",
    "is_public"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Ausgabe-Schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "status": {
      "type": "string",
      "enum": [
        "drafting",
        "preview_ready",
        "rendering",
        "ready",
        "failed"
      ]
    },
    "prompt": {
      "type": [
        "string",
        "null"
      ]
    },
    "name": {
      "type": [
        "string",
        "null"
      ]
    },
    "error": {
      "type": [
        "string",
        "null"
      ]
    },
    "hasPreview": {
      "type": "boolean"
    },
    "hasSheet": {
      "type": "boolean"
    },
    "sheetNote": {
      "type": [
        "string",
        "null"
      ]
    },
    "hasModel": {
      "type": "boolean"
    },
    "modelVersion": {
      "type": "number"
    },
    "credits": {
      "type": "number",
      "minimum": 0
    },
    "renderCredits": {
      "type": "number",
      "minimum": 0
    },
    "sheetCredits": {
      "type": "number",
      "minimum": 0
    },
    "upscaleCredits": {
      "type": "number",
      "minimum": 0
    },
    "canUpscale": {
      "type": "boolean"
    },
    "isPublic": {
      "type": "boolean"
    },
    "source": {
      "type": "string",
      "enum": [
        "web",
        "mcp",
        "api"
      ]
    },
    "createdAt": {
      "type": "string"
    },
    "pending_credits": {
      "type": "number",
      "minimum": 0
    },
    "links": {
      "type": "object",
      "properties": {
        "page": {
          "type": "string",
          "format": "uri"
        },
        "preview": {
          "type": "string",
          "format": "uri"
        },
        "model_glb": {
          "type": "string",
          "format": "uri"
        }
      },
      "required": [
        "page",
        "preview",
        "model_glb"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "id",
    "status",
    "prompt",
    "name",
    "error",
    "hasPreview",
    "hasSheet",
    "sheetNote",
    "hasModel",
    "modelVersion",
    "credits",
    "renderCredits",
    "sheetCredits",
    "upscaleCredits",
    "canUpscale",
    "isPublic",
    "source",
    "createdAt",
    "pending_credits",
    "links"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}
🔴start_render_sheet(id, max_credits)

Generate a paid angle sheet for a preview without one. Existing sheets/jobs are reused. The sheet cost counts toward the later 3D build. Query get_credits.sheet_credits first.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "max_credits": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991,
      "description": "Maximum credits explicitly authorized for this action"
    }
  },
  "required": [
    "id",
    "max_credits"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Ausgabe-Schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "status": {
      "type": "string",
      "enum": [
        "drafting",
        "preview_ready",
        "rendering",
        "ready",
        "failed"
      ]
    },
    "prompt": {
      "type": [
        "string",
        "null"
      ]
    },
    "name": {
      "type": [
        "string",
        "null"
      ]
    },
    "error": {
      "type": [
        "string",
        "null"
      ]
    },
    "hasPreview": {
      "type": "boolean"
    },
    "hasSheet": {
      "type": "boolean"
    },
    "sheetNote": {
      "type": [
        "string",
        "null"
      ]
    },
    "hasModel": {
      "type": "boolean"
    },
    "modelVersion": {
      "type": "number"
    },
    "credits": {
      "type": "number",
      "minimum": 0
    },
    "renderCredits": {
      "type": "number",
      "minimum": 0
    },
    "sheetCredits": {
      "type": "number",
      "minimum": 0
    },
    "upscaleCredits": {
      "type": "number",
      "minimum": 0
    },
    "canUpscale": {
      "type": "boolean"
    },
    "isPublic": {
      "type": "boolean"
    },
    "source": {
      "type": "string",
      "enum": [
        "web",
        "mcp",
        "api"
      ]
    },
    "createdAt": {
      "type": "string"
    },
    "pending_credits": {
      "type": "number",
      "minimum": 0
    },
    "links": {
      "type": "object",
      "properties": {
        "page": {
          "type": "string",
          "format": "uri"
        },
        "preview": {
          "type": "string",
          "format": "uri"
        },
        "model_glb": {
          "type": "string",
          "format": "uri"
        }
      },
      "required": [
        "page",
        "preview",
        "model_glb"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "id",
    "status",
    "prompt",
    "name",
    "error",
    "hasPreview",
    "hasSheet",
    "sheetNote",
    "hasModel",
    "modelVersion",
    "credits",
    "renderCredits",
    "sheetCredits",
    "upscaleCredits",
    "canUpscale",
    "isPublic",
    "source",
    "createdAt",
    "pending_credits",
    "links"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}
🔴redraw_render_sheet(id, note, max_credits)

Pay to redraw a preview sheet using a correction note. Each completed redraw is a new charge and does not count toward the 3D cost. On timeout inspect the same render before deciding whether to repeat.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "note": {
      "type": "string",
      "minLength": 1,
      "maxLength": 500
    },
    "max_credits": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991,
      "description": "Maximum credits explicitly authorized for this action"
    }
  },
  "required": [
    "id",
    "note",
    "max_credits"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Ausgabe-Schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "status": {
      "type": "string",
      "enum": [
        "drafting",
        "preview_ready",
        "rendering",
        "ready",
        "failed"
      ]
    },
    "prompt": {
      "type": [
        "string",
        "null"
      ]
    },
    "name": {
      "type": [
        "string",
        "null"
      ]
    },
    "error": {
      "type": [
        "string",
        "null"
      ]
    },
    "hasPreview": {
      "type": "boolean"
    },
    "hasSheet": {
      "type": "boolean"
    },
    "sheetNote": {
      "type": [
        "string",
        "null"
      ]
    },
    "hasModel": {
      "type": "boolean"
    },
    "modelVersion": {
      "type": "number"
    },
    "credits": {
      "type": "number",
      "minimum": 0
    },
    "renderCredits": {
      "type": "number",
      "minimum": 0
    },
    "sheetCredits": {
      "type": "number",
      "minimum": 0
    },
    "upscaleCredits": {
      "type": "number",
      "minimum": 0
    },
    "canUpscale": {
      "type": "boolean"
    },
    "isPublic": {
      "type": "boolean"
    },
    "source": {
      "type": "string",
      "enum": [
        "web",
        "mcp",
        "api"
      ]
    },
    "createdAt": {
      "type": "string"
    },
    "pending_credits": {
      "type": "number",
      "minimum": 0
    },
    "links": {
      "type": "object",
      "properties": {
        "page": {
          "type": "string",
          "format": "uri"
        },
        "preview": {
          "type": "string",
          "format": "uri"
        },
        "model_glb": {
          "type": "string",
          "format": "uri"
        }
      },
      "required": [
        "page",
        "preview",
        "model_glb"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "id",
    "status",
    "prompt",
    "name",
    "error",
    "hasPreview",
    "hasSheet",
    "sheetNote",
    "hasModel",
    "modelVersion",
    "credits",
    "renderCredits",
    "sheetCredits",
    "upscaleCredits",
    "canUpscale",
    "isPublic",
    "source",
    "createdAt",
    "pending_credits",
    "links"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}
🔴upscale_image(kind, render_id, view_set_id, view, max_credits)

Enlarge an owned product view or the sheet of a paid render. Quote upscale_credits with get_credits. Existing enlargements may be reused; query get_upscale to track the result, or list_upscales to recover its id. Do not repeat an uncertain request automatically.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "kind": {
      "type": "string",
      "enum": [
        "sheet",
        "view"
      ]
    },
    "render_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "view_set_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "view": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100
    },
    "max_credits": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991,
      "description": "Maximum credits explicitly authorized for this action"
    }
  },
  "required": [
    "kind",
    "max_credits"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Ausgabe-Schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "kind": {
      "type": "string",
      "enum": [
        "view",
        "sheet"
      ]
    },
    "renderId": {
      "type": [
        "string",
        "null"
      ]
    },
    "viewSetId": {
      "type": [
        "string",
        "null"
      ]
    },
    "view": {
      "type": [
        "string",
        "null"
      ]
    },
    "status": {
      "type": "string",
      "enum": [
        "processing",
        "ready",
        "failed"
      ]
    },
    "hasImage": {
      "type": "boolean"
    },
    "width": {
      "type": [
        "number",
        "null"
      ]
    },
    "height": {
      "type": [
        "number",
        "null"
      ]
    },
    "credits": {
      "type": "number"
    },
    "createdAt": {
      "type": "string"
    },
    "links": {
      "type": "object",
      "properties": {
        "image": {
          "type": "string",
          "format": "uri"
        }
      },
      "required": [
        "image"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "id",
    "kind",
    "renderId",
    "viewSetId",
    "view",
    "status",
    "hasImage",
    "width",
    "height",
    "credits",
    "createdAt",
    "links"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}
🟢get_upscale(id)

Read your enlargement’s status and authenticated image URL. Poll every 5–15 seconds until ready or failed.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    }
  },
  "required": [
    "id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Ausgabe-Schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "kind": {
      "type": "string",
      "enum": [
        "view",
        "sheet"
      ]
    },
    "renderId": {
      "type": [
        "string",
        "null"
      ]
    },
    "viewSetId": {
      "type": [
        "string",
        "null"
      ]
    },
    "view": {
      "type": [
        "string",
        "null"
      ]
    },
    "status": {
      "type": "string",
      "enum": [
        "processing",
        "ready",
        "failed"
      ]
    },
    "hasImage": {
      "type": "boolean"
    },
    "width": {
      "type": [
        "number",
        "null"
      ]
    },
    "height": {
      "type": [
        "number",
        "null"
      ]
    },
    "credits": {
      "type": "number"
    },
    "createdAt": {
      "type": "string"
    },
    "links": {
      "type": "object",
      "properties": {
        "image": {
          "type": "string",
          "format": "uri"
        }
      },
      "required": [
        "image"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "id",
    "kind",
    "renderId",
    "viewSetId",
    "view",
    "status",
    "hasImage",
    "width",
    "height",
    "credits",
    "createdAt",
    "links"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}
🔴create_product_views(upload_id, image_url, image_base64, content_type, prompt, ...)

Buy nine product photos from one source photo. This is a paid operation, separate from the free 3D preview. Query product_views_credits with get_credits and obtain authorization. On timeout recover the existing set using list_product_views before retrying.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "upload_id": {
      "description": "Owner-scoped id from authenticated POST /api/uploads; expires after one hour",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "image_url": {
      "description": "Public HTTPS JPEG, PNG or WebP URL; up to 4 MiB",
      "type": "string",
      "maxLength": 4096,
      "format": "uri"
    },
    "image_base64": {
      "description": "Canonical base64, at most 3129344 decoded bytes; requires content_type",
      "type": "string",
      "maxLength": 4172460
    },
    "content_type": {
      "type": "string",
      "enum": [
        "image/jpeg",
        "image/png",
        "image/webp"
      ]
    },
    "prompt": {
      "type": "string",
      "maxLength": 500
    },
    "name": {
      "type": "string",
      "maxLength": 120
    },
    "max_credits": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991,
      "description": "Maximum credits explicitly authorized for this action"
    }
  },
  "required": [
    "max_credits"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Ausgabe-Schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "name": {
      "type": [
        "string",
        "null"
      ]
    },
    "prompt": {
      "type": [
        "string",
        "null"
      ]
    },
    "status": {
      "type": "string",
      "enum": [
        "drafting",
        "processing",
        "ready",
        "failed"
      ]
    },
    "error": {
      "type": [
        "string",
        "null"
      ]
    },
    "views": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "view": {
            "type": "string"
          },
          "status": {
            "type": "string"
          },
          "hasImage": {
            "type": "boolean"
          },
          "version": {
            "type": "number"
          },
          "isFlagged": {
            "type": "boolean"
          },
          "problems": {
            "type": "array",
            "items": {}
          },
          "isPolishing": {
            "type": "boolean"
          },
          "note": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "view",
          "status",
          "hasImage",
          "version",
          "isFlagged",
          "problems",
          "isPolishing",
          "note"
        ],
        "additionalProperties": false
      }
    },
    "readyCount": {
      "type": "number"
    },
    "viewCount": {
      "type": "number"
    },
    "credits": {
      "type": "number"
    },
    "polishCredits": {
      "type": "number"
    },
    "upscaleCredits": {
      "type": "number"
    },
    "buildCredits": {
      "type": "number"
    },
    "renderId": {
      "type": [
        "string",
        "null"
      ]
    },
    "createdAt": {
      "type": "string"
    },
    "links": {
      "type": "object",
      "properties": {
        "zip": {
          "type": "string",
          "format": "uri"
        }
      },
      "required": [
        "zip"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "id",
    "name",
    "prompt",
    "status",
    "error",
    "views",
    "readyCount",
    "viewCount",
    "credits",
    "polishCredits",
    "upscaleCredits",
    "buildCredits",
    "renderId",
    "createdAt",
    "links"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}
🟢get_product_views(id)

Read your product-view set’s state, quality flags, follow-up costs and authenticated ZIP URL. Poll until ready or failed.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    }
  },
  "required": [
    "id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Ausgabe-Schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "name": {
      "type": [
        "string",
        "null"
      ]
    },
    "prompt": {
      "type": [
        "string",
        "null"
      ]
    },
    "status": {
      "type": "string",
      "enum": [
        "drafting",
        "processing",
        "ready",
        "failed"
      ]
    },
    "error": {
      "type": [
        "string",
        "null"
      ]
    },
    "views": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "view": {
            "type": "string"
          },
          "status": {
            "type": "string"
          },
          "hasImage": {
            "type": "boolean"
          },
          "version": {
            "type": "number"
          },
          "isFlagged": {
            "type": "boolean"
          },
          "problems": {
            "type": "array",
            "items": {}
          },
          "isPolishing": {
            "type": "boolean"
          },
          "note": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "view",
          "status",
          "hasImage",
          "version",
          "isFlagged",
          "problems",
          "isPolishing",
          "note"
        ],
        "additionalProperties": false
      }
    },
    "readyCount": {
      "type": "number"
    },
    "viewCount": {
      "type": "number"
    },
    "credits": {
      "type": "number"
    },
    "polishCredits": {
      "type": "number"
    },
    "upscaleCredits": {
      "type": "number"
    },
    "buildCredits": {
      "type": "number"
    },
    "renderId": {
      "type": [
        "string",
        "null"
      ]
    },
    "createdAt": {
      "type": "string"
    },
    "links": {
      "type": "object",
      "properties": {
        "zip": {
          "type": "string",
          "format": "uri"
        }
      },
      "required": [
        "zip"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "id",
    "name",
    "prompt",
    "status",
    "error",
    "views",
    "readyCount",
    "viewCount",
    "credits",
    "polishCredits",
    "upscaleCredits",
    "buildCredits",
    "renderId",
    "createdAt",
    "links"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}
🟢list_product_views(limit)

Recover your latest product-view sets, newest first. Returns at most limit entries (default 24, maximum 100); this is a bounded recent list, without pagination.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Ausgabe-Schema

{
  "type": "object",
  "properties": {
    "view_sets": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "minLength": 1,
            "maxLength": 200
          },
          "name": {
            "type": [
              "string",
              "null"
            ]
          },
          "prompt": {
            "type": [
              "string",
              "null"
            ]
          },
          "status": {
            "type": "string",
            "enum": [
              "drafting",
              "processing",
              "ready",
              "failed"
            ]
          },
          "error": {
            "type": [
              "string",
              "null"
            ]
          },
          "views": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "view": {
                  "type": "string"
                },
                "status": {
                  "type": "string"
                },
                "hasImage": {
                  "type": "boolean"
                },
                "version": {
                  "type": "number"
                },
                "isFlagged": {
                  "type": "boolean"
                },
                "problems": {
                  "type": "array",
                  "items": {}
                },
                "isPolishing": {
                  "type": "boolean"
                },
                "note": {
                  "type": [
                    "string",
                    "null"
                  ]
                }
              },
              "required": [
                "view",
                "status",
                "hasImage",
                "version",
                "isFlagged",
                "problems",
                "isPolishing",
                "note"
              ],
              "additionalProperties": false
            }
          },
          "readyCount": {
            "type": "number"
          },
          "viewCount": {
            "type": "number"
          },
          "credits": {
            "type": "number"
          },
          "polishCredits": {
            "type": "number"
          },
          "upscaleCredits": {
            "type": "number"
          },
          "buildCredits": {
            "type": "number"
          },
          "renderId": {
            "type": [
              "string",
              "null"
            ]
          },
          "createdAt": {
            "type": "string"
          },
          "links": {
            "type": "object",
            "properties": {
              "zip": {
                "type": "string",
                "format": "uri"
              }
            },
            "required": [
              "zip"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "id",
          "name",
          "prompt",
          "status",
          "error",
          "views",
          "readyCount",
          "viewCount",
          "credits",
          "polishCredits",
          "upscaleCredits",
          "buildCredits",
          "renderId",
          "createdAt",
          "links"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "view_sets"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}
🟡list_upscales(render_id, view_set_id)

Recover up to 50 of your current enlargements for one render or product-view set, newest first. Supply exactly one render_id or view_set_id. Replaced source images are excluded.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "render_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "view_set_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Ausgabe-Schema

{
  "type": "object",
  "properties": {
    "upscales": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "minLength": 1,
            "maxLength": 200
          },
          "kind": {
            "type": "string",
            "enum": [
              "view",
              "sheet"
            ]
          },
          "renderId": {
            "type": [
              "string",
              "null"
            ]
          },
          "viewSetId": {
            "type": [
              "string",
              "null"
            ]
          },
          "view": {
            "type": [
              "string",
              "null"
            ]
          },
          "status": {
            "type": "string",
            "enum": [
              "processing",
              "ready",
              "failed"
            ]
          },
          "hasImage": {
            "type": "boolean"
          },
          "width": {
            "type": [
              "number",
              "null"
            ]
          },
          "height": {
            "type": [
              "number",
              "null"
            ]
          },
          "credits": {
            "type": "number"
          },
          "createdAt": {
            "type": "string"
          },
          "links": {
            "type": "object",
            "properties": {
              "image": {
                "type": "string",
                "format": "uri"
              }
            },
            "required": [
              "image"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "id",
          "kind",
          "renderId",
          "viewSetId",
          "view",
          "status",
          "hasImage",
          "width",
          "height",
          "credits",
          "createdAt",
          "links"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "upscales"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}
🔴polish_product_view(id, view, note, max_credits)

Pay to correct one ready product photo using a note. Quote view_polish_credits first. Check get_product_views after a timeout; repeating a completed polish incurs a new charge.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "view": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100
    },
    "note": {
      "type": "string",
      "minLength": 1,
      "maxLength": 500
    },
    "max_credits": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991,
      "description": "Maximum credits explicitly authorized for this action"
    }
  },
  "required": [
    "id",
    "view",
    "note",
    "max_credits"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Ausgabe-Schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "name": {
      "type": [
        "string",
        "null"
      ]
    },
    "prompt": {
      "type": [
        "string",
        "null"
      ]
    },
    "status": {
      "type": "string",
      "enum": [
        "drafting",
        "processing",
        "ready",
        "failed"
      ]
    },
    "error": {
      "type": [
        "string",
        "null"
      ]
    },
    "views": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "view": {
            "type": "string"
          },
          "status": {
            "type": "string"
          },
          "hasImage": {
            "type": "boolean"
          },
          "version": {
            "type": "number"
          },
          "isFlagged": {
            "type": "boolean"
          },
          "problems": {
            "type": "array",
            "items": {}
          },
          "isPolishing": {
            "type": "boolean"
          },
          "note": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "view",
          "status",
          "hasImage",
          "version",
          "isFlagged",
          "problems",
          "isPolishing",
          "note"
        ],
        "additionalProperties": false
      }
    },
    "readyCount": {
      "type": "number"
    },
    "viewCount": {
      "type": "number"
    },
    "credits": {
      "type": "number"
    },
    "polishCredits": {
      "type": "number"
    },
    "upscaleCredits": {
      "type": "number"
    },
    "buildCredits": {
      "type": "number"
    },
    "renderId": {
      "type": [
        "string",
        "null"
      ]
    },
    "createdAt": {
      "type": "string"
    },
    "links": {
      "type": "object",
      "properties": {
        "zip": {
          "type": "string",
          "format": "uri"
        }
      },
      "required": [
        "zip"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "id",
    "name",
    "prompt",
    "status",
    "error",
    "views",
    "readyCount",
    "viewCount",
    "credits",
    "polishCredits",
    "upscaleCredits",
    "buildCredits",
    "renderId",
    "createdAt",
    "links"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}
🔴build_from_product_views(id, max_credits)

Build a GLB from a completed product-view set, reusing its paid sheet. Quote build_from_views_credits first. Existing running/ready builds are reused. On timeout recover renderId through get_product_views.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "max_credits": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991,
      "description": "Maximum credits explicitly authorized for this action"
    }
  },
  "required": [
    "id",
    "max_credits"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Ausgabe-Schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "status": {
      "type": "string",
      "enum": [
        "drafting",
        "preview_ready",
        "rendering",
        "ready",
        "failed"
      ]
    },
    "prompt": {
      "type": [
        "string",
        "null"
      ]
    },
    "name": {
      "type": [
        "string",
        "null"
      ]
    },
    "error": {
      "type": [
        "string",
        "null"
      ]
    },
    "hasPreview": {
      "type": "boolean"
    },
    "hasSheet": {
      "type": "boolean"
    },
    "sheetNote": {
      "type": [
        "string",
        "null"
      ]
    },
    "hasModel": {
      "type": "boolean"
    },
    "modelVersion": {
      "type": "number"
    },
    "credits": {
      "type": "number",
      "minimum": 0
    },
    "renderCredits": {
      "type": "number",
      "minimum": 0
    },
    "sheetCredits": {
      "type": "number",
      "minimum": 0
    },
    "upscaleCredits": {
      "type": "number",
      "minimum": 0
    },
    "canUpscale": {
      "type": "boolean"
    },
    "isPublic": {
      "type": "boolean"
    },
    "source": {
      "type": "string",
      "enum": [
        "web",
        "mcp",
        "api"
      ]
    },
    "createdAt": {
      "type": "string"
    },
    "pending_credits": {
      "type": "number",
      "minimum": 0
    },
    "links": {
      "type": "object",
      "properties": {
        "page": {
          "type": "string",
          "format": "uri"
        },
        "preview": {
          "type": "string",
          "format": "uri"
        },
        "model_glb": {
          "type": "string",
          "format": "uri"
        }
      },
      "required": [
        "page",
        "preview",
        "model_glb"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "id",
    "status",
    "prompt",
    "name",
    "error",
    "hasPreview",
    "hasSheet",
    "sheetNote",
    "hasModel",
    "modelVersion",
    "credits",
    "renderCredits",
    "sheetCredits",
    "upscaleCredits",
    "canUpscale",
    "isPublic",
    "source",
    "createdAt",
    "pending_credits",
    "links"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Community

Diesen Server bewerten

Nachweis

Aktuelle Beobachtungen

verifiziertVersion nicht aufgezeichnet16 Tools