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

# Quickstart

> Create your first sandbox image job.

This guide creates a sandbox ad-creative job, then reads the result.

## 1. Set your key

```bash theme={"theme":{"light":"github-light","dark":"github-light"}}
export AIGEN_API_KEY="aigs_sandbox_..."
```

## 2. List tools

```bash theme={"theme":{"light":"github-light","dark":"github-light"}}
curl https://aigenstudio.app/api/v1/tools
```

The response includes tool ids, endpoints, public credit costs, units, and descriptions.

## 3. Create a job

```bash theme={"theme":{"light":"github-light","dark":"github-light"}}
curl -X POST https://aigenstudio.app/api/v1/ad/create \
  -H "Authorization: Bearer $AIGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: quickstart-ad-001" \
  -d '{
    "input": [
      {
        "image_url": "https://example.com/product.jpg",
        "external_id": "product-001"
      }
    ],
    "creative": {
      "platform": "Instagram",
      "goal": "product launch",
      "style": "premium campaign"
    },
    "output": {
      "format": "png"
    }
  }'
```

Save `job.id` from the response.

## 4. Read status

```bash theme={"theme":{"light":"github-light","dark":"github-light"}}
curl https://aigenstudio.app/api/v1/jobs/f693e677-51e0-4ebe-80a0-ad06acbc4443 \
  -H "Authorization: Bearer $AIGEN_API_KEY"
```

Sandbox status responses use the same shape as live status responses, but the result URLs are simulated.