Post-process

Texture

POST/v1/assets/{id}/texture

Re-generate PBR materials on an existing asset, from a prompt or a reference image.

Parameters

ParameterDescription
prompt
string
Text texture prompt, up to 1,000 characters. Omit to re-texture from the model.
engine
string
tripo-texture, meshy-texture, hunyuan-texture.
image
file
Optional multipart reference image (switches to image-guided texturing).

Request

request
curl -X POST https://api.picoberry.ai/v1/assets/019…/texture \
  -H "Authorization: Bearer pb_live_xxx" -H "Content-Type: application/json" \
  -d '{"engine":"tripo-texture","prompt":"weathered bronze with green patina"}'
requests.post(f"{BASE}/v1/assets/{id}/texture", headers=headers,
    json={"engine": "tripo-texture", "prompt": "weathered bronze"})
await fetch(`${BASE}/v1/assets/${id}/texture`, { method: "POST",
  headers: { ...headers, "Content-Type": "application/json" },
  body: JSON.stringify({ engine: "tripo-texture", prompt: "weathered bronze" }) });

Image-guided

Omit prompt and send multipart/form-data with an image part (≤20 MB) to re-texture from a reference image instead of text — no hosting needed.

multipart
curl -X POST https://api.picoberry.ai/v1/assets/019…/texture \
  -H "Authorization: Bearer pb_live_xxx" \
  -F "engine=tripo-texture" -F "image=@./ref.png"