curl --request POST \
--url https://api.tastelabs.com/design/submissions/photography \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"photos": [
{
"url": "https://images.example.com/campaign-1.jpg"
},
{
"url": "https://images.example.com/campaign-2.jpg"
}
]
}
'{
"submission_id": "5fb12de2-b640-4333-954a-a41703406b9a",
"status": "accepted",
"source_url": "https://images.example.com/campaign-1.jpg",
"accepted_at": "2026-10-27T12:34:43Z"
}{
"detail": {
"error": "UNAUTHORIZED",
"message": "Bearer token or X-API-Key required"
}
}{
"detail": {
"error": "INSUFFICIENT_CREDITS",
"message": "Not enough credits for this request.",
"balance": 0,
"required": 2
}
}{
"detail": {
"error": "FORBIDDEN",
"message": "This key is not allowed to call this endpoint."
}
}{
"detail": [
{
"type": "value_error",
"loc": [
"body",
"photos",
0,
"url"
],
"msg": "Value error, URL must be a valid https:// URL with a host",
"input": "http://images.example.com/campaign-1.jpg"
}
]
}Internal Server ErrorCreate photography submission
Builds a photography profile from a brand’s photos: the traits most of them share, what varies between them, and the tone measured from their pixels.
Send 1 to 12 photos, each as an https:// url or as image_b64. With one photo, the profile is that photo’s own reading; with more, it keeps what most of them share. Graphics, renders, and composites are read and then left out of the profile.
The job runs asynchronously: poll GET /design/submissions/{id} until the status is completed or failed, then read the profile from GET /design/submissions/{id}/result. A failed submission’s error starts with NOT_ENOUGH_PHOTOS (none of the photos is a usable photograph: send others) or PHOTO_READS_FAILED (retry the same request).
Costs 2 credits, refunded when no profile comes back. See Photography profile.
curl --request POST \
--url https://api.tastelabs.com/design/submissions/photography \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"photos": [
{
"url": "https://images.example.com/campaign-1.jpg"
},
{
"url": "https://images.example.com/campaign-2.jpg"
}
]
}
'{
"submission_id": "5fb12de2-b640-4333-954a-a41703406b9a",
"status": "accepted",
"source_url": "https://images.example.com/campaign-1.jpg",
"accepted_at": "2026-10-27T12:34:43Z"
}{
"detail": {
"error": "UNAUTHORIZED",
"message": "Bearer token or X-API-Key required"
}
}{
"detail": {
"error": "INSUFFICIENT_CREDITS",
"message": "Not enough credits for this request.",
"balance": 0,
"required": 2
}
}{
"detail": {
"error": "FORBIDDEN",
"message": "This key is not allowed to call this endpoint."
}
}{
"detail": [
{
"type": "value_error",
"loc": [
"body",
"photos",
0,
"url"
],
"msg": "Value error, URL must be a valid https:// URL with a host",
"input": "http://images.example.com/campaign-1.jpg"
}
]
}Internal Server ErrorAuthorizations
API key issued by the Taste Engine. Create one in the dashboard at https://engine.tastelabs.com/app/api-keys.
Body
The brand's photos. From a brand kit, send the do and example assets of photography.examples.
1 - 12 elementsOne photo: exactly one of url or image_b64.
- Option 1
- Option 2
Show child attributes
Show child attributes
Was this page helpful?