A product catalog is the list of products that AI Skin Analysis uses for Product Recommendation. Upload your catalog once, keep its catalog_id, and pass that id to Skin Analysis. A catalog is kept until you delete it.
Catalogs belong to your account, not to a single API key: every API key of the account, project keys included, sees the same catalogs, and rotating or deleting a key does not affect them.
Uploading and storing catalogs is free.
- Catalog file
| Item | Value |
|---|---|
| Format | CSV with a header row |
| Encoding | UTF-8, with or without a byte order mark (BOM). Excel's "CSV UTF-8" format adds one. |
| Maximum file size | 5 MB |
| Maximum SKU count | No limit other than the file size |
Required columns:
| Column | Description |
|---|---|
product_id | Your product id |
product_name | Product name |
product_description | Product description |
Other columns are ignored but still count toward the 5 MB limit. Values that contain commas or line breaks must be quoted, as in standard CSV. Each non-empty data row counts as one SKU.
Example:
product_id,product_name,product_description
SKU-001,Hydrating Serum,"A lightweight serum for dry skin."
SKU-002,Brightening Cream,"Evens out skin tone, for daily use."- Catalog states
| Status | Meaning | Usable in Skin Analysis |
|---|---|---|
ready | Uploaded and validated | Yes |
failed | Uploaded, but the file failed validation | No |
An upload that fails validation answers an error and is still recorded as a failed catalog, which List catalogs shows. Delete it like any other catalog.
- Limits
Each account can keep up to 10 catalogs, ready and failed together. Delete a catalog before uploading another.
To update a catalog, upload a new file: each upload creates a new catalog_id, and the old catalog stays usable until you delete it, so you can check the new one before switching.
- Deleting
Deleting a catalog is immediate and permanent. From that moment every Skin Analysis call that uses its catalog_id fails. A deleted catalog cannot be restored; uploading the same file again creates a new catalog with a new catalog_id.