Skip to main content
Every error has the same shape. Switch on code. message is for humans and may change. status matches the HTTP status.
VALIDATION_FAILED adds details, one entry per invalid field:
Generation failures don’t come back as HTTP errors: they show up as errorCode on Generation Status (marked async below). Failed generations are refunded. Every error response carries an x-request-id header. Include it when you contact support.

Codes

Contact support@genlook.app with the generation ID if an error persists.

Person photo checks

The person photo is checked before the try-on starts, so a refused photo never costs a credit. The four PERSON_* and NO_PERSON_DETECTED codes come back on POST /try-on, /try-on/sync, /images/upload and batch creation.
  • A photo must be at least 400 x 500 px once cropped to 4:5. A larger photo cropped around a person who is far away may go down to 320 x 400 px. Under that, it gives PERSON_TOO_FAR.
  • A photo without a person is accepted by default, because pet photos and close-ups of feet or hands are valid try-ons. Set person.requirePerson: true if your products are always worn by a person.
  • Blur and lighting are not checked.

Example

The SDK throws a typed class per code instead.