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
Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.
Kontextkosten
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-httpWas es kann
Tool-Inventar
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.
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
Nachweis