Get a catalog entry
const url = 'https://example.com/v1/catalog/models/example';const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url https://example.com/v1/catalog/models/example \ --header 'Authorization: Bearer <token>'Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ”Header Parameters
Section titled “Header Parameters ”Responses
Section titled “ Responses ”Successful Response
One catalog entry — a generated image with its spec embedded.
image_url is a short-lived presigned GET URL; a raw S3 key never crosses
this boundary (studio AD-8). spec is the resource-specific spec view —
models: {public_id, display_name, gender, ethnicity, body_type, age_range, metadata};
backgrounds: {public_id, display_name, scene_type, mood, dominant_colors, metadata};
complementary-garments: {public_id, display_name, garment_category_public_id,
color, material, pattern, fit, length, metadata}. Kept polymorphic-as-dict
on this boundary so studio can extend spec attributes without a gateway
contract break.
object
The catalog image’s ULID — what workflow requests reference.
Short-lived presigned preview URL.
‘active’ | ‘archived’.
The embedded resource-specific spec view (see class docstring).
object
Example generated
{ "public_id": "example", "image_url": "example", "status": "example", "spec": {}, "description": "example", "generation_job_public_id": "example", "created_at": "2026-04-15T12:00:00Z"}Validation Error
object
object
Example generated
{ "detail": [ { "loc": [ "example" ], "msg": "example", "type": "example" } ]}