Quickstart - AdSkull API

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

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

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.

{
  "error": {
    "code": "insufficient_credits",
    "message": "Not enough credits for this request.",
    "request_id": "req_01HX...",
    "details": {
      "credits_required": 50,
      "credits_available": 12
    }
  }
}