Foundation APIs

Use supported root imports for the Stable portable contract:

from zhivex_ai import generate_text, stream_text, generate_object, stream_object, embed

• generate_text returns normalized text, usage and finish information.
• stream_text supports incremental consumption; close or cancel streams when the consumer exits.
• generate_object and stream_object bind structured generation to an application-owned schema.
• embed produces embeddings for models that declare that capability.

Provider construction selects a model; the shared operation stays the same. Model capabilities differ, so verify the provider contract before enabling a feature. A successful local mock establishes runtime behavior, not live support.

See the exact signatures and stability labels in the root reference.

Application-owned catalogs and metadata are Stable in 0.24:

from zhivex_ai import ModelCatalog, ModelCatalogEntry, ModelPricing, create_model_catalog

This covers construction, lookup, defensive copies and pricing units/validity windows. It does not guarantee freshness or live provider support. The maintained default_model_catalog snapshot and capability discovery remain Beta.