Quickstart - AI Gen Studio

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

1. Set your key

export AIGEN_API_KEY="aigs_sandbox_..."

2. List tools

curl https://aigenstudio.app/api/v1/tools

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

3. Create a job

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

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.