Skip to main content
POST
Insert object into scene

Authorizations

Authorization
string
header
required

Your Kynva API key (kyn_live_xxx or kyn_test_xxx; legacy rf_ keys remain valid)

Body

application/json
backgroundUrl
string<uri>
required

URL of the background/scene image

objectUrl
string<uri>
required

URL of the object image (should have transparent background)

placement
enum<string>
default:auto

Placement strategy (auto uses Claude Vision for intelligent placement)

Available options:
auto,
center,
left,
right,
top,
bottom,
custom
customPosition
object

Custom position (only used when placement is "custom")

scale
number
default:1
Required range: 0.1 <= x <= 3
blendMode
enum<string>
default:normal
Available options:
normal,
multiply,
screen,
overlay,
soft-light,
hard-light
shadowEnabled
boolean
default:false
shadow
object
prompt
string

Hint for AI placement: "place on the table"

outputFormat
enum<string>
default:png
Available options:
png,
webp,
jpg
quality
number
default:90
Required range: 1 <= x <= 100

Response

200 - application/json

Object inserted successfully

Object inserted successfully

success
boolean
data
object