vendor_fabric.meshy.image3d

Image-to-3D API.

Usage: from vendor_fabric.meshy import image3d

result = image3d.generate("https://example.com/image.png")
print(result["model_urls"]["glb"])

Module Contents

Functions

create

Create image-to-3d task. Returns task_id.

get

Get task status.

refine

Refine preview to full quality. Returns new task_id.

poll

Polls the status of an image-to-3D task until it completes, fails, expires, or times out.

generate

Generate a 3D model from an image.

API

vendor_fabric.meshy.image3d.create(request: vendor_fabric.meshy.models.Image3DRequest) extended_data.containers.ExtendedString

Create image-to-3d task. Returns task_id.

vendor_fabric.meshy.image3d.get(task_id: str) extended_data.containers.ExtendedDict

Get task status.

vendor_fabric.meshy.image3d.refine(task_id: str) extended_data.containers.ExtendedString

Refine preview to full quality. Returns new task_id.

vendor_fabric.meshy.image3d.poll(task_id: str, interval: float = 5.0, timeout: float = 600.0) extended_data.containers.ExtendedDict

Polls the status of an image-to-3D task until it completes, fails, expires, or times out.

Args: task_id: The ID of the image-to-3D task to poll. interval: Time in seconds between polling attempts (default: 5.0). timeout: Maximum time in seconds to wait for task completion (default: 600.0).

Returns: Extended payload for the completed task.

Raises: RuntimeError: If the task fails or expires. TimeoutError: If the polling times out before the task completes.

vendor_fabric.meshy.image3d.generate(image_url: str, *, topology: str | None = None, target_polycount: int | None = None, enable_pbr: bool = True, wait: bool = True) extended_data.containers.ExtendedDict | extended_data.containers.ExtendedString

Generate a 3D model from an image.

Args: image_url: URL to the source image topology: Mesh topology (“quad” or “triangle”) target_polycount: Target polygon count enable_pbr: Enable PBR materials wait: Wait for completion (default True)

Returns: Extended result payload if wait=True, extended task_id if wait=False.