AI gateways

const providers = await airctrl.listProviders()
const openai = providers.find((provider) => provider.slug === 'openai')
if (!openai) throw new Error('OpenAI is not enabled for this AIRCTRL deployment')

airctrl gateway providers

Show the AI providers currently enabled in AIRCTRL. Include each provider's
name and ID. Do not add a credential or change any gateway.

const credential = await airctrl.createProviderCredential({
  accountId: '00000000-0000-4000-8000-000000000001',
  providerId: openai.provider_id,
  label: 'Production OpenAI',
  apiKey: process.env.OPENAI_API_KEY!,
})

airctrl gateway provider-credential-create \
  --account 00000000-0000-4000-8000-000000000001 \
  --provider 00000000-0000-4000-8000-000000000070 \
  --label "Production OpenAI" \
  --api-key-env OPENAI_API_KEY

Add an OpenAI provider credential named "Production OpenAI" to account
"00000000-0000-4000-8000-000000000001". Read the provider key from
"AIRCTRL_MCP_KEY_OPENAI_PRODUCTION". Show only the variable name and safe
credential details, then wait for my confirmation. Never print the key.

const gateway = await airctrl.createGateway({
  accountId: '00000000-0000-4000-8000-000000000001',
  projectId: '00000000-0000-4000-8000-000000000010',
  name: 'Payments AI',
  slug: 'payments-ai',
  credentialBindings: [
    { credentialId: credential.credential_id, modelId: 'gpt-5' },
    { credentialId: credential.credential_id, modelId: 'gpt-5-mini' },
  ],
})

airctrl gateway create \
  --account 00000000-0000-4000-8000-000000000001 \
  --project 00000000-0000-4000-8000-000000000010 \
  --name "Payments AI" \
  --slug payments-ai \
  --provider 00000000-0000-4000-8000-000000000070 \
  --model gpt-5 \
  --model gpt-5-mini \
  --credential 00000000-0000-4000-8000-000000000200

Create a bare AIRCTRL gateway named "Payments AI" in project
"00000000-0000-4000-8000-000000000010" under account
"00000000-0000-4000-8000-000000000001". Do not attach a provider key yet.
Show the proposed gateway details and wait for my confirmation before creating it.

const token = await airctrl.createGatewayToken(
  gateway.gateway_id,
  {
    name: 'Payments production',
    scopes: ['run'],
    allowedModels: ['gpt-5'],
    spendLimit: 100,
    spendWindow: 'monthly',
    rateLimitPerMin: 60,
  },
  { accountId: '00000000-0000-4000-8000-000000000001' },
)

Create a gateway token named "Payments production" for gateway
"00000000-0000-4000-8000-000000000030" in account
"00000000-0000-4000-8000-000000000001". Make it expire in 30 days. Show the
safe request details and wait for my confirmation. Return the token value only
once and only to the approved storage step.

const base = `${process.env.AIRCTRL_GATEWAY_URL}/hitheo/v1`
const headers = {
  'Content-Type': 'application/json',
  Authorization: `Bearer ${process.env.AIRCTRL_GATEWAY_TOKEN}`,
}

const started = await fetch(`${base}/video?model=theo-1-motion`, {
  method: 'POST',
  headers,
  body: JSON.stringify({ prompt: 'A five-second orbit around a geometric star', duration: '5s' }),
})
if (!started.ok) throw new Error(`Video enqueue failed: ${started.status}`)

let job = await started.json()
const deadline = Date.now() + 300_000
while (job.status === 'queued' || job.status === 'active') {
  if (Date.now() >= deadline) throw new Error('Video job timed out')
  await new Promise((resolve) => setTimeout(resolve, 2_000))
  const pollUrl = new URL(job.poll_url, new URL(base).origin)
  const response = await fetch(pollUrl, {
    headers: { Authorization: `Bearer ${process.env.AIRCTRL_GATEWAY_TOKEN}` },
  })
  if (!response.ok) throw new Error(`Video poll failed: ${response.status}`)
  job = await response.json()
}
if (job.status !== 'completed') throw new Error(job.error ?? 'Video generation failed')

Show the connection settings for gateway
"00000000-0000-4000-8000-000000000030". Include compatible base URLs and
required header names. Do not create or reveal a token.

Review gateway "00000000-0000-4000-8000-000000000030". Propose a monthly
spend limit of 100 and a rate limit of 120 requests per minute. Show the exact
changes and wait for my confirmation. Do not change routing or credentials.

Show the current OpenTelemetry export settings for gateway
"00000000-0000-4000-8000-000000000030" in account
"00000000-0000-4000-8000-000000000001". Return only safe settings and never
request stored header values. Do not change anything.