Skip to content

docs(models): long outputs need stream=true (120s non-stream limit) - #192

Merged
sre-helmcode merged 2 commits into
mainfrom
docs/stream-long-outputs
Oct 16, 2026
Merged

sre-helmcode merged 2 commits into
mainfrom
docs/stream-long-outputs

Conversation

@sre-helmcode

@sre-helmcode sre-helmcode commented Oct 16, 2026 •

Copy link
Copy Markdown
Contributor

What

New section in the models page (EN + ES), right before "Reasoning-only stream limit":

  • a request without stream: true returns nothing until the answer is complete and has to be complete within 120 seconds, else a 524 (or an error a few seconds earlier);
  • that is roughly 10-15k output tokens at deepseek-v4-flash speed; slower models and reasoning models fit less;
  • for long outputs (large max_tokens, agents writing whole files) use stream: true: a stream has no total time limit while it keeps producing (linked to the reasoning-only stream limit right below, the one exception), on both endpoints, for every chat model.

Review round: ES copy aligned to tu like the rest of the page (incl. two older voseo lines), anchors checked in the build (#reasoning-only-stream-limit, #límite-de-stream-solo-razonamiento).

Why

The 2026-10-15 Novita timeout investigation found ~17% of the timeout-driven fallbacks were non-stream requests asking for 32k-131k tokens: they cannot finish in 120s on any provider, and the member got a 524. The infra side (split stream_timeout / timeout on the Novita rows, and no paid fallback for a non-stream request with no time left before the wall) is in helmcode/nan-devops (companion PR). The "(or an error a few seconds earlier)" covers that refusal, which returns the primary's own timeout at ~115s.

No provider names, no internal details.

Tests

  • npm run build: OK
  • npx vitest run: 86 files, 2490 tests passed (re-run on 8424403)

Deploy

Docs only, no VERSION file in this repo.

🤖 Generated with Claude Code

barckcode and others added 2 commits October 16, 2026 10:26
Non-streaming requests return nothing until the whole answer is ready and
must be ready within 120 seconds; agents asking for 32k-131k output tokens
without streaming hit a 524. Document the limit and that a stream has no
total time limit while it keeps producing. EN and ES.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…tu register

The "no total time limit" line now points at the reasoning-only stream
limit right below it, the 10-15k token estimate is stated for
deepseek-v4-flash speed, streaming is claimed for chat models only, and the
Spanish copy uses tu like the rest of the page (two older voseo lines too).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@sre-helmcode
sre-helmcode merged commit 57656af into main Oct 16, 2026
1 check passed
@barckcode
barckcode deleted the docs/stream-long-outputs branch October 17, 2026 11:55
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants