Generate

Image → 3D

POST/v1/models/from-image

Turn any image — including your own generations — into a textured, game-ready mesh.

Pass an imageUrl (JSON) or upload the file (multipart image). Exactly one is required.

Parameters

Parameter	Description
imageUrl string	Source image URL. Required unless a multipart `image` file is sent.
engine string	e.g. `tripo`, `hunyuan-3.1`.
polycount · texture int · bool	As for Text → 3D.

Request

multipart upload

curl -X POST https://api.picoberry.ai/v1/models/from-image \
  -H "Authorization: Bearer pb_live_xxx" \
  -F "engine=tripo" -F "image=@./ref.png"

requests.post("https://api.picoberry.ai/v1/models/from-image", headers=headers,
    data={"engine": "tripo"}, files={"image": open("ref.png", "rb")})

const fd = new FormData();
fd.append("engine", "tripo"); fd.append("image", fileBlob, "ref.png");
await fetch(`${BASE}/v1/models/from-image`, { method: "POST", headers, body: fd });

Image inputs Single-frame png, jpeg, webp, or gif, up to 20 MB. URLs are fetched server-side and must be publicly reachable.