The lumaapi-python from lumalabs

lumaapi-python's Introduction

Luma API Python client

WARNING: We are no longer actively supporting this capture API. For Genie API, please contact us for information.

Installation

pip install lumaapi

Docs

https://lumalabs.ai/luma-api/client-docs/index.html

To build docs: go to docs/ and

make html

Need to install requirements first time (pip install -r docs/requirements.txt)

Release

First install deps pip install python-build twine

Then update the version in pyproject.toml and

python -m build
twine upload dist/lumaapi-<x.x.x>.tar.gz

For Luma employees: Please get the password from 1Password (search PyPI)

CLI usage

To submit a video: luma submit <path> <title>, where path can be a video, zip, or directory.
- This outputs a slug.
To check status of the capture: luma status <slug>
To search user's captures: luma get <title>
To manually authenticate: luma auth (CLI will also prompt when required)
To check for credits: luma credits

Library usage

from lumaapi import LumaClient
client = LumaClient(api_key)
slug = client.submit(video_path, title)
print(client.status(slug))

Then use functions corresponding to the CLI

lumaapi-python's People

Contributors

Stargazers

Watchers

lumaapi-python's Issues

Failure

Here is my shell history

(/projects/gitlab/aiml/lumatest/env) sam@skylab:/projects/gitlab/aiml/lumatest$ luma credits
remaining: 10
used:      0
total:     10
(/projects/gitlab/aiml/lumatest/env) sam@skylab:/projects/gitlab/aiml/lumatest$ luma submit AIML_lab_colmap.zip "AIML_Lab"
Capture data {'title': 'AIML_Lab', 'camModel': 'normal'}
Created capture 0fd4a6c1-c36e-477f-b83f-dac1fd0c963b
Uploading
Triggering
Submitted 0fd4a6c1-c36e-477f-b83f-dac1fd0c963b
0fd4a6c1-c36e-477f-b83f-dac1fd0c963b
(/projects/gitlab/aiml/lumatest/env) sam@skylab:/projects/gitlab/aiml/lumatest$ luma status 0fd4a6c1-c36e-477f-b83f-dac1fd0c963b
title:     AIML_Lab
type:      reconstruction
location:  null
privacy:   unlisted
date:      2024-05-09T04:11:15.000Z
username:  samhodge
status:    complete
slug:      0fd4a6c1-c36e-477f-b83f-dac1fd0c963b
latestRun: {"status": "new", "progress": 0, "currentStage": "Queued", "artifacts": [], "pipelineVersion": 2}
uuid:      0fd4a6c1-c36e-477f-b83f-dac1fd0c963b
(/projects/gitlab/aiml/lumatest/env) sam@skylab:/projects/gitlab/aiml/lumatest$ luma status 0fd4a6c1-c36e-477f-b83f-dac1fd0c963b
title:     AIML_Lab
type:      reconstruction
location:  null
privacy:   unlisted
date:      2024-05-09T04:11:15.000Z
username:  samhodge
status:    complete
slug:      0fd4a6c1-c36e-477f-b83f-dac1fd0c963b
latestRun: {"status": "dispatched", "progress": 0, "currentStage": "Preprocessing", "artifacts": [], "pipelineVersion": 2}
uuid:      0fd4a6c1-c36e-477f-b83f-dac1fd0c963b
(/projects/gitlab/aiml/lumatest/env) sam@skylab:/projects/gitlab/aiml/lumatest$ luma credits
remaining: 9
used:      1
total:     10
(/projects/gitlab/aiml/lumatest/env) sam@skylab:/projects/gitlab/aiml/lumatest$ luma status 0fd4a6c1-c36e-477f-b83f-dac1fd0c963b
title:     AIML_Lab
type:      reconstruction
location:  null
privacy:   unlisted
date:      2024-05-09T04:11:15.000Z
username:  samhodge
status:    complete
slug:      0fd4a6c1-c36e-477f-b83f-dac1fd0c963b
latestRun: {"status": "failed", "progress": 100, "currentStage": "Failed", "artifacts": [], "errorReason": "Our pipeline failed due to internal issues. Please report to our team.", "pipelineVersion": 2}
uuid:      0fd4a6c1-c36e-477f-b83f-dac1fd0c963b

Recommend Projects