Skip to main content

AI Chat Models

MachinaOs supports three major AI providers for chat completions.

Available Models

Models are fetched dynamically from each provider’s API when you add your API key.

OpenAI

ModelBest For
gpt-5.2Most capable, professional tasks
gpt-5Advanced reasoning, multimodal
o3Complex reasoning
o4-miniFast, cost-efficient reasoning

Anthropic Claude

ModelBest For
claude-opus-4.5Best for coding and agents
claude-sonnet-4.5Balanced performance
claude-haiku-4.5Fast responses

Google Gemini

ModelBest For
gemini-3-proMost intelligent, complex tasks
gemini-3-flashFast, frontier performance
gemini-2.5-proLong context, multimodal

Adding API Keys

  1. Click the key icon in the toolbar
  2. Select the provider
  3. Enter your API key
  4. Click Validate to test
API keys are encrypted and stored locally. They’re never sent to MachinaOs servers.

OpenAI Chat Model

Parameters

model
select
required
The model to use (gpt-5.2, gpt-5, o3, o4-mini)
prompt
string
required
The message to send. Supports template variables.
temperature
slider
default:"0.7"
Randomness (0 = deterministic, 1 = creative)
maxTokens
number
default:"1000"
Maximum response length
responseFormat
select
default:"text"
Output format: text or json_object

Output

{
  "response": "The AI's response text",
  "model": "gpt-5.2",
  "usage": {
    "prompt_tokens": 50,
    "completion_tokens": 100,
    "total_tokens": 150
  }
}

Example

Prompt: Summarize this in 2 sentences: {{webhookTrigger.body.text}}
Temperature: 0.3
Max Tokens: 200

Anthropic Claude Model

Parameters

model
select
required
Claude model (claude-opus-4.5, claude-sonnet-4.5, claude-haiku-4.5)
prompt
string
required
The message to send
systemPrompt
string
System instructions for the model
temperature
slider
default:"0.7"
Randomness (0-1)
maxTokens
number
default:"1000"
Maximum response length

Output

{
  "response": "Claude's response",
  "model": "claude-sonnet-4.5",
  "stop_reason": "end_turn"
}

Example

System Prompt: You are a helpful coding assistant.
Prompt: Explain this error: {{webhookTrigger.body.error}}

Google Gemini Model

Parameters

model
select
required
Gemini model (gemini-3-pro, gemini-3-flash, gemini-2.5-pro)
prompt
string
required
The message to send
temperature
slider
default:"0.7"
Randomness (0-1)
maxTokens
number
default:"1000"
Maximum response length
safetySettings
select
default:"default"
Content safety level

Output

{
  "response": "Gemini's response",
  "model": "gemini-3-pro"
}

Comparing Providers

FeatureOpenAIClaudeGemini
SpeedFastMediumFast
ReasoningGoodExcellentGood
Context Window128K200K1M
MultimodalYesYesYes
JSON ModeYesNoNo

Common Use Cases

Text Generation

Prompt: Write a product description for: {{input.product_name}}
Temperature: 0.8

Data Extraction

Prompt: Extract the email and phone from: {{input.text}}
Response Format: json_object
Temperature: 0

Translation

Prompt: Translate to Spanish: {{input.text}}
Temperature: 0.3

Summarization

Prompt: Summarize in 3 bullet points: {{input.article}}
Temperature: 0.3
Max Tokens: 200

Tips

Use temperature 0 for deterministic outputs like data extraction.
Use temperature 0.7-0.9 for creative writing tasks.
Enable JSON mode (OpenAI) when you need structured output.
API calls cost money. Monitor your usage in your provider’s dashboard.

Error Handling

ErrorCauseSolution
401 UnauthorizedInvalid API keyCheck/update API key
429 Rate LimitedToo many requestsAdd delay, reduce frequency
500 Server ErrorProvider issueRetry later