Live now · Get your API key

Ambient web app

The three surfaces of the Ambient web app. Chat for conversation, Research for citation-rich analysis, and API Keys for integrating Ambient into your own code.

The Ambient web app has three surfaces: Chat, Research, and API Keys.

Chat#

The default experience in Ambient is a simple chat interface labelled Ask Ambient. Use it to have conversations with Ambient's AI and receive instant responses.

  1. Start a new chat: When you log in, you'll see a menu on the left. Select New Chat to open a blank conversation window.
  2. Type your question: Click in the blue input box labelled "Ask Ambient…" at the bottom of the main panel and enter your query. Ambient's model is capable of natural-language tasks such as answering questions, summarizing articles or drafting short emails.
  3. Send the message: Press the send arrow to submit your prompt. The AI will respond in the chat area. You can continue the conversation by entering follow-up questions.

Ambient also offers a Thinking mode that takes more time to generate higher-quality answers. Use the drop-down next to the chat title to switch modes.

Research#

Research mode is designed for deeper, citation-rich analysis. It uses the same underlying model but engages additional retrieval capabilities to provide more detailed answers and references.

  1. Select Research mode: In the chat header, click the drop-down arrow and choose Research. The header will change to Research with Ambient, and the input box will indicate research mode.
  2. Enter your research query: Type your topic or question. Ambient will perform a broad search, synthesize information and return a detailed response with citations when available.
  3. Review citations and continue: Responses may include references to support the information. You can ask follow-up questions or request clarification in the same thread.

API keys#

Developers can integrate Ambient into their own applications using the Web2 API. To do so, you'll need to create an API key.

  1. Navigate to API Keys: From the sidebar menu, select API Keys. You'll see the Web2 API URL and a Keys section.
  2. Create a key: Click the Create Key button in the Keys section. Ambient will generate a secret key.
  3. Use the key in your code: The page shows example snippets for cURL, JavaScript and Python. Replace [YOUR_API_KEY] in the sample code with your actual key. You can then call Ambient's chat/completions endpoint at the Web2 API URL to get model responses.
  4. Manage keys: If a key is compromised, delete it and create a new one. There is no limit to the number of keys you can generate, but creating separate keys for different projects makes them easier to manage.

Keep going#

  • Using the web app walks through sign-in, usage, teams, Drops, and billing end to end.
  • Ambient Desktop is the local-first agentic workstation, for work that needs your real files and terminals.