Individual skill
stepfun-asr
Transcribes Chinese/English audio with StepFun's stepaudio-3-asr-max via its SSE endpoint (not /v1/audio/transcriptions) — one call handles long-form audio with no chunking. Use when migrating from step-asr/stepaudio-2.5-asr, or hitting the misleading "model not supported" error (actually wrong endpoint). Triggers on 阶跃 ASR, 语音识别. Not for TTS with the sibling model (use stepfun-tts).
daymade-audio/stepfun-asr/SKILL.md
Source commit 7c4d326ddd94d504e00e241ba49498e95160afbe
What was checked
- Matches the observed repository HEAD
- Yes
- Scanner rules are current
- Yes
- Repository scan complete
- No
- Skill scan complete
- No
- Observed behavior
- Network or broad shell
- Last checked
- Nov 4, 2026
These are observations at the recorded commit, not a guarantee of safety. Review the source before running it.
Install this skill
Choose an agent in your Stack or copy a command below. Commands fetch the pinned commit and copy only this skill directory. Existing destinations are refused. Copying a command does not install anything.
An install command is unavailable: current rules, complete repository and skill scans, an eligible behavior level and a permitted license are required.
Repository context
- Repository stars (not skill ratings)
- 1,522
- Repository last updated
- Nov 6, 2026
- License
- MIT
Observed agent integration: No specific integration evidence. Standard SKILL.md installation does not imply verified compatibility.
- engineering Derived category
Files and excerpt
File metadata and permitted, redacted excerpts come from the recorded scan. Source links are pinned to that commit.
Browse files
SKILL.mdcore · 13,621 bytesSKILL.mdcore · 13,621 bytesSKILL.mdcore · 13,621 bytesSKILL.mdcore · 13,621 bytesSKILL.mdcore · 13,621 bytesSKILL.mdcore · 13,621 bytesSKILL.mdcore · 13,621 bytesSKILL.mdcore · 13,621 bytesSKILL.mdcore · 13,621 bytesSKILL.mdcore · 13,621 bytesreferences/api_reference.mddoc · 7,306 bytesreferences/known_issues.mddoc · 12,418 bytesscripts/asr_file.pyruns · 5,419 bytesscripts/asr_transcribe.pyruns · 12,600 bytesscripts/check_params.pyruns · 5,004 bytestests/test_routes.pyruns · 4,736 bytes
Read excerpt
# StepFun stepaudio-3-asr-max
Transcribe audio with StepFun's `stepaudio-3-asr-max` (StepAudio 3, released 2026-09-15, verified 2026-09-16; supersedes `stepaudio-2.5-asr` on the same endpoint). Long audio in one call, no chunking — but **only** if the request hits the right endpoint with the right body shape. The wrong endpoint returns an error that looks identical to "model doesn't exist", which is the #1 reason this skill exists.
> Companion: for TTS with `stepaudio-3-tts` (the sibling model), use the `stepfun-tts` skill — they share an API key but live on different endpoints with different body shapes.
## Why this skill exists — three traps that cost hours
1. **Wrong endpoint, wrong error**. `stepaudio-3-asr-max` does **not** live on `/v1/audio/transcriptions` (that endpoint serves the older `step-asr` family). It lives on `/v1/audio/asr/sse` — SSE streaming, JSON body, base64 audio. Sending it to the wrong endpoint returns `{"error":{"message":"model stepaudio-3-asr-max not supported"}}`, which is **identical in structure** to a genuinely nonexistent model name. People waste hours filing whitelist tickets.
2. **Subscription endpoint vs wallet endpoint**. Step Plan supports `stepaudio-2.5-asr` at `https://api.stepfun.com/step_plan/v1/audio/asr/sse`; the wallet endpoint serves `stepaudio-3-asr-max`. Choose the endpoint and supported model together. Do not infer that Plan is text-only or that changing only a key changes the billing account.
3. **SSE error events are real**. Censorship can fire on the ASR side too (rarely). Don't assume only `transcript.text.delta` and `transcript.text.done` events arrive — handle `type: error` events in the stream or you'll silently drop them.