---
title: "Streaming (SSE) natural-language Q&A over a US coordinate"
method: POST
path: "/v1/ask/stream"
---

# Streaming (SSE) natural-language Q&A over a US coordinate

`POST /v1/ask/stream`

## Request

- Base URL: `https://api.mireye.com`
- URL: `https://api.mireye.com/v1/ask/stream`
- Auth: none declared
- TypeScript: <https://skmtc.dev/mireye/apis/mireye-earth/docs/v1/ask/stream/post.ts> (a function with typed inputs; its response is checked against the schema)

Server-Sent Events variant of `/v1/ask`, same request body. Emits `delta` frames as the answer is synthesized (first tokens ~5-7 s), then one terminal `final` frame carrying the full `/v1/ask` body, or an `error` frame on mid-stream failure. Same 110 s deadline and `429 ask_busy` back-pressure as the buffered route; failures before the first byte surface as a real HTTP status (with `Retry-After` when retryable). Set a client timeout of at least 120 s.

## Headers

- `Idempotency-Key` string, nullable

## Request body

- AskRequest
  - `address` string, nullable
  - `include_trace` boolean
  - `lat` number, nullable
  - `lng` number, nullable
  - `max_cost_usd` string, nullable
  - `question` string, required

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/mireye/apis/mireye-earth.md) - [All operations](https://skmtc.dev/mireye/apis/mireye-earth/llms.txt) - [OpenAPI document](https://skmtc.dev/mireye/apis/mireye-earth/revisions/d8410ba83654?raw)