Documentation

API Reference

The PROMPTLESS API lets you generate AI-staged product images and videos from a product image URL and name. No prompts required.

Base URLhttps://api.promptless.boltedge.io

Authentication

All API requests require a Bearer token in the Authorization header. Your API key is provided at checkout and emailed to you.

Authentication header

Authorization: Bearer YOUR_API_KEY

Keep your API key secret. Never expose it in client-side code, browser JavaScript, or public repositories.

POST

/generate

Submit a product image for AI staging. Returns a job ID that you can use to poll for results.

Request Body

Field	Type	Required	Description
productImage	string	Yes	Public URL of the product image (JPG, PNG, WebP)
productName	string	Yes	Name of the product (helps guide scene context)
hints	string[]	No	Array of style hints to guide generation (e.g. "minimalist", "studio lighting")
imageCount	integer	Yes	Number of image variants to generate
videoCount	integer	Yes	Number of stitched videos to generate

Response

201 Created

{
  "jobId": "job_abc123",
  "status": "queued",
  "createdAt": "2026-02-27T12:00:00Z"
}

GET

/jobs/{id}

Poll job status and retrieve output URLs when complete. Jobs typically complete in under 2 minutes.

Poll job status

curl https://api.promptless.boltedge.io/jobs/job_abc123 \
  -H "Authorization: Bearer YOUR_API_KEY"

Job Status Values

Status	Description
queued	Job accepted, waiting in queue
processing	AI is generating images
completed	Done — output URLs available
failed	Generation failed — error message included

Completed Response

200 OK (completed)

{
  "jobId": "job_abc123",
  "status": "completed",
  "outputs": {
    "images": [
      {
        "url": "https://cdn.promptless.ai/outputs/abc123_1.jpg",
        "format": "jpg",
        "width": 2048,
        "height": 2048
      },
      {
        "url": "https://cdn.promptless.ai/outputs/abc123_2.jpg",
        "format": "jpg",
        "width": 2048,
        "height": 2048
      }
    ],
    "video": null
  },
  "processing_ms": 7840,
  "createdAt": "2026-02-27T12:00:00Z",
  "completedAt": "2026-02-27T12:00:08Z"
}

Code Examples

$cURL

generate.sh

curl -X POST https://api.promptless.boltedge.io/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "productImage": "https://example.com/product.jpg",
    "productName": "Ceramic Coffee Mug",
    "hints": ["minimalist", "studio lighting", "white background"],
    "imageCount": 2,
    "videoCount": 0
  }'

NNode.js

generate.mjs

const response = await fetch('https://api.promptless.boltedge.io/generate', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    productImage: 'https://example.com/product.jpg',
    productName: 'Ceramic Coffee Mug',
    hints: ['minimalist', 'studio lighting', 'white background'],
    imageCount: 2,
    videoCount: 0,
  }),
});

const job = await response.json();
console.log(job.jobId); // "job_abc123"

PyPython

generate.py

import requests

response = requests.post(
    "https://api.promptless.boltedge.io/generate",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
    },
    json={
        "productImage": "https://example.com/product.jpg",
        "productName": "Ceramic Coffee Mug",
        "hints": ["minimalist", "studio lighting", "white background"],
        "imageCount": 2,
        "videoCount": 0,
    },
)

job = response.json()
print(job["jobId"])  # "job_abc123"

Zapier Integration

Connect PROMPTLESS to thousands of apps — Shopify, WooCommerce, Airtable, Google Sheets — with no code using Webhooks by Zapier.

1Create a new Zap with your trigger (e.g., new Shopify product)
2Add a Webhooks by Zapier action
3Set Method: POST, URL: https://api.promptless.boltedge.io/generate
4Add header Authorization: Bearer YOUR_API_KEY
5Map productImage from your trigger and optionally set hints, imageCount, videoCount

Zapier config reference

# In Zapier, use the "Webhooks by Zapier" action:
# Method: POST
# URL: https://api.promptless.boltedge.io/generate
# Headers:
#   Authorization: Bearer YOUR_API_KEY
#   Content-Type: application/json
# Data:
#   productImage: {{product_image_url}}
#   productName: {{product_name}}
#   hints: ["lifestyle", "studio lighting"]
#   imageCount: 2
#   videoCount: 0

Ready to get your API key?

Start generating AI-staged product images in minutes.

View Plans & Pricing