Cloud Models
Ollama's cloud models are a new kind of model in Ollama that can run without a powerful GPU. Instead, cloud models are automatically offloaded to Ollama's cloud service while offering the same capabilities as local models, making it possible to keep using your local tools while running larger models that wouldn't fit on a personal computer.
Supported models
For a list of supported models, see Ollama's model library.
Running Cloud models
Ollama's cloud models require an account on ollama.com. To sign in or create an account, run:
ollama signinCLI
To run a cloud model, open the terminal and run:
ollama run gpt-oss:120b-cloudPython
First, pull a cloud model so it can be accessed:
ollama pull gpt-oss:120b-cloudNext, install Ollama's Python library:
pip install ollamaNext, create and run a simple Python script:
python
from ollama import Client
client = Client()
messages = [
{
'role': 'user',
'content': 'Why is the sky blue?',
},
]
for part in client.chat('gpt-oss:120b-cloud', messages=messages, stream=True):
print(part['message']['content'], end='', flush=True)JavaScript
First, pull a cloud model so it can be accessed:
ollama pull gpt-oss:120b-cloudNext, install Ollama's JavaScript library:
npm i ollamaThen use the library to run a cloud model:
typescript
const ollama = new Ollama();
const response = await ollama.chat({
model: "gpt-oss:120b-cloud",
messages: [{ role: "user", content: "Explain quantum computing" }],
stream: true,
});
for await (const part of response) {
process.stdout.write(part.message.content);
}cURL
First, pull a cloud model so it can be accessed:
ollama pull gpt-oss:120b-cloudRun the following cURL command to run the command via Ollama's API:
curl http://localhost:11434/api/chat -d '{
"model": "gpt-oss:120b-cloud",
"messages": [{
"role": "user",
"content": "Why is the sky blue?"
}],
"stream": false
}'Cloud API access
Cloud models can also be accessed directly on ollama.com's API. In this mode, ollama.com acts as a remote Ollama host.
Authentication
For direct access to ollama.com's API, first create an API key.
Then, set the OLLAMA_API_KEY environment variable to your API key.
export OLLAMA_API_KEY=your_api_keyListing models
For models available directly via Ollama's API, models can be listed via:
curl https://ollama.com/api/tagsGenerating a response
Python
First, install Ollama's Python library
pip install ollamaThen make a request
python
from ollama import Client
client = Client(
host="https://ollama.com",
headers={'Authorization': 'Bearer ' + os.environ.get('OLLAMA_API_KEY')}
)
messages = [
{
'role': 'user',
'content': 'Why is the sky blue?',
},
]
for part in client.chat('gpt-oss:120b', messages=messages, stream=True):
print(part['message']['content'], end='', flush=True)JavaScript
First, install Ollama's JavaScript library:
npm i ollamaNext, make a request to the model:
typescript
const ollama = new Ollama({
host: "https://ollama.com",
headers: {
Authorization: "Bearer " + process.env.OLLAMA_API_KEY,
},
});
const response = await ollama.chat({
model: "gpt-oss:120b",
messages: [{ role: "user", content: "Explain quantum computing" }],
stream: true,
});
for await (const part of response) {
process.stdout.write(part.message.content);
}cURL
Generate a response via Ollama's chat API:
curl https://ollama.com/api/chat \
-H "Authorization: Bearer $OLLAMA_API_KEY" \
-d '{
"model": "gpt-oss:120b",
"messages": [{
"role": "user",
"content": "Why is the sky blue?"
}],
"stream": false
}'Local only
Ollama can run in local-only mode by disabling Ollama's cloud features.
Retirements
Ollama will occasionally deprecate and retire older cloud models as newer and better open-source models are released. Tools and applications relying on Ollama Cloud models may need to be updated to keep working. Impacted users will be notified in advance of model deprecation and retirement. Deprecations will be communicated through email and on the Ollama website.
Ollama Cloud model retirement does not affect local models.
Upcoming retirements
| Retirement date | Model | Recommended alternative |
|---|---|---|
| July 31, 2026 | minimax-m2.5 | minimax-m2.7 |
| July 31, 2026 | kimi-k2.5 | kimi-k2.6 |