BuildPlatform API v1
Models and native options
Discover pinnable models per Asset type and validate provider-native controls without coupling to internal providers.
Discover by Asset type
Call GET /models?asset_type=explainer_video. Each model includes a stable public ID, lifecycle state, compatibility, and an exact native option schema. A model may be default, deprecated with a replacement, or retired.
TypeScript
ts
const models = await client.models.list({
asset_type: 'explainer_video',
})Pin deliberately
Set model on the individual Asset request. Send model_options only when a model is pinned and only with keys accepted by that model schema. Existing Generations and Loops preserve their frozen public model ID.
Retirement is explicit
Do not silently fall back. Replace a deprecated model before its retirement time; a retired pin fails with model_retired.