easyrender
Remote image-to-3D MCP: preview a product photo, then build a textured GLB with account credits.
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"easyrender": {
"url": "https://easyrender.ai/api/mcp"
}
}
}Remote endpoints
https://easyrender.ai/api/mcpstreamable-httpWhat it can do
Tool inventory
Tools (16)
🟡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.
Input 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#"
}Output 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.
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 200
}
},
"required": [
"id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output 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.
Input 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#"
}Output 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.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}Output 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.
Input 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#"
}Output 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.
Input 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#"
}Output 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.
Input 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#"
}Output 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.
Input 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#"
}Output 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.
Input 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#"
}Output 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.
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 200
}
},
"required": [
"id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output 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.
Input 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#"
}Output 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.
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 200
}
},
"required": [
"id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output 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.
Input Schema
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}Output 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.
Input 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#"
}Output 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.
Input 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#"
}Output 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.
Input 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#"
}Output 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
Evidence