Introduction

The adcreator.ai API lets you generate AI product photos and videos, manage credits, upload reference images, and list your generations — all programmatically. It is a standard REST API that returns JSON responses.

https://adcreator.ai/api/platform

All endpoints require an API key. You can create and manage keys in your Settings.

Authentication

Authenticate every request by including your API key in the Authorization header as a Bearer token.

Authorization: Bearer sk_live_...

Create API keys in Settings → API Keys. Keys are shown only once at creation — store them securely. Requests without a valid key receive a 401 response.

Retrieve your current credit balance and lifetime usage stats.

Response

{
  "balance": 142,
  "lifetimePurchased": 500,
  "lifetimeUsed": 358,
  "unlimited": false
}

List all available image generation models and supported aspect ratios. The aspect ratio dimensions returned are based on your subscription tier's resolution level.

Response

{
  "models": [
    {
      "id": "nano-banana-2",
      "displayName": "Nano Banana 2",
      "creditsCost": 3,
      "estimatedSeconds": 8,
      "supportsImageInput": true,
      "maxWidth": 2048,
      "maxHeight": 2048
    }
  ],
  "resolutionTier": "max",
  "aspectRatios": [
    { "id": "1:1", "label": "Square (1:1)", "width": 2048, "height": 2048 },
    { "id": "16:9", "label": "Landscape (16:9)", "width": 1920, "height": 1080 }
  ]
}

List all available video generation models, durations, and credit costs.

Response

List all available style presets. Pass a style id as the stylePreset parameter when generating an image.

Response

Upload a reference image to use as input for image generation. Supports multipart/form-data (with a file field) or raw binary with the MIME type as Content-Type. Max file size: 10 MB. Allowed types: PNG, JPEG, WebP.

Response (201 Created)

curl -X POST https://adcreator.ai/api/platform/upload \
  -H "Authorization: Bearer sk_live_..." \
  -F "file=@product.jpg"

{
  "path": "user_123/1709012345-a1b2c3.jpg",
  "publicUrl": "https://...supabase.co/storage/v1/.../product.jpg"
}

Start an image generation job. Returns immediately with a 202 Accepted status. Poll GET /generations/:id for the result.

Request Body (JSON)

Response (202 Accepted)

curl -X POST https://adcreator.ai/api/platform/generate \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Luxury perfume bottle on marble surface, soft studio lighting",
    "modelId": "nano-banana-2",
    "aspectRatio": "1:1",
    "stylePreset": "studio-product"
  }'

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "processing"
}

Retrieve a paginated list of your image generations.

Query Parameters

Response

Returns an array of generation objects with id, status, prompt, model_id, image_url, created_at, and more.

Retrieve a single generation by ID. Use this to poll for completion after starting a generation.

Response

curl https://adcreator.ai/api/platform/generations/GEN_ID \
  -H "Authorization: Bearer sk_live_..."

Permanently delete a generation and its associated image.

Response

Start a video generation from an existing image generation. Returns 202 Accepted. Poll GET /videos/:id for the result.

Request Body (JSON)

Response (202 Accepted)

curl -X POST https://adcreator.ai/api/platform/videos \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "sourceGenerationId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "prompt": "Smooth camera orbit around the product",
    "modelId": "kling-v3-pro",
    "durationSeconds": 5
  }'

Retrieve a single video generation by ID. Use this to poll for video completion.

Response

curl https://adcreator.ai/api/platform/videos/VIDEO_ID \
  -H "Authorization: Bearer sk_live_..."