model_urlstringrequired
3D model to texture: .glb, .gltf, .obj, .fbx or .stl URL.
Meshy 6 Lite Retexture
meshy/6.0-lite/retextureMeshy 6 Lite Retexture is the lower-cost Meshy retexturing model: repaint an existing 3D model from a text or image style.
Try the model
Playground
Input
3D model to texture: .glb, .gltf, .obj, .fbx or .stl URL.
Additional Settings More
Customize your input with more control.
Describe the texture style, up to 600 characters. Required when image_style_url is not set.
PNG, JPEG, WebP, or GIF · 20 MiB maximum
2D image that guides the texture (JPG or PNG). Takes precedence over text_style_prompt.
Also generate metallic, roughness and normal maps.
Use the model's existing UV layout instead of generating new UVs.
ResultIdle
Your output will appear here
Complete the inputs, then click Run.
Meshy 6 Lite Retexture
Meshy 6 Lite Retexture is the lower-cost Meshy retexturing model: repaint an existing 3D model from a text or image style.
Fields
| Field | Type | Default | Notes |
|---|---|---|---|
model_url | 3D model URL, required | — | .glb, .gltf, .obj, .fbx or .stl. |
text_style_prompt | string | — | Texture style, up to 600 characters. Required when image_style_url is not set. |
image_style_url | image URL | — | JPG or PNG style reference; takes precedence over the text prompt. |
enable_pbr | boolean | false | Also generate metallic, roughness and normal maps. |
enable_original_uv | boolean | true | Keep the model's UV layout. |
Billing
$0.36 per retextured model; PBR maps are included.
| Request | Price |
|---|---|
| Retexture | $0.36 |
| Retexture + PBR | $0.36 |
| Failed runs are not charged. |
Prompting
- Name materials and finish, e.g. "weathered bronze with green patina".
- Provide either
text_style_promptorimage_style_url.
Also on SandBase
Higher-detail retexture models: meshy/7.0/retexture, meshy/6.0/retexture.
Start building
Send your first request
Submit this model through the SandBase Unified Run API.
# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
-X POST "https://api.sandbase.ai/v1/run" \
-H "Authorization: Bearer $SANDBASE_API_KEY" \
-H "Content-Type: application/json" \
--data-binary @- <<'SANDBASE_JSON'
{
"model": "meshy/6.0-lite/retexture",
"model_url": "https://v3b.fal.media/files/b/penguin/DId89qXLu6BXu09RFAwAV_model.glb",
"enable_pbr": false,
"text_style_prompt": "red and black chest",
"enable_original_uv": true
}
SANDBASE_JSON
)
run_id=$(printf '%s' "$result" | jq -r .id)
for attempt in $(seq 1 120); do
status=$(printf '%s' "$result" | jq -r .status)
case "$status" in completed|failed|timeout) break ;; esac
sleep 2
result=$(curl --fail-with-body --silent \
-H "Authorization: Bearer $SANDBASE_API_KEY" \
"https://api.sandbase.ai/v1/run/$run_id")
done
status=$(printf '%s' "$result" | jq -r .status)
[ "$status" = completed ] || { echo "Generation ended: $status" >&2; exit 1; }
printf '%s\n' "$result"2. Authentication
Create a SandBase API key and set it in your server environment. All requests use Bearer authentication.
export SANDBASE_API_KEY="YOUR_API_KEY"Keep the key on your server. Do not expose it in browser code or commit it to a repository.
3. Queue
Submit a request
POST to /v1/run with this model ID and its inputs. The request example above includes submission and polling.
Fetch request status and result
Use the returned run ID to poll until the status is completed, failed or timeout. Read output only after completed.
curl "https://api.sandbase.ai/v1/run/$RUN_ID" \
-H "Authorization: Bearer $SANDBASE_API_KEY"4. Files
Hosted files
Pass a publicly accessible file URL in the model’s image, video or audio field. Supported formats and limits are shown beside each Playground input.
Uploading images
Use the upload or replace control on supported image fields in the Playground. Video URL fields accept a hosted driving video; they do not imply video-upload support.
5. Schema
Input
enable_pbrboolean
Also generate metallic, roughness and normal maps.
Default: false
image_style_urlstring
2D image that guides the texture (JPG or PNG). Takes precedence over text_style_prompt.
text_style_promptstring
Describe the texture style, up to 600 characters. Required when image_style_url is not set.
enable_original_uvboolean
Use the model's existing UV layout instead of generating new UVs.
Default: true
{
"model": "meshy/6.0-lite/retexture",
"model_url": "https://v3b.fal.media/files/b/penguin/DId89qXLu6BXu09RFAwAV_model.glb",
"enable_pbr": false,
"text_style_prompt": "red and black chest",
"enable_original_uv": true
}Output
A completed run exposes its result in output. The following is the model’s saved example, not a new generation.
No example output has been published yet. Use Playground → Result → JSON after a completed run to inspect your response.