Generate AI Product Images from a Single Photo

Use POST /generate to queue an AI image generation. The endpoint is asynchronous — it returns a task_id immediately and the image is ready to download once the status transitions to completed.

Prerequisites

Before you call /generate, make sure you have:

An API key — passed in every request as the X-Api-Key header
A product image hosted at a publicly accessible URL
A scene_id — retrieve one from GET /scenes (see Manage Scenes)

Required Fields

Field	Type	Description
`model`	string	Model identifier (e.g. `estudjo/eco`)
`category`	string	Category slug (e.g. `womens-clothing`)
`aspect-ratio`	string	e.g. `1:1`, `3:4`
`resolution`	string	e.g. `1K`
`scene`	string (UUID)	The scene to use
`image_url`	string (URL)	Publicly accessible product image

Optional Fields

additional_data — a flat object of string:string pairs that are injected into the generation prompt as key:value lines. Use this to provide product-specific context such as names, materials, or colours. Omitting the field, passing {}, or passing null all have the same effect: no extra data is added.

{
  "product_name": "White Long Dress",
  "material": "denim, cotton"
}

additional_data must be a flat object — nested objects and non-string values will return a 400 invalid_input error.

Example Request

curl -X POST https://v1.api.estudjo.com/generate \
  -H 'X-Api-Key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "estudjo/eco",
    "category": "womens-clothing",
    "aspect-ratio": "1:1",
    "resolution": "1K",
    "scene": "59b4a671-1b90-453e-92c3-a28ceee177af",
    "image_url": "https://static.example.com/thumb/product-86713.jpg",
    "additional_data": {
      "product_name": "White Long Dress",
      "material": "denim, cotton"
    }
  }'

Response

A successful request returns a queued status and a task_id you use to track the generation.

{
  "success": true,
  "data": {
    "status": "queued",
    "task_id": "6bfd652d4c31261ffb8ed3424ac2775e"
  }
}

Save the task_id — you’ll need it to poll GET /status and retrieve the finished image URL.

Error Reference

Code	HTTP	Cause
`invalid_input`	400	Missing required field, bad `aspect-ratio` or `resolution` value, `category` not linked to the scene, or `additional_data` contains non-flat or non-string values
`not_found`	404	Unknown model or scene
`insufficient_credits`	402	Account balance too low to queue the generation
`provider_error`	502	Upstream AI provider failed — retry after a short delay

Get Started

Core Concepts

How-To Guides

Reference

Generate AI Product Images from a Single Photo | estudjo

Prerequisites

Required Fields

Optional Fields

Example Request

Response

Error Reference

Next Steps

Poll for Status

Generation History

​Prerequisites

​Required Fields

​Optional Fields

​Example Request

​Response

​Error Reference

​Next Steps

Poll for Status

Generation History

Prerequisites

Required Fields

Optional Fields

Example Request

Response

Error Reference

Next Steps