Getting Started
Quick Start
Generate your first AI product photo through the API in three steps.
Before you start, you'll need:
- A ProductAI account (sign up for free)
- A product image on a publicly reachable URL — or upload one via the Upload Asset endpoint
1
Get your API key
Log in to your ProductAI dashboard, go to API Access, and copy your API key. Then verify it works:
cURL
curl "https://api.productai.photo/v1/api/key-check" \
-H "x-api-key: YOUR_API_KEY"
# Response
{ "status": "OK" }Keep it secret
Keep your API key secure and never share it publicly.
2
Generate an image
Submit a generation job with your product image URL and a prompt describing the scene. Credits are deducted on submit and the job runs asynchronously.
cURL
curl -X POST "https://api.productai.photo/v1/api/generate" \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "nanobanana2",
"image_url": "https://example.com/product.jpg",
"prompt": "Product on a clean white studio background with soft shadows"
}'
# Response
{
"status": "OK",
"data": {
"id": 287344,
"status": "RUNNING",
"prompt": "Product on a clean white studio background with soft shadows"
}
}3
Get the result
Poll the job every few seconds until status is COMPLETED — the image_url field holds your generated photo. Or skip polling entirely by setting a webhook.
cURL
curl "https://api.productai.photo/v1/api/job/287344" \
-H "x-api-key: YOUR_API_KEY"
# Response (when complete)
{
"status": "OK",
"data": {
"id": 287344,
"status": "COMPLETED",
"prompt": "Product on a clean white studio background with soft shadows",
"image_url": "https://…s3.amazonaws.com/generations/287344/result.png"
}
}