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

# Quickstart

> Create your first AdSkull API job and poll until the asset is ready.

## 1. Create An API Key

Open AdSkull, go to `API`, then create a key with the scopes your integration needs.

The key is shown once. Store it in your secret manager or server environment.

## 2. Create An Image Job

```bash theme={"theme":"github-dark"}
curl https://api.adskull.io/v1/image-generations \
  -H "Authorization: Bearer $ADSKULL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: image-demo-001" \
  -d '{
    "prompt": "A premium skincare bottle on a clean bathroom counter, soft morning light, ecommerce ad style",
    "model_id": "nano-banana-pro",
    "quality": "1K",
    "ratio": "3:4",
    "count": 1
  }'
```

## 3. Poll The Job

```bash theme={"theme":"github-dark"}
curl https://api.adskull.io/v1/image-generations/job_01HX... \
  -H "Authorization: Bearer $ADSKULL_API_KEY"
```

When the job is complete, the response includes `assets` with downloadable URLs.

## 4. Handle Errors

All errors use the same envelope.

```json theme={"theme":"github-dark"}
{
  "error": {
    "code": "insufficient_credits",
    "message": "Not enough credits for this request.",
    "request_id": "req_01HX...",
    "details": {
      "credits_required": 50,
      "credits_available": 12
    }
  }
}
```