Generate AI output

generate produces text or schema-validated data. Omit account to use the platform Vercel AI Gateway credential. Its model cost counts toward the organization’s monthly Platform AI allowance; customer-managed accounts don’t use this allowance. The platform default is openai/gpt-4.1-nano.

Example

automations/recipe.automation.ts

import {
  automation,
  generate,
  markSignificant,
  onDashboardRun,
} from "automate.ax"
import { z } from "zod"

export default automation("Create a recipe", () => {
  onDashboardRun({ title: "Create recipe" })

  const recipe = generate({
    prompt: "Create a weeknight pasta recipe",
    schema: z.object({
      ingredients: z.string().array(),
      name: z.string(),
      steps: z.string().array(),
    }),
  })

  markSignificant(recipe.output)
})

An organization member starts generation from the dashboard. The schema-validated recipe appears in the action output, and markSignificant keeps the completed run in the default Recent runs view. Each run uses the organization’s Platform AI allowance.

Inputs

Input	Type	Required	Description
`model`	`GenerateModelId`	No	Gateway or provider-native model ID. Available models and the default depend on `account`.
`prompt`	`string`	One of `prompt` or `messages`	Text prompt.
`messages`	`{ role: "assistant" \| "user"; content: string }[]`	One of `prompt` or `messages`	Conversation messages.
`account`	Provider account reference	No	Customer-managed provider credentials. Omit for the platform gateway.
`schema`	Standard Schema	No	Constrains structured output and determines its TypeScript type.
`schemaName`	`string`	No	Provider-facing structured-output name.
`schemaDescription`	`string`	No	Additional structured-output guidance.
`instructions` / `system`	`string`	No	Model instructions.
`maxOutputTokens`	`number`	No	Maximum generated tokens.
`temperature` / `topP` / `topK`	`number`	No	Sampling settings.
`frequencyPenalty` / `presencePenalty`	`number`	No	Repetition penalties.
`stopSequences`	`string[]`	No	Sequences that stop generation.
`seed`	`number`	No	Provider-supported deterministic seed.
`maxRetries`	`number`	No	Maximum provider retries.
`timeout`	`number`	No	Request timeout in milliseconds.
`providerOptions`	`Record<string, Record<string, JSONValue>>`	No	Provider-specific options.

Generation inputs accept compatible signals. Schema and account selection are static. Model autocomplete follows the selected provider, but arbitrary string IDs remain valid for newly released models.

Output

Without a schema, output is Signal<string>. With a schema, output is a signal of that Standard Schema’s inferred output type. The result also exposes generated text, token usage, finishReason, rawFinishReason, reasoningText, warnings, provider metadata, and response metadata.

Provider accounts

Customer-managed API-key accounts are available for Anthropic, Cerebras, Cohere, DeepInfra, DeepSeek, Fireworks AI, Google Generative AI, Groq, Hugging Face, Mistral AI, OpenAI, OpenRouter, Perplexity, Together AI, Vercel AI Gateway, and xAI. Connect credentials with bunx automate.ax accounts, then import the provider helper and pass a named account reference. API keys don’t appear in automation code or signals.

automations/provider-models.automation.ts

import {
  automation,
  generate,
  markSignificant,
  onDashboardRun,
  transform,
} from "automate.ax"
import { anthropicAccount } from "automate.ax/anthropic"
import { openaiAccount } from "automate.ax/openai"
import { openRouterAccount } from "automate.ax/openrouter"

export default automation("Compare providers", () => {
  onDashboardRun({ title: "Compare providers" })

  const anthropic = generate({
    account: anthropicAccount("writing"),
    prompt: "Write a two-sentence launch announcement for Automate.ax",
  })

  const openai = generate({
    account: openaiAccount("writing"),
    model: "gpt-4.1-mini",
    prompt: "Write a two-sentence launch announcement for Automate.ax",
  })

  const openRouter = generate({
    account: openRouterAccount("writing"),
    prompt: "Write a two-sentence launch announcement for Automate.ax",
  })

  const comparison = transform(
    [anthropic.output, openai.output, openRouter.output],
    (anthropicOutput, openaiOutput, openRouterOutput) => ({
      anthropic: anthropicOutput,
      openai: openaiOutput,
      openRouter: openRouterOutput,
    }),
  )

  markSignificant(comparison)
})

An organization member starts all three requests from the dashboard. Their responses appear in the run’s action outputs, and markSignificant keeps the completed run in the default Recent runs view. The providers can charge the three connected accounts for each run. Omitting model uses the selected account’s default:

Account	Default model
Platform or Vercel AI Gateway	`openai/gpt-4.1-nano`
Anthropic	`claude-haiku-4-5`
Cerebras	`llama3.1-8b`
Cohere	`command-a-03-2025`
DeepInfra	`meta-llama/Llama-3.3-70B-Instruct-Turbo`
DeepSeek	`deepseek-chat`
Fireworks AI	`accounts/fireworks/models/llama-v3p3-70b-instruct`
Google Generative AI	`gemini-2.5-flash`
Groq	`llama-3.1-8b-instant`
Hugging Face	`meta-llama/Llama-3.1-8B-Instruct`
Mistral AI	`mistral-small-latest`
OpenAI	`gpt-4.1-nano`
OpenRouter	`openrouter/auto`
Perplexity	`sonar`
Together AI	`meta-llama/Llama-3.3-70B-Instruct-Turbo`
xAI	`grok-latest`

Built-in triggers

Built-in actions

Runtime utilities

Integrations

Example

Inputs

Output

Provider accounts

​Example

​Inputs

​Output

​Provider accounts

Example

Inputs

Output

Provider accounts