Chat Completion: xAI action

Inputs

The fields this action accepts.

Every field can be mapped from an upstream trigger, AI step, table row, or hard-coded literal.

Field	Type	Required	Description
Model model	options	Required	Which model to use
User Message message	string	Required	User message to send to the model
System Prompt system_prompt	string	Optional	Optional system instructions that shape the model's behavior
Temperature temperature	string	Optional	Sampling temperature (0–2). Higher = more random.
Max Tokens max_tokens	string	Optional	Maximum tokens to generate in the response
Top P top_p	string	Optional	Nucleus sampling threshold (0–1)
Response Format response_format	options	Optional	Force JSON output (model must support JSON mode)

Sample request

{
  "model": "{{trigger.model}}",
  "message": "e.g. Summarize this article in 3 bullets",
  "system_prompt": "e.g. You are a helpful assistant.",
  "temperature": "0.7",
  "max_tokens": "1024"
}

Returns

{
  "id": "chatcmpl-abc123",
  "model": "grok-4",
  "usage": {
    "total_tokens": 60,
    "prompt_tokens": 10,
    "completion_tokens": 50
  },
  "choices": [
    {
      "message": {
        "role": "assistant",
        "content": "Sample response"
      },
      "finish_reason": "stop"
    }
  ]
}

Use these fields in downstream nodes for routing, logging, or error handling.

FAQ

Questions about Chat Completion.

What does the Chat Completion action do in xAI?

Sends a message to a Grok model on xAI and gets a response. Grok models lean into real-time, web- and X-aware answers; OpenAI-compatible request shape.

What inputs does Chat Completion require?

Required: Model, User Message. Every input accepts a static value or a variable from any upstream node in your workflow.

Can I use dynamic inputs from earlier workflow nodes?

Yes. Any field on this action can pull values from upstream nodes, whether that's a form response, a trigger payload, an AI output, or a lookup result.

What happens if xAI returns an error?

The workflow pauses on the failed node, the error message is captured in the run log, and you can retry the run with one click. Auto-retry policies are configurable per workflow with exponential backoff up to 5 attempts.

Does Chat Completion support batch operations?

Yes. Run Chat Completion inside a Loop node to process arrays. Tiny Command handles xAI's rate limits automatically so you don't have to throttle manually.

More actions