Highlights
- Multi-step research — Plans its own searches and follows up on what it finds, instead of grounding in a single search.
- Cited output —
output.textis a cited Markdown report, with inline[n]markers pointing atoutput.sources. - Optional structured output — Pass
output_schemato also getoutput.structured, a JSON result shaped by your schema, plusoutput.groundingfor field-level citations. - Async by design —
createreturns at once with the run inpendingstate; pollgetyourself, or letwait/createAndWaitdo it for you. - Best-effort cancellation —
cancelrequests that a run stop; a run close to finishing can still complete before cancellation takes effect.
Quick Start
Concepts
The run lifecycle, output shapes, and citations
Quickstart
Make your first request