---
title: "Quickstart"
description: "Mint an API key, submit your first conversion, poll for completion, and download a SimReady USD — in five minutes."
---

import { Steps, Tabs, TabItem, Aside } from '@astrojs/starlight/components';

This guide takes you from zero to a downloaded SimReady USD in five minutes.

<Steps>

1. **Create an account and mint an API key.**

   Sign up at **[app.rigyd.com](https://app.rigyd.com)**, then go to **Settings → API Keys** and click **Create key**. Copy the `rgyd_live_...` token — you only see it once.

   <Aside type="caution">
     Treat the key like a password. It can spend your credits.
   </Aside>

2. **Submit a conversion.**

   Send any 3D file you have. `glb` is the fastest path because it skips preprocessing.

   <Tabs syncKey="lang">
     <TabItem label="curl">
     ```bash
     curl -X POST https://api.rigyd.com/api/conversions \
       -H "Authorization: Bearer rgyd_live_..." \
       -F "file=@./model.glb"
     ```
     </TabItem>
     <TabItem label="JavaScript">
     ```js
     const form = new FormData();
     form.append('file', new Blob([await fs.readFile('model.glb')]), 'model.glb');

     const res = await fetch('https://api.rigyd.com/api/conversions', {
       method: 'POST',
       headers: { Authorization: 'Bearer rgyd_live_...' },
       body: form,
     });
     const { data } = await res.json();
     console.log(data.id); // → "abc123..."
     ```
     </TabItem>
     <TabItem label="Python">
     ```python
     import requests

     with open("model.glb", "rb") as f:
         res = requests.post(
             "https://api.rigyd.com/api/conversions",
             headers={"Authorization": "Bearer rgyd_live_..."},
             files={"file": ("model.glb", f, "model/gltf-binary")},
         )
     job_id = res.json()["data"]["id"]
     ```
     </TabItem>
   </Tabs>

   You get back `202 Accepted`:

   ```json
   {
     "data": {
       "id": "abc123...",
       "status": "queued",
       "filename": "model.glb",
       "progress": 0,
       "job_type": "glb_to_simready",
       "credits_charged": 1,
       "createdAt": "2026-05-06T12:00:00.000Z"
     }
   }
   ```

3. **Poll until it's done.**

   ```bash
   curl https://api.rigyd.com/api/conversions/abc123... \
     -H "Authorization: Bearer rgyd_live_..."
   ```

   Status moves through `submitting → preprocessing → queued → running → completed | failed`. Most jobs finish in under two minutes. See [Job lifecycle](/reference/job-lifecycle) for the full payload shape.

4. **Download the result.**

   ```bash
   curl -L "https://api.rigyd.com/api/conversions/abc123.../result?format=usd" \
     -H "Authorization: Bearer rgyd_live_..." \
     -o simready.zip
   ```

   The ZIP contains a `.usd` and its textures. Drop it into Isaac Sim, MuJoCo, or any USD-aware tool.

</Steps>

## Next steps

- **Try the other modes**: [2D → SimReady](/conversions/2d-to-simready), [Text → SimReady](/conversions/text-to-simready), [Simulate](/conversions/simulate)
- **Build a long-running integration**: read [Job lifecycle](/reference/job-lifecycle) for the full status flow and `preprocess` component shape
- **Hand this site to your AI agent**: point it at [`https://docs.rigyd.com/llms-full.txt`](https://docs.rigyd.com/llms-full.txt)