<aside>

Overview

:ambient-logo-original: Docs Home

What is Ambient?

Getting Started

Testnet

App

API

On-Chain

Tool Oracle

Claude Code

Miners

Encyclopedia

Solana Quickstart

Developers

OpenAI SDK

Anthropic SDK

API Docs

API Playground

Links

🌐 Homepage

✉️ [email protected]

:discord-symbol-blurple: Discord

:github-mark-white-bg: github.com/ambient-xyz

:x-logo-black: @ambient_xyz

:x-logo-black: @IridiumEagle

</aside>

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. Important: treat this key like a password—do not share it publicly.
  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 we recommend creating separate keys for different projects for easier management.

Chat