Skip to content

crusoe

Setup

For details on how to set up authentication with this model, see model configuration for Crusoe.

Crusoe model implementation using OpenAI-compatible API.

CrusoeModel

Bases: OpenAIChatModel

A model that uses Crusoe’s OpenAI-compatible Serverless Inference API.

Crusoe serves open-weight models from many labs behind one endpoint, so the model family — and with it the profile CrusoeProvider resolves — is derived from the vendor prefix on the model name (zai/, deepseek-ai/, meta-llama/, …).

Every model is served with guided decoding, so NativeOutput works across the catalog, including for families whose own profiles don’t claim native structured output support. Thinking is returned in a non-standard field (reasoning, or reasoning_content for DeepSeek), both of which OpenAIChatModel reads.

Apart from __init__, all methods are inherited from the base class.

Methods

__init__
def __init__(
    model_name: CrusoeModelName,
    *,
    provider: Literal['crusoe'] | Provider[AsyncOpenAI] = 'crusoe',
    profile: ModelProfileSpec | None = None,
    settings: ModelSettings | None = None,
)

Initialize a Crusoe model.

Parameters

model_name : CrusoeModelName

The name of the Crusoe model to use, including the vendor prefix (e.g. 'zai/GLM-5.2').

provider : Literal[‘crusoe’] | Provider[AsyncOpenAI] Default: 'crusoe'

The provider to use. Defaults to 'crusoe'.

profile : ModelProfileSpec | None Default: None

The model profile to use. Defaults to a profile picked by the provider based on the model name.

settings : ModelSettings | None Default: None

Model-specific settings that will be used as defaults for this model.

CrusoeModelName

Possible Crusoe model names.

Since Crusoe supports a variety of models and the list changes frequently, we explicitly list known models but allow any name in the type hints.

See https://docs.crusoecloud.com/serverless-inference/overview for an up to date list of models.

Default: str | LatestCrusoeModelNames