Quickstart

In this guide, you will submit a toy sports car generation, wait for it to complete, and download its USD asset. You need a Moonlake account and a reference image saved locally as reference.png.

Get an API key

Create a key in your account settings. Each account has one active key; regenerating it immediately revokes the old key. Store the key in an environment variable:

export MOONLAKE_API_KEY="your_api_key"

Every request authenticates with it:

Authorization: Bearer <your key>

Create an asset

Send a text prompt and your image to POST /api/v1/assets. mode=generate is what runs the generation; in its default quote mode the endpoint returns a price quote and generates nothing.

curl -X POST https://app.moonlakeai.com/api/v1/assets \
  -H "Authorization: Bearer $MOONLAKE_API_KEY" \
  -F 'input={
    "prompt": "a red toy sports car with black wheels",
    "references": [{"source": "attached", "name": "reference_0"}]
  };type=application/json' \
  -F 'reference_0=@reference.png' \
  -F 'mode=generate'

import json
import os

import requests

generation_input = {
    "prompt": "a red toy sports car with black wheels",
    "references": [{"source": "attached", "name": "reference_0"}],
}
with open("reference.png", "rb") as reference_file:
    response = requests.post(
        "https://app.moonlakeai.com/api/v1/assets",
        headers={"Authorization": f"Bearer {os.environ['MOONLAKE_API_KEY']}"},
        data={"input": json.dumps(generation_input), "mode": "generate"},
        files={"reference_0": reference_file},
    )
generation = response.json()
asset_id = generation["id"]

The API returns immediately with the generation in pending status. Save its id; you use it to retrieve the result.

Wait for completion

Generations usually complete within a few hours. Duration depends on the asset’s complexity, the supplied references, and the selected effort level. Poll the asset every 30–60 seconds until its status is completed or failed:

curl

curl https://app.moonlakeai.com/api/v1/assets/{asset_id} \
  -H "Authorization: Bearer $MOONLAKE_API_KEY"

When status is completed, result.artifacts contains a presigned download_url for every output. Download the artifact with format: "usdz", extract the ZIP, and open its *_root.usda file in Isaac Sim.

A download_url expires after seven days. Fetch the asset again to receive freshly signed URLs.

Get started

Guides

Reference

Get an API key

Create an asset

Wait for completion

Next steps

​Get an API key

​Create an asset

​Wait for completion

​Next steps

Get an API key

Create an asset

Wait for completion

Next steps