Crusoe Provider

crusoe-ai-provider contains language model support for Crusoe Cloud Managed Inference, which provides access to open-weight models such as DeepSeek, GLM, Kimi, Llama, Nemotron, and Qwen on sustainable, energy-efficient data centers via an OpenAI-compatible API.

API keys can be obtained from the Crusoe Cloud Console.

Setup

The Crusoe provider is available via the crusoe-ai-provider module. You can install it with:

pnpm add crusoe-ai-provider

Environment variables

Create a .env file with a CRUSOE_API_KEY variable.

Provider Instance

You can import the default provider instance crusoe from crusoe-ai-provider:

1
import { crusoe } from 'crusoe-ai-provider';

If you need a customized setup, you can import createCrusoe from crusoe-ai-provider and create a provider instance with your settings:

1
import { createCrusoe } from 'crusoe-ai-provider';
2

3
const crusoe = createCrusoe({
4
  // Optional settings
5
});

You can use the following optional settings to customize the Crusoe provider instance:

• baseURL string

  Use a different URL prefix for API calls, e.g. to use proxy servers. The default prefix is https://api.inference.crusoecloud.com/v1.

• apiKey string

  API key that is being sent using the Authorization header. It defaults to the CRUSOE_API_KEY environment variable.

• headers Record<string,string>

  Custom headers to include in the requests.

• fetch (input: RequestInfo, init?: RequestInit) => Promise<Response>

  Custom fetch implementation. Defaults to the global fetch function.

Language Models

You can create language models using a provider instance:

1
import { crusoe } from 'crusoe-ai-provider';
2
import { generateText } from 'ai';
3

4
const { text } = await generateText({
5
  model: crusoe('zai/GLM-5.2'),
6
  prompt: 'Write a vegetarian lasagna recipe for 4 people.',
7
});

Crusoe language models can also be used in the streamText function:

1
import { crusoe } from 'crusoe-ai-provider';
2
import { streamText } from 'ai';
3

4
const result = streamText({
5
  model: crusoe('deepseek-ai/DeepSeek-V4-Pro'),
6
  prompt: 'Write a haiku about sustainable computing.',
7
});
8

9
for await (const chunk of result.textStream) {
10
  process.stdout.write(chunk);
11
}

Model Capabilities