API And Endpoints

One endpoint, any agent

Ambient serves a standard, OpenAI-compatible inference API. If a tool can talk to OpenAI, it can talk to Ambient — change the base URL and the key, keep everything else the same. The same endpoint powers Ambient Desktop and any agent you already use, and every request is zero data retention.

Get an API key

1. Sign up

   Create an account at app.ambient.xyz.

2. Create a key

   Generate an API key at app.ambient.xyz/keys and copy it somewhere safe — you send it as a Bearer token.

3. Keep it out of your code

   Set it as an environment variable (for example AMBIENT_KEY) rather than hard-coding it. In Ambient Desktop you simply sign in — the app manages the key for you.

Models

Two models are available out of the box. Pass the model ID as the model field.

Quickstart

A first call in three flavors. Swap the model ID to switch models, and add "stream": true (or stream=True) for token streaming.

curl https://api.ambient.xyz/v1/chat/completions \
  -H "Authorization: Bearer $AMBIENT_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "zai-org/GLM-5.1-FP8",
    "messages": [{"role": "user", "content": "Say hello from Ambient."}]
  }'

from openai import OpenAI

client = OpenAI(
    base_url="https://api.ambient.xyz/v1",
    api_key="YOUR_AMBIENT_KEY",  # create one at https://app.ambient.xyz/keys
)

resp = client.chat.completions.create(
    model="zai-org/GLM-5.1-FP8",          # or "moonshotai/kimi-k2.7-code"
    messages=[{"role": "user", "content": "Say hello from Ambient."}],
)
print(resp.choices[0].message.content)

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.ambient.xyz/v1",
  apiKey: process.env.AMBIENT_KEY, // create one at https://app.ambient.xyz/keys
});

const resp = await client.chat.completions.create({
  model: "zai-org/GLM-5.1-FP8",
  messages: [{ role: "user", content: "Say hello from Ambient." }],
});
console.log(resp.choices[0].message.content);

curl https://api.ambient.xyz/v1/models \
  -H "Authorization: Bearer $AMBIENT_KEY"

Use it from your agent of choice

Zero data retention

Every request through this API is zero data retention by default. Prompts, context, and outputs are processed to serve the response and then discarded — only usage and billing metadata is kept. The guarantee is backed by both technical inspection and legally binding contracts. See Privacy & Data Retention for the full story.

Pay-per-use with x402

Beyond subscriptions, Ambient supports the x402 payment standard on Solana and Base, so agents can pay for inference per request. See the x402 client documentation for integration details.

FAQ