Skip to main content
POST
/
v2
/
image-utils
/
detail-preservation
cURL
curl --request POST \
  --url https://api.tokenkit.co/v2/image-utils/detail-preservation \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form 'source_image=<string>' \
  --form 'reference_images=<string>' \
  --form source_image.0='@example-file' \
  --form reference_images.0='@example-file' \
  --form reference_images.2.items.0='@example-file'
{
  "data": {
    "job_id": "job_123",
    "links": {
      "self": "/v1/jobs/job_123",
      "stream": "/v1/jobs/job_123/stream"
    }
  },
  "errors": null
}

​
Request body

multipart/form-data
  • source_image (file, required): Source image, max 30MB
  • reference_images (file | file[], required): One or more reference images, each max 30MB

​
Validation rules

  • reference_images accepts either:
    • a single image
    • an array of images
  • Input is normalized to an array internally
  • At least one reference image is required:
    • "reference_images must contain at least 1 image"

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

multipart/form-data
​
source_image
required
​
reference_images
required

Response

Job accepted

​
data
object
required
​
errors
unknown