> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Luma

> How to set up the Luma connector, plus the actions that are available.

![Luma](data:image/svg+xml,%3Csvg%20xmlns%3D%22http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%22%20viewBox%3D%220%200%2024%2024%22%3E%3Crect%20width%3D%2224%22%20height%3D%2224%22%20rx%3D%228%22%20fill%3D%22%23D5D4D2%22%2F%3E%3Crect%20x%3D%228%22%20y%3D%228%22%20width%3D%228%22%20height%3D%228%22%20rx%3D%222.667%22%20fill%3D%22%23A19F9E%22%2F%3E%3C%2Fsvg%3E)

Previewv0.1.0[See changelog](https://docs.stackone.com/connectors/luma/changelog.md)

[12 actions](#actions) · 1 auth method

## Getting Started

**1. Create or Select a Project**

Set up a new project or select an existing one. See [Organizations & Projects](https://docs.stackone.com/gateway/concepts/organizations-and-projects.md).

**2. Configure the Connector**

Enable the connector and create a Connector Profile in your project. See [Setup Connector Profile](https://docs.stackone.com/gateway/quickstart.md#setup-connector-profile).

> [card] [API Key · Connector Profile](https://docs.stackone.com/connectors/luma/guides/connector-profile/api-key.md)
>
> No app registration required. The key belongs to your Luma API client, so every key of that client shares its quota and...

**3. Link an Account**

Link an account [from the dashboard](https://docs.stackone.com/connect/managing-connectors/linking-accounts.md#link-from-the-dashboard) (or via [StackOne Hub](https://docs.stackone.com/embed/account-linking/overview)).

See the guide for the authentication type chosen in the Connector Profile:

> [card] [API Key · Link Account](https://docs.stackone.com/connectors/luma/guides/link-account/api-key.md)

**4. Use Actions**

Connect an AI platform to the linked account's actions. See [AI Platforms](https://docs.stackone.com/ai-platforms/overview.md).

Other ways to call actions are listed in [Protocols & SDKs](https://docs.stackone.com/connect/protocols-and-sdks.md).

## Actions

12 actions

ActionDescription

Get Credits`luma_get_credits`

Get the team's current credit balance

List Files`luma_list_files`

List uploaded files, newest first

Get File`luma_get_file`

Get one uploaded file's metadata and state

Upload File`luma_upload_file`

Upload a small file inline so generations can reference it by file\_id

Create File`luma_create_file`

Request a presigned upload URL for a large file

Complete File Upload`luma_complete_file_upload`

Finalize a presigned upload after the bytes have been PUT

Delete File`luma_delete_file`

Permanently delete an uploaded file

Create Generation`luma_create_generation`

Submit an async image or video generation, edit, reframe or layering job

Get Generation`luma_get_generation`

Get a generation's state, output URLs and cost

Delete Generation`luma_delete_generation`

Request asynchronous deletion of a finished generation and its outputs

Get Deletion`luma_get_deletion`

Get the status of a generation deletion task

Get Usage`luma_get_usage`

Report settled credit spend for a time window, optionally grouped


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.