Easy Render | Photo to 3D is an MCP server published by io.github.easyrenderai, hosted at easyrender.ai. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 16 tools, including create_render, get_render, render_3d, get_credits, list_renders.
Turn any Product Photo into a 3D model
915 connections through 5 shared values. Tap any node.
Inferred from the host name and headers: what a server runs on, not who runs it.
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.
| Parameter | Type | Description |
|---|---|---|
| name | string | |
| prompt | string | |
| image_url | string | Public HTTPS JPEG, PNG or WebP URL; up to 4 MiB |
| is_public | boolean | |
| upload_id | string | Owner-scoped id from authenticated POST /api/uploads; expires after one hour |
None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
| content_type | string | one of ["image/jpeg","image/png","image/webp"] |
| image_base64 | string | Canonical base64, at most 3129344 decoded bytes; requires content_type |
| idempotency_key | string |
{
"name": "create_render",
"title": "Create render preview",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"name": {
"type": "string",
"maxLength": 120
},
"prompt": {
"type": "string",
"maxLength": 500
},
"image_url": {
"type": "string",
"format": "uri",
"maxLength": 4096,
"description": "Public HTTPS JPEG, PNG or WebP URL; up to 4 MiB"
},
"is_public": {
"type": "boolean"
},
"upload_id": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Owner-scoped id from authenticated POST /api/uploads; expires after one hour"
},
"content_type": {
"enum": [
"image/jpeg",
"image/png",
"image/webp"
],
"type": "string"
},
"image_base64": {
"type": "string",
"maxLength": 4172460,
"description": "Canonical base64, at most 3129344 decoded bytes; requires content_type"
},
"idempotency_key": {
"type": "string",
"maxLength": 128,
"minLength": 1
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id",
"status",
"prompt",
"name",
"error",
"hasPreview",
"hasSheet",
"sheetNote",
"hasModel",
"modelVersion",
"credits",
"renderCredits",
"sheetCredits",
"upscaleCredits",
"canUpscale",
"isPublic",
"source",
"createdAt",
"pending_credits",
"links"
],
"properties": {
"id": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"name": {
"type": [
"string",
"null"
]
},
"error": {
"type": [
"string",
"null"
]
},
"links": {
"type": "object",
"required": [
"preview",
"model_glb"
],
"properties": {
"page": {
"type": "string",
"format": "uri"
},
"preview": {
"type": "string",
"format": "uri"
},
"model_glb": {
"type": "string",
"format": "uri"
}
},
"additionalProperties": false
},
"prompt": {
"type": [
"string",
"null"
]
},
"source": {
"enum": [
"web",
"mcp",
"api"
],
"type": "string"
},
"status": {
"enum": [
"drafting",
"preview_ready",
"rendering",
"ready",
"failed"
],
"type": "string"
},
"credits": {
"type": "number",
"minimum": 0
},
"hasModel": {
"type": "boolean"
},
"hasSheet": {
"type": "boolean"
},
"isPublic": {
"type": "boolean"
},
"createdAt": {
"type": "string"
},
"sheetNote": {
"type": [
"string",
"null"
]
},
"canUpscale": {
"type": "boolean"
},
"hasPreview": {
"type": "boolean"
},
"modelVersion": {
"type": "number"
},
"sheetCredits": {
"type": "number",
"minimum": 0
},
"renderCredits": {
"type": "number",
"minimum": 0
},
"upscaleCredits": {
"type": "number",
"minimum": 0
},
"pending_credits": {
"type": "number",
"minimum": 0
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}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. Pass export_format (obj, fbx or blend) on a ready render you own to also get a signed download link in `export` (valid about 10 minutes; OBJ is a ZIP with its MTL and textures). The first export of a model converts it and can take up to a minute; exports are free and rate limited.
| Parameter | Type | Description |
|---|---|---|
| id * | string | |
| export_format | string | one of ["obj","fbx","blend"] |
{
"name": "get_render",
"title": "Get render",
"description": "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. Pass export_format (obj, fbx or blend) on a ready render you own to also get a signed download link in `export` (valid about 10 minutes; OBJ is a ZIP with its MTL and textures). The first export of a model converts it and can take up to a minute; exports are free and rate limited.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"export_format": {
"enum": [
"obj",
"fbx",
"blend"
],
"type": "string"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id",
"status",
"prompt",
"name",
"error",
"hasPreview",
"hasSheet",
"sheetNote",
"hasModel",
"modelVersion",
"credits",
"renderCredits",
"sheetCredits",
"upscaleCredits",
"canUpscale",
"isPublic",
"source",
"createdAt",
"pending_credits",
"links"
],
"properties": {
"id": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"name": {
"type": [
"string",
"null"
]
},
"error": {
"type": [
"string",
"null"
]
},
"links": {
"type": "object",
"required": [
"preview",
"model_glb"
],
"properties": {
"page": {
"type": "string",
"format": "uri"
},
"preview": {
"type": "string",
"format": "uri"
},
"model_glb": {
"type": "string",
"format": "uri"
}
},
"additionalProperties": false
},
"export": {
"type": "object",
"required": [
"format",
"url",
"filename",
"expires_at"
],
"properties": {
"url": {
"type": "string",
"format": "uri"
},
"format": {
"enum": [
"obj",
"fbx",
"blend"
],
"type": "string"
},
"filename": {
"type": "string"
},
"expires_at": {
"type": "string"
}
},
"additionalProperties": false
},
"prompt": {
"type": [
"string",
"null"
]
},
"source": {
"enum": [
"web",
"mcp",
"api"
],
"type": "string"
},
"status": {
"enum": [
"drafting",
"preview_ready",
"rendering",
"ready",
"failed"
],
"type": "string"
},
"credits": {
"type": "number",
"minimum": 0
},
"hasModel": {
"type": "boolean"
},
"hasSheet": {
"type": "boolean"
},
"isPublic": {
"type": "boolean"
},
"createdAt": {
"type": "string"
},
"sheetNote": {
"type": [
"string",
"null"
]
},
"canUpscale": {
"type": "boolean"
},
"hasPreview": {
"type": "boolean"
},
"modelVersion": {
"type": "number"
},
"sheetCredits": {
"type": "number",
"minimum": 0
},
"renderCredits": {
"type": "number",
"minimum": 0
},
"upscaleCredits": {
"type": "number",
"minimum": 0
},
"pending_credits": {
"type": "number",
"minimum": 0
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| id * | string | |
| max_credits | integer |
{
"name": "render_3d",
"title": "Render in 3D",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"max_credits": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id",
"status",
"prompt",
"name",
"error",
"hasPreview",
"hasSheet",
"sheetNote",
"hasModel",
"modelVersion",
"credits",
"renderCredits",
"sheetCredits",
"upscaleCredits",
"canUpscale",
"isPublic",
"source",
"createdAt",
"pending_credits",
"links"
],
"properties": {
"id": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"name": {
"type": [
"string",
"null"
]
},
"error": {
"type": [
"string",
"null"
]
},
"links": {
"type": "object",
"required": [
"preview",
"model_glb"
],
"properties": {
"page": {
"type": "string",
"format": "uri"
},
"preview": {
"type": "string",
"format": "uri"
},
"model_glb": {
"type": "string",
"format": "uri"
}
},
"additionalProperties": false
},
"prompt": {
"type": [
"string",
"null"
]
},
"source": {
"enum": [
"web",
"mcp",
"api"
],
"type": "string"
},
"status": {
"enum": [
"drafting",
"preview_ready",
"rendering",
"ready",
"failed"
],
"type": "string"
},
"credits": {
"type": "number",
"minimum": 0
},
"hasModel": {
"type": "boolean"
},
"hasSheet": {
"type": "boolean"
},
"isPublic": {
"type": "boolean"
},
"createdAt": {
"type": "string"
},
"sheetNote": {
"type": [
"string",
"null"
]
},
"canUpscale": {
"type": "boolean"
},
"hasPreview": {
"type": "boolean"
},
"modelVersion": {
"type": "number"
},
"sheetCredits": {
"type": "number",
"minimum": 0
},
"renderCredits": {
"type": "number",
"minimum": 0
},
"upscaleCredits": {
"type": "number",
"minimum": 0
},
"pending_credits": {
"type": "number",
"minimum": 0
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}Balance, current operation costs, buyer currency, public offers and actual account top-up rate. Prices are in currency; no purchase is made.
No parameters.
{
"name": "get_credits",
"title": "Get credits",
"description": "Balance, current operation costs, buyer currency, public offers and actual account top-up rate. Prices are in currency; no purchase is made.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"pricing_variant",
"currency",
"balance",
"render_credits",
"sheet_credits",
"product_views_credits",
"view_polish_credits",
"upscale_credits",
"build_from_views_credits",
"plans",
"topup",
"buy"
],
"properties": {
"buy": {
"type": "string",
"format": "uri"
},
"plans": {
"type": "object",
"required": [
"pay_as_you_go",
"pro",
"enterprise"
],
"properties": {
"pro": {
"type": "object",
"required": [
"price_per_month",
"credits_per_month"
],
"properties": {
"price_per_month": {
"type": "number"
},
"credits_per_month": {
"type": "number"
}
},
"additionalProperties": false
},
"enterprise": {
"type": "object",
"required": [
"book_a_call"
],
"properties": {
"book_a_call": {
"type": "string",
"format": "uri"
}
},
"additionalProperties": false
},
"pay_as_you_go": {
"type": "object",
"required": [
"price_per_credit",
"min_credits",
"max_credits"
],
"properties": {
"max_credits": {
"type": "number"
},
"min_credits": {
"type": "number"
},
"price_per_credit": {
"type": "number"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"topup": {
"type": "object",
"required": [
"plan",
"currency",
"price_cents",
"credits_per_unit"
],
"properties": {
"plan": {
"type": [
"string",
"null"
]
},
"currency": {
"enum": [
"usd",
"eur"
],
"type": "string"
},
"price_cents": {
"type": "number"
},
"credits_per_unit": {
"type": "number"
}
},
"additionalProperties": false
},
"balance": {
"type": "number"
},
"currency": {
"enum": [
"usd",
"eur"
],
"type": "string"
},
"sheet_credits": {
"type": "number"
},
"render_credits": {
"type": "number"
},
"pricing_variant": {
"enum": [
"control",
"test"
],
"type": "string"
},
"upscale_credits": {
"type": "number"
},
"view_polish_credits": {
"type": "number"
},
"product_views_credits": {
"type": "number"
},
"build_from_views_credits": {
"type": "number"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Find and recover your renders, newest first. Follow next_cursor to retrieve more. Only this account’s renders are listed.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | |
| cursor | string | |
| status | string | one of ["drafting","preview_ready","rendering","ready","failed"] |
{
"name": "list_renders",
"title": "List your renders",
"description": "Find and recover your renders, newest first. Follow next_cursor to retrieve more. Only this account’s renders are listed.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1
},
"cursor": {
"type": "string",
"maxLength": 512,
"minLength": 1
},
"status": {
"enum": [
"drafting",
"preview_ready",
"rendering",
"ready",
"failed"
],
"type": "string"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"renders",
"next_cursor"
],
"properties": {
"renders": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"status",
"prompt",
"name",
"error",
"hasPreview",
"hasSheet",
"sheetNote",
"hasModel",
"modelVersion",
"credits",
"renderCredits",
"sheetCredits",
"upscaleCredits",
"canUpscale",
"isPublic",
"source",
"createdAt",
"pending_credits",
"links"
],
"properties": {
"id": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"name": {
"type": [
"string",
"null"
]
},
"error": {
"type": [
"string",
"null"
]
},
"links": {
"type": "object",
"required": [
"preview",
"model_glb"
],
"properties": {
"page": {
"type": "string",
"format": "uri"
},
"preview": {
"type": "string",
"format": "uri"
},
"model_glb": {
"type": "string",
"format": "uri"
}
},
"additionalProperties": false
},
"prompt": {
"type": [
"string",
"null"
]
},
"source": {
"enum": [
"web",
"mcp",
"api"
],
"type": "string"
},
"status": {
"enum": [
"drafting",
"preview_ready",
"rendering",
"ready",
"failed"
],
"type": "string"
},
"credits": {
"type": "number",
"minimum": 0
},
"hasModel": {
"type": "boolean"
},
"hasSheet": {
"type": "boolean"
},
"isPublic": {
"type": "boolean"
},
"createdAt": {
"type": "string"
},
"sheetNote": {
"type": [
"string",
"null"
]
},
"canUpscale": {
"type": "boolean"
},
"hasPreview": {
"type": "boolean"
},
"modelVersion": {
"type": "number"
},
"sheetCredits": {
"type": "number",
"minimum": 0
},
"renderCredits": {
"type": "number",
"minimum": 0
},
"upscaleCredits": {
"type": "number",
"minimum": 0
},
"pending_credits": {
"type": "number",
"minimum": 0
}
},
"additionalProperties": false
}
},
"next_cursor": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Explicitly publish a finished model in the public gallery or make it private. Requires share permission; publishing exposes the render to other people.
| Parameter | Type | Description |
|---|---|---|
| id * | string | |
| is_public * | boolean |
{
"name": "set_render_visibility",
"title": "Set render visibility",
"description": "Explicitly publish a finished model in the public gallery or make it private. Requires share permission; publishing exposes the render to other people.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id",
"is_public"
],
"properties": {
"id": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"is_public": {
"type": "boolean"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id",
"status",
"prompt",
"name",
"error",
"hasPreview",
"hasSheet",
"sheetNote",
"hasModel",
"modelVersion",
"credits",
"renderCredits",
"sheetCredits",
"upscaleCredits",
"canUpscale",
"isPublic",
"source",
"createdAt",
"pending_credits",
"links"
],
"properties": {
"id": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"name": {
"type": [
"string",
"null"
]
},
"error": {
"type": [
"string",
"null"
]
},
"links": {
"type": "object",
"required": [
"preview",
"model_glb"
],
"properties": {
"page": {
"type": "string",
"format": "uri"
},
"preview": {
"type": "string",
"format": "uri"
},
"model_glb": {
"type": "string",
"format": "uri"
}
},
"additionalProperties": false
},
"prompt": {
"type": [
"string",
"null"
]
},
"source": {
"enum": [
"web",
"mcp",
"api"
],
"type": "string"
},
"status": {
"enum": [
"drafting",
"preview_ready",
"rendering",
"ready",
"failed"
],
"type": "string"
},
"credits": {
"type": "number",
"minimum": 0
},
"hasModel": {
"type": "boolean"
},
"hasSheet": {
"type": "boolean"
},
"isPublic": {
"type": "boolean"
},
"createdAt": {
"type": "string"
},
"sheetNote": {
"type": [
"string",
"null"
]
},
"canUpscale": {
"type": "boolean"
},
"hasPreview": {
"type": "boolean"
},
"modelVersion": {
"type": "number"
},
"sheetCredits": {
"type": "number",
"minimum": 0
},
"renderCredits": {
"type": "number",
"minimum": 0
},
"upscaleCredits": {
"type": "number",
"minimum": 0
},
"pending_credits": {
"type": "number",
"minimum": 0
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| id * | string | |
| max_credits * | integer | Maximum credits explicitly authorized for this action |
{
"name": "start_render_sheet",
"title": "Generate an angle sheet",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id",
"max_credits"
],
"properties": {
"id": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"max_credits": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Maximum credits explicitly authorized for this action"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id",
"status",
"prompt",
"name",
"error",
"hasPreview",
"hasSheet",
"sheetNote",
"hasModel",
"modelVersion",
"credits",
"renderCredits",
"sheetCredits",
"upscaleCredits",
"canUpscale",
"isPublic",
"source",
"createdAt",
"pending_credits",
"links"
],
"properties": {
"id": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"name": {
"type": [
"string",
"null"
]
},
"error": {
"type": [
"string",
"null"
]
},
"links": {
"type": "object",
"required": [
"preview",
"model_glb"
],
"properties": {
"page": {
"type": "string",
"format": "uri"
},
"preview": {
"type": "string",
"format": "uri"
},
"model_glb": {
"type": "string",
"format": "uri"
}
},
"additionalProperties": false
},
"prompt": {
"type": [
"string",
"null"
]
},
"source": {
"enum": [
"web",
"mcp",
"api"
],
"type": "string"
},
"status": {
"enum": [
"drafting",
"preview_ready",
"rendering",
"ready",
"failed"
],
"type": "string"
},
"credits": {
"type": "number",
"minimum": 0
},
"hasModel": {
"type": "boolean"
},
"hasSheet": {
"type": "boolean"
},
"isPublic": {
"type": "boolean"
},
"createdAt": {
"type": "string"
},
"sheetNote": {
"type": [
"string",
"null"
]
},
"canUpscale": {
"type": "boolean"
},
"hasPreview": {
"type": "boolean"
},
"modelVersion": {
"type": "number"
},
"sheetCredits": {
"type": "number",
"minimum": 0
},
"renderCredits": {
"type": "number",
"minimum": 0
},
"upscaleCredits": {
"type": "number",
"minimum": 0
},
"pending_credits": {
"type": "number",
"minimum": 0
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| id * | string | |
| note * | string | |
| max_credits * | integer | Maximum credits explicitly authorized for this action |
{
"name": "redraw_render_sheet",
"title": "Redraw an angle sheet",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id",
"note",
"max_credits"
],
"properties": {
"id": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"note": {
"type": "string",
"maxLength": 500,
"minLength": 1
},
"max_credits": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Maximum credits explicitly authorized for this action"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id",
"status",
"prompt",
"name",
"error",
"hasPreview",
"hasSheet",
"sheetNote",
"hasModel",
"modelVersion",
"credits",
"renderCredits",
"sheetCredits",
"upscaleCredits",
"canUpscale",
"isPublic",
"source",
"createdAt",
"pending_credits",
"links"
],
"properties": {
"id": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"name": {
"type": [
"string",
"null"
]
},
"error": {
"type": [
"string",
"null"
]
},
"links": {
"type": "object",
"required": [
"preview",
"model_glb"
],
"properties": {
"page": {
"type": "string",
"format": "uri"
},
"preview": {
"type": "string",
"format": "uri"
},
"model_glb": {
"type": "string",
"format": "uri"
}
},
"additionalProperties": false
},
"prompt": {
"type": [
"string",
"null"
]
},
"source": {
"enum": [
"web",
"mcp",
"api"
],
"type": "string"
},
"status": {
"enum": [
"drafting",
"preview_ready",
"rendering",
"ready",
"failed"
],
"type": "string"
},
"credits": {
"type": "number",
"minimum": 0
},
"hasModel": {
"type": "boolean"
},
"hasSheet": {
"type": "boolean"
},
"isPublic": {
"type": "boolean"
},
"createdAt": {
"type": "string"
},
"sheetNote": {
"type": [
"string",
"null"
]
},
"canUpscale": {
"type": "boolean"
},
"hasPreview": {
"type": "boolean"
},
"modelVersion": {
"type": "number"
},
"sheetCredits": {
"type": "number",
"minimum": 0
},
"renderCredits": {
"type": "number",
"minimum": 0
},
"upscaleCredits": {
"type": "number",
"minimum": 0
},
"pending_credits": {
"type": "number",
"minimum": 0
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| kind * | string | one of ["sheet","view"] |
| view | string | |
| render_id | string | |
| max_credits * | integer | Maximum credits explicitly authorized for this action |
| view_set_id | string |
{
"name": "upscale_image",
"title": "Upscale a paid image",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"kind",
"max_credits"
],
"properties": {
"kind": {
"enum": [
"sheet",
"view"
],
"type": "string"
},
"view": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"render_id": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"max_credits": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Maximum credits explicitly authorized for this action"
},
"view_set_id": {
"type": "string",
"maxLength": 200,
"minLength": 1
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id",
"kind",
"renderId",
"viewSetId",
"view",
"status",
"hasImage",
"width",
"height",
"credits",
"createdAt",
"links"
],
"properties": {
"id": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"kind": {
"enum": [
"view",
"sheet"
],
"type": "string"
},
"view": {
"type": [
"string",
"null"
]
},
"links": {
"type": "object",
"required": [
"image"
],
"properties": {
"image": {
"type": "string",
"format": "uri"
}
},
"additionalProperties": false
},
"width": {
"type": [
"number",
"null"
]
},
"height": {
"type": [
"number",
"null"
]
},
"status": {
"enum": [
"processing",
"ready",
"failed"
],
"type": "string"
},
"credits": {
"type": "number"
},
"hasImage": {
"type": "boolean"
},
"renderId": {
"type": [
"string",
"null"
]
},
"createdAt": {
"type": "string"
},
"viewSetId": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Read your enlargement’s status and authenticated image URL. Poll every 5–15 seconds until ready or failed.
| Parameter | Type | Description |
|---|---|---|
| id * | string |
{
"name": "get_upscale",
"title": "Get an upscale",
"description": "Read your enlargement’s status and authenticated image URL. Poll every 5–15 seconds until ready or failed.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"maxLength": 200,
"minLength": 1
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id",
"kind",
"renderId",
"viewSetId",
"view",
"status",
"hasImage",
"width",
"height",
"credits",
"createdAt",
"links"
],
"properties": {
"id": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"kind": {
"enum": [
"view",
"sheet"
],
"type": "string"
},
"view": {
"type": [
"string",
"null"
]
},
"links": {
"type": "object",
"required": [
"image"
],
"properties": {
"image": {
"type": "string",
"format": "uri"
}
},
"additionalProperties": false
},
"width": {
"type": [
"number",
"null"
]
},
"height": {
"type": [
"number",
"null"
]
},
"status": {
"enum": [
"processing",
"ready",
"failed"
],
"type": "string"
},
"credits": {
"type": "number"
},
"hasImage": {
"type": "boolean"
},
"renderId": {
"type": [
"string",
"null"
]
},
"createdAt": {
"type": "string"
},
"viewSetId": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| name | string | |
| prompt | string | |
| image_url | string | Public HTTPS JPEG, PNG or WebP URL; up to 4 MiB |
| upload_id | string | Owner-scoped id from authenticated POST /api/uploads; expires after one hour |
| max_credits * | integer | Maximum credits explicitly authorized for this action |
| content_type | string | one of ["image/jpeg","image/png","image/webp"] |
| image_base64 | string | Canonical base64, at most 3129344 decoded bytes; requires content_type |
{
"name": "create_product_views",
"title": "Create product views",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"max_credits"
],
"properties": {
"name": {
"type": "string",
"maxLength": 120
},
"prompt": {
"type": "string",
"maxLength": 500
},
"image_url": {
"type": "string",
"format": "uri",
"maxLength": 4096,
"description": "Public HTTPS JPEG, PNG or WebP URL; up to 4 MiB"
},
"upload_id": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Owner-scoped id from authenticated POST /api/uploads; expires after one hour"
},
"max_credits": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Maximum credits explicitly authorized for this action"
},
"content_type": {
"enum": [
"image/jpeg",
"image/png",
"image/webp"
],
"type": "string"
},
"image_base64": {
"type": "string",
"maxLength": 4172460,
"description": "Canonical base64, at most 3129344 decoded bytes; requires content_type"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id",
"name",
"prompt",
"status",
"error",
"views",
"readyCount",
"viewCount",
"credits",
"polishCredits",
"upscaleCredits",
"buildCredits",
"renderId",
"createdAt",
"links"
],
"properties": {
"id": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"name": {
"type": [
"string",
"null"
]
},
"error": {
"type": [
"string",
"null"
]
},
"links": {
"type": "object",
"required": [
"zip"
],
"properties": {
"zip": {
"type": "string",
"format": "uri"
}
},
"additionalProperties": false
},
"views": {
"type": "array",
"items": {
"type": "object",
"required": [
"view",
"status",
"hasImage",
"version",
"isFlagged",
"problems",
"isPolishing",
"note"
],
"properties": {
"note": {
"type": [
"string",
"null"
]
},
"view": {
"type": "string"
},
"status": {
"type": "string"
},
"version": {
"type": "number"
},
"hasImage": {
"type": "boolean"
},
"problems": {
"type": "array",
"items": {}
},
"isFlagged": {
"type": "boolean"
},
"isPolishing": {
"type": "boolean"
}
},
"additionalProperties": false
}
},
"prompt": {
"type": [
"string",
"null"
]
},
"status": {
"enum": [
"drafting",
"processing",
"ready",
"failed"
],
"type": "string"
},
"credits": {
"type": "number"
},
"renderId": {
"type": [
"string",
"null"
]
},
"createdAt": {
"type": "string"
},
"viewCount": {
"type": "number"
},
"readyCount": {
"type": "number"
},
"buildCredits": {
"type": "number"
},
"polishCredits": {
"type": "number"
},
"upscaleCredits": {
"type": "number"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Read your product-view set’s state, quality flags, follow-up costs and authenticated ZIP URL. Poll until ready or failed.
| Parameter | Type | Description |
|---|---|---|
| id * | string |
{
"name": "get_product_views",
"title": "Get product views",
"description": "Read your product-view set’s state, quality flags, follow-up costs and authenticated ZIP URL. Poll until ready or failed.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"maxLength": 200,
"minLength": 1
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id",
"name",
"prompt",
"status",
"error",
"views",
"readyCount",
"viewCount",
"credits",
"polishCredits",
"upscaleCredits",
"buildCredits",
"renderId",
"createdAt",
"links"
],
"properties": {
"id": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"name": {
"type": [
"string",
"null"
]
},
"error": {
"type": [
"string",
"null"
]
},
"links": {
"type": "object",
"required": [
"zip"
],
"properties": {
"zip": {
"type": "string",
"format": "uri"
}
},
"additionalProperties": false
},
"views": {
"type": "array",
"items": {
"type": "object",
"required": [
"view",
"status",
"hasImage",
"version",
"isFlagged",
"problems",
"isPolishing",
"note"
],
"properties": {
"note": {
"type": [
"string",
"null"
]
},
"view": {
"type": "string"
},
"status": {
"type": "string"
},
"version": {
"type": "number"
},
"hasImage": {
"type": "boolean"
},
"problems": {
"type": "array",
"items": {}
},
"isFlagged": {
"type": "boolean"
},
"isPolishing": {
"type": "boolean"
}
},
"additionalProperties": false
}
},
"prompt": {
"type": [
"string",
"null"
]
},
"status": {
"enum": [
"drafting",
"processing",
"ready",
"failed"
],
"type": "string"
},
"credits": {
"type": "number"
},
"renderId": {
"type": [
"string",
"null"
]
},
"createdAt": {
"type": "string"
},
"viewCount": {
"type": "number"
},
"readyCount": {
"type": "number"
},
"buildCredits": {
"type": "number"
},
"polishCredits": {
"type": "number"
},
"upscaleCredits": {
"type": "number"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| limit | integer |
{
"name": "list_product_views",
"title": "List recent product views",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"view_sets"
],
"properties": {
"view_sets": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"name",
"prompt",
"status",
"error",
"views",
"readyCount",
"viewCount",
"credits",
"polishCredits",
"upscaleCredits",
"buildCredits",
"renderId",
"createdAt",
"links"
],
"properties": {
"id": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"name": {
"type": [
"string",
"null"
]
},
"error": {
"type": [
"string",
"null"
]
},
"links": {
"type": "object",
"required": [
"zip"
],
"properties": {
"zip": {
"type": "string",
"format": "uri"
}
},
"additionalProperties": false
},
"views": {
"type": "array",
"items": {
"type": "object",
"required": [
"view",
"status",
"hasImage",
"version",
"isFlagged",
"problems",
"isPolishing",
"note"
],
"properties": {
"note": {
"type": [
"string",
"null"
]
},
"view": {
"type": "string"
},
"status": {
"type": "string"
},
"version": {
"type": "number"
},
"hasImage": {
"type": "boolean"
},
"problems": {
"type": "array",
"items": {}
},
"isFlagged": {
"type": "boolean"
},
"isPolishing": {
"type": "boolean"
}
},
"additionalProperties": false
}
},
"prompt": {
"type": [
"string",
"null"
]
},
"status": {
"enum": [
"drafting",
"processing",
"ready",
"failed"
],
"type": "string"
},
"credits": {
"type": "number"
},
"renderId": {
"type": [
"string",
"null"
]
},
"createdAt": {
"type": "string"
},
"viewCount": {
"type": "number"
},
"readyCount": {
"type": "number"
},
"buildCredits": {
"type": "number"
},
"polishCredits": {
"type": "number"
},
"upscaleCredits": {
"type": "number"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| render_id | string | |
| view_set_id | string |
{
"name": "list_upscales",
"title": "List picture enlargements",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"render_id": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"view_set_id": {
"type": "string",
"maxLength": 200,
"minLength": 1
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"upscales"
],
"properties": {
"upscales": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"kind",
"renderId",
"viewSetId",
"view",
"status",
"hasImage",
"width",
"height",
"credits",
"createdAt",
"links"
],
"properties": {
"id": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"kind": {
"enum": [
"view",
"sheet"
],
"type": "string"
},
"view": {
"type": [
"string",
"null"
]
},
"links": {
"type": "object",
"required": [
"image"
],
"properties": {
"image": {
"type": "string",
"format": "uri"
}
},
"additionalProperties": false
},
"width": {
"type": [
"number",
"null"
]
},
"height": {
"type": [
"number",
"null"
]
},
"status": {
"enum": [
"processing",
"ready",
"failed"
],
"type": "string"
},
"credits": {
"type": "number"
},
"hasImage": {
"type": "boolean"
},
"renderId": {
"type": [
"string",
"null"
]
},
"createdAt": {
"type": "string"
},
"viewSetId": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| id * | string | |
| note * | string | |
| view * | string | |
| max_credits * | integer | Maximum credits explicitly authorized for this action |
{
"name": "polish_product_view",
"title": "Polish a product view",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id",
"view",
"note",
"max_credits"
],
"properties": {
"id": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"note": {
"type": "string",
"maxLength": 500,
"minLength": 1
},
"view": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"max_credits": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Maximum credits explicitly authorized for this action"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id",
"name",
"prompt",
"status",
"error",
"views",
"readyCount",
"viewCount",
"credits",
"polishCredits",
"upscaleCredits",
"buildCredits",
"renderId",
"createdAt",
"links"
],
"properties": {
"id": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"name": {
"type": [
"string",
"null"
]
},
"error": {
"type": [
"string",
"null"
]
},
"links": {
"type": "object",
"required": [
"zip"
],
"properties": {
"zip": {
"type": "string",
"format": "uri"
}
},
"additionalProperties": false
},
"views": {
"type": "array",
"items": {
"type": "object",
"required": [
"view",
"status",
"hasImage",
"version",
"isFlagged",
"problems",
"isPolishing",
"note"
],
"properties": {
"note": {
"type": [
"string",
"null"
]
},
"view": {
"type": "string"
},
"status": {
"type": "string"
},
"version": {
"type": "number"
},
"hasImage": {
"type": "boolean"
},
"problems": {
"type": "array",
"items": {}
},
"isFlagged": {
"type": "boolean"
},
"isPolishing": {
"type": "boolean"
}
},
"additionalProperties": false
}
},
"prompt": {
"type": [
"string",
"null"
]
},
"status": {
"enum": [
"drafting",
"processing",
"ready",
"failed"
],
"type": "string"
},
"credits": {
"type": "number"
},
"renderId": {
"type": [
"string",
"null"
]
},
"createdAt": {
"type": "string"
},
"viewCount": {
"type": "number"
},
"readyCount": {
"type": "number"
},
"buildCredits": {
"type": "number"
},
"polishCredits": {
"type": "number"
},
"upscaleCredits": {
"type": "number"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| id * | string | |
| max_credits * | integer | Maximum credits explicitly authorized for this action |
{
"name": "build_from_product_views",
"title": "Build 3D from product views",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id",
"max_credits"
],
"properties": {
"id": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"max_credits": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Maximum credits explicitly authorized for this action"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id",
"status",
"prompt",
"name",
"error",
"hasPreview",
"hasSheet",
"sheetNote",
"hasModel",
"modelVersion",
"credits",
"renderCredits",
"sheetCredits",
"upscaleCredits",
"canUpscale",
"isPublic",
"source",
"createdAt",
"pending_credits",
"links"
],
"properties": {
"id": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"name": {
"type": [
"string",
"null"
]
},
"error": {
"type": [
"string",
"null"
]
},
"links": {
"type": "object",
"required": [
"preview",
"model_glb"
],
"properties": {
"page": {
"type": "string",
"format": "uri"
},
"preview": {
"type": "string",
"format": "uri"
},
"model_glb": {
"type": "string",
"format": "uri"
}
},
"additionalProperties": false
},
"prompt": {
"type": [
"string",
"null"
]
},
"source": {
"enum": [
"web",
"mcp",
"api"
],
"type": "string"
},
"status": {
"enum": [
"drafting",
"preview_ready",
"rendering",
"ready",
"failed"
],
"type": "string"
},
"credits": {
"type": "number",
"minimum": 0
},
"hasModel": {
"type": "boolean"
},
"hasSheet": {
"type": "boolean"
},
"isPublic": {
"type": "boolean"
},
"createdAt": {
"type": "string"
},
"sheetNote": {
"type": [
"string",
"null"
]
},
"canUpscale": {
"type": "boolean"
},
"hasPreview": {
"type": "boolean"
},
"modelVersion": {
"type": "number"
},
"sheetCredits": {
"type": "number",
"minimum": 0
},
"renderCredits": {
"type": "number",
"minimum": 0
},
"upscaleCredits": {
"type": "number",
"minimum": 0
},
"pending_credits": {
"type": "number",
"minimum": 0
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}Names, descriptions and schemas were written by the server and are shown as data.
Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators.