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.ai

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

/v1/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
image_url	string	Yes	Public URL of the product image (JPG, PNG, WebP)
product_name	string	Yes	Name of the product (used to infer context)
output_format	string	No	"jpg" \| "png" \| "webp" — default: "jpg"
include_video	boolean	No	Generate a short MP4 clip (costs 10 credits). Pro/Business only. Default: false
count	integer	No	Number of image variants to generate (1–4). Default: 2

Response

201 Created

{
  "job_id": "job_abc123",
  "status": "queued",
  "created_at": "2026-02-27T12:00:00Z"
}

GET

/v1/jobs/{id}

Poll job status and retrieve output URLs when complete. Jobs typically complete in 5–15 seconds.

Poll job status

curl https://api.promptless.ai/v1/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)

{
  "job_id": "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,
  "created_at": "2026-02-27T12:00:00Z",
  "completed_at": "2026-02-27T12:00:08Z"
}

Code Examples

$cURL

generate.sh

curl -X POST https://api.promptless.ai/v1/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://example.com/product.jpg",
    "product_name": "Ceramic Coffee Mug",
    "output_format": "jpg",
    "include_video": false
  }'

NNode.js

generate.mjs

const response = await fetch('https://api.promptless.ai/v1/generate', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    image_url: 'https://example.com/product.jpg',
    product_name: 'Ceramic Coffee Mug',
    output_format: 'jpg',
    include_video: false,
  }),
});

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

PyPython

generate.py

import requests

response = requests.post(
    "https://api.promptless.ai/v1/generate",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
    },
    json={
        "image_url": "https://example.com/product.jpg",
        "product_name": "Ceramic Coffee Mug",
        "output_format": "jpg",
        "include_video": False,
    },
)

job = response.json()
print(job["job_id"])  # "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.ai/v1/generate
4Add header Authorization: Bearer YOUR_API_KEY
5Map image_url and product_name from your trigger

Zapier config reference

# In Zapier, use the "Webhooks by Zapier" action:
# Method: POST
# URL: https://api.promptless.ai/v1/generate
# Headers:
#   Authorization: Bearer YOUR_API_KEY
#   Content-Type: application/json
# Data:
#   image_url: {{product_image_url}}
#   product_name: {{product_name}}

Ready to get your API key?

Start generating AI-staged product images in minutes.

View Plans & Pricing