Video Upload

You can upload a video to use the Photogrammetry algorithm. The video resolution must not exceed 1920x1080, and the duration should be no longer than 3 minutes.

Request

curl --location --request POST 'https://api.kiriengine.app/api/v1/open/photo/video' \
--header 'Authorization: Bearer ${YOUR_API_KEY}'\
--form 'videoFile=@"/file/video.mp4"' \
--form 'modelQuality=""1' \
--form 'textureQuality="1"' \
--form 'fileFormat="OBJ"' \
--form 'isMask="1"'\
--form 'textureSmoothing="1"'

Response

{
    "code": 0,
    "msg": "string",
    "data": {
        "serialize": "796a6f52457844b4918db3eadd64becc",
        "calculateType":1
    },
    "ok": true
}

Attributes

properties	type	description
videoFile	File	Video files
modelQuality	Integer	Default: 0 (0: High, 1: Medium, 2: Low, 3: Ultra)
textureQuality	Integer	Default: 0 (0: 4K, 1: 2K, 2: 1K, 3: 8K)
isMask	Integer	Default: 0 (0: Turn off Auto Object Masking, 1: Turn on Auto Object Masking)
serialize	String	Unique identifier for the task
calculateType	Integer	1: Photo Scan, 2: Featureless Object Scan, 3: 3DGS Scan
textureSmoothing	Integer	Default: 0: Turn off Texture Smoothing, 1: Turn on Texture Smoothing (Texture Smoothing improves the texture quality of blurry areas and produces more coherent texture maps. It may also reduce the overall sharpness of the textures. It's recommended to turn this off when when using for professional use that requires precise Photo Scans)
fileFormat	String	Generated model format (obj, fbx, stl, ply, glb, gltf, usdz, xyz)