Transform your first Vehicle
Send us vehicle images and/or video, and Spyne will return transformed outputs.
Create a request
method: post
endpoint: https://api.spyne.ai/api/pv1/merchandise/process/
What it does:
- Accepts vehicle identifiers, raw media files, product info and processing config
- Applies AI to produce transformed studio-grade images, 360 spin, or feature video
- Returns a
dealerVinId
on success request.
Example Payload:
{
"vin": "<VIN of the vehicle>",
"stockNumber": "<Your internal stock number>",
"registrationNumber": "<Registration number of the vehicle>",
"media": {
"image": true,
"spin": true,
"featureVideo": true
},
"mediaInput": {
"imageData": [
{
"url": "https://uploads.vw-mms.de/system/production/images/vwn/024/594/images/717c166910bd27376186f6428dbde9575050769f/DB2018AU00327_web_1600.jpg?1649153661"
},
{
"url": " https://uploads.vw-mms.de/system/production/images/vwn/024/594/images/717c166910bd27376186f6428dbde9575050769f/DB2018AU00327_web_1600.jpg?1649153661"
},
{
"url": " https://uploads.vw-mms.de/system/production/images/vwn/024/594/images/717c166910bd27376186f6428dbde9575050769f/DB2018AU00327_web_1600.jpg?1649153661"
},
{
"url": " https://uploads.vw-mms.de/system/production/images/vwn/024/594/images/717c166910bd27376186f6428dbde9575050769f/DB2018AU00327_web_1600.jpg?1649153661"
},
{
"url": " https://uploads.vw-mms.de/system/production/images/vwn/024/594/images/717c166910bd27376186f6428dbde9575050769f/DB2018AU00327_web_1600.jpg?1649153661"
},
{
"url": " https://uploads.vw-mms.de/system/production/images/vwn/024/594/images/717c166910bd27376186f6428dbde9575050769f/DB2018AU00327_web_1600.jpg?1649153661"
},
{
"url": " https://uploads.vw-mms.de/system/production/images/vwn/024/594/images/717c166910bd27376186f6428dbde9575050769f/DB2018AU00327_web_1600.jpg?1649153661"
},
{
"url": " https://uploads.vw-mms.de/system/production/images/vwn/024/594/images/717c166910bd27376186f6428dbde9575050769f/DB2018AU00327_web_1600.jpg?1649153661"
}
]
},
"processingDetails": {
"backgroundId": "20883",
"bannerId": "1",
"numberPlateLogo": "1",
"catalog": {
"backgroundType": "legacy",
"extractCatalogCount": "8"
},
"spin": {
"hotspot": true,
"spinFrameCount": "72"
},
"featureVideo": {
"templateId": "6758566c41fa6398621c9563",
"musicId": "66a8e815200257e9dcff1c90",
"voiceId": "voice-f22ad31e7bc84888bb96fa8b4db35cd8"
},
}
}
Understanding the payload
Below is a detailed explanation of each parameter, its significance, and how to use it effectively.
Parameter | Category | Description |
---|---|---|
vin stockNumber registrationNumber | Vehicle Unique Identifier | A unique Vehicle Identification Number that is used to identify the vehicle being processed.
|
dealerId | Rooftop of the Dealership | Identifies the specific dealership or rooftop submitting the request. This is also known as Team ID in the spyne's system.
|
media | Products to be generated | This Specifies the types of media to process.
|
mediaInput | Input Media to be processed | The mediaInput parameter contains the media URLs of the vehicle, either images, videos, or both.
|
processingDetails | Processing Details Parameters - Common Configurations | This key is required if you have opted for one or both products: Images / 360 spin. If you have only opted for feature video, this key is not required.
catalog:
This parameter is only needed if the input media is a video and you want us to extract images from the video. To be sent if the image processing is set to true.
spin:
featureVideo:
|
Retrieve Transformed media
Use your dealerVinId
provided in the above request to get the transformed media.
method: get
path: /merchandise
Setup webhook endpoint to directly receive the transformed media
Updated 15 days ago