Enum FinishReason 

pub enum FinishReason {
    Stop,
    Length,
    ToolCalls,
    ContentFilter,
    Other(String),
}

Why the model stopped generating, normalized across providers.

The variant a caller acts on is FinishReason::Length: the output hit a token limit — the request’s own max_tokens, or whatever the serving stack enforces on its own — and the content is cut mid-thought. That arrives as HTTP 200 with no refusal, so this field is the only thing in the response that says the text is incomplete.

Variants

Stop

The model finished on its own.

Length

Generation was cut at an output-token limit; the content is incomplete.

ToolCalls

The model stopped to call tools.

ContentFilter

The provider suppressed output (safety filter, recitation).

Other(String)

A reason this crate does not recognize, kept verbatim.

Implementations

impl FinishReason

pub fn from_wire(value: &str) -> Self

Reads a provider’s wire spelling. OpenAI-compatible endpoints (OpenAI, OpenRouter, llama.cpp, vLLM) say stop / length / tool_calls / function_call / content_filter; Gemini says STOP / MAX_TOKENS / SAFETY / … — one reader for both, since the spellings do not collide.

Trait Implementations

impl Clone for FinishReason

fn clone(&self) -> FinishReason

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for FinishReason

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for FinishReason

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for FinishReason

impl PartialEq for FinishReason

fn eq(&self, other: &FinishReason) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for FinishReason