model_urlstringrequired
3D model to texture: .glb, .gltf, .obj, .fbx or .stl URL.
Meshy 6 Retexture
meshy/6.0/retextureMeshy 6 Retexture repaints an existing 3D model from a text or image style, with optional PBR maps and up to 8K textures.
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.
Base color resolution. 8k costs more; at 8k PBR maps are 4k. Allowed values: 2k, 4k, 8k.
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 Retexture
Meshy 6 Retexture repaints an existing 3D model from a text or image style, with optional PBR maps and up to 8K textures.
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. |
texture_resolution | 2k / 4k / 8k | 2k | Base color resolution; 8k costs more and its PBR maps are 4k. |
enable_pbr | boolean | false | Also generate metallic, roughness and normal maps. |
enable_original_uv | boolean | true | Keep the model's UV layout. |
Billing
$0.33 per retextured model at 2k or 4k, $0.50 at 8k; PBR maps are included.
| Request | Price |
|---|---|
| 2k (default) | $0.33 |
| 4k + PBR | $0.33 |
| 8k | $0.50 |
| 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
Other retexture models: meshy/7.0/retexture, meshy/6.0-lite/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/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,
"texture_resolution": "2k"
}
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
texture_resolutionstring
Base color resolution. 8k costs more; at 8k PBR maps are 4k.
Default: "2k"
Possible values: "2k", "4k", "8k"
{
"model": "meshy/6.0/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,
"texture_resolution": "2k"
}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.