Generate 3D Model (Popcraft)
popcraft_generate_3dGenerate a 3D mesh (GLB) with Tripo3D from a reference image (image-to-3D) or a text prompt (text-to-3D). Use when the user wants a 3D model, mesh, game asset, printable object, VTuber/character base, or "turn this picture into 3D". Pass image_url (a GCS url from popcraft_media_import_url, popcraft_media_upload, or a prior popcraft_generate_image result) for image-to-3D — a single clean subject on a plain background, front or 3/4 view, works best; for a character use an A-pose/T-pose front view. Omit image_url and pass prompt for text-to-3D. Defaults: model_version "tripo-v2.5" (best quality/cost), texture true, pbr true, quad false (triangles — set true for a quad mesh that is easier to edit/rig in Blender; Tripo then returns FBX), geometry_quality/texture_quality "standard" ("detailed" costs more). smart_low_poly produces a game-ready low-poly mesh. style applies a Tripo preset (e.g. "person:person2cartoon", "object:clay", "object:steampunk") — list them via popcraft_models_explore with type:"3d". Set get_cost:true to preflight the exact credit cost WITHOUT submitting — always do this the first time so the user can confirm. Generation takes ~1–3 minutes. On success an interactive result card is shown and refreshes itself — do NOT poll in a loop; call popcraft_job_display at most once if no card is visible. The finished result URL is a downloadable GLB (or FBX when quad=true) that also appears on the Popcraft /model-3d workspace, where it can be refined further with popcraft_postprocess_3d (retopology, retexture, stylize, mesh completion, format conversion). The result includes project — mention where it was saved when the user did not pick a project. Never tell the user how long the job will take or quote any estimate of generation time — the result card shows progress.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| pbr | No | Generate PBR material maps (default true; requires texture) | |
| quad | No | Quad topology instead of triangles (default false). Better for editing/rigging in Blender; output becomes FBX. | |
| style | No | Optional Tripo style preset id, e.g. "person:person2cartoon", "object:clay" — see popcraft_models_explore type:"3d" | |
| prompt | No | Text prompt (required for text-to-3D; optional refinement hint with an image). Max 500 chars. | |
| texture | No | Generate textures (default true). false = white untextured mesh, cheaper. | |
| get_cost | No | true = return the exact credit cost WITHOUT submitting | |
| image_url | No | Reference image as a GCS https URL (from popcraft_media_import_url / popcraft_media_upload / a prior result) or gs:// URI. Omit for text-to-3D. | |
| face_limit | No | Target face count, 1000–50000. Omit for adaptive. | |
| project_id | No | File the result into this Popcraft project (id from popcraft_projects). Omit to use the user's current/last-used project (or a default). | |
| project_name | No | File the result into the project with this title, creating it if needed. Ignored when project_id is set. | |
| model_version | No | Tripo model version — default "tripo-v2.5"; "tripo-p1" is premium quality, "tripo-turbo" is fastest/cheapest | |
| smart_low_poly | No | Game-ready low-poly output (default false) | |
| negative_prompt | No | What to avoid in the model | |
| texture_quality | No | Texture detail — default "standard" | |
| geometry_quality | No | Geometry detail — default "standard" |