Rewrite transcribe-an-audio-file page for universal launch

[devin-ai-integration]

Summary

Completely rewrites the "Transcribe a pre-recorded audio file" Getting Started page (transcribe-an-audio-file2.mdx) for the upcoming universal launch. This is a full page restructure, not just an overview update.

New Page Structure

• Overview: Introduces the guide and lists three main things to specify (speech models, region, other models)
• Prerequisites: Language-specific requirements (tabbed for all 4 languages)
• Step 1: Set up API credentials (with EU endpoint notes)
• Step 2: Specify audio source (URL or local file upload)
• Step 3: Submit transcription request
• Step 4: Poll for results
• Step 5: Access speaker diarization (optional)
• Complete example: Full working code for each language
• Next steps: Links to related features

Code Example Updates

All four language examples (Python SDK, Python, JavaScript SDK, JavaScript) now include:

• speech_models: ["universal-3-pro", "universal-2"]
• language_detection: true
• speaker_labels: true
• EU endpoint configuration notes
• Audio file URL changed to wildfires.mp3
• Commented diarization output section

Removed Content

• Old tutorial format with <Steps> components
• "Before you begin" section (replaced by Prerequisites)
• "Need some help?" section
• Speech model selection step (now integrated into Step 3)

Review & Testing Checklist for Human

• Verify SDK enum values exist: Confirm aai.SpeechModel.universal_3_pro and aai.SpeechModel.universal_2 are valid in the Python SDK
• Verify API parameters: Confirm speech_models, language_detection, and speaker_labels are correct parameter names
• Verify speech model values: Confirm ["universal-3-pro", "universal-2"] are the correct model identifiers for universal launch
• Review page structure: This is a significant UX change from the old tutorial format - verify the new guide format is acceptable
• Test locally: Run fern docs dev and preview at http://localhost:3000/docs/getting-started/transcribe-an-audio-file to verify formatting and tab switching works correctly

Notes

The CI checks (fern-check and lint) that failed are pre-existing issues in the API specification files (transcripts.yml) and are unrelated to this documentation change. The docs validation passed: [docs]:✓ All checks passed.

Requested by: @LeeVaughn

Link to Devin run: https://app.devin.ai/sessions/bf3df1722af344bc959fe4c0a9992753

[devin-ai-integration]

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

• Address comments on this PR. Add '(aside)' to your comment to have me ignore it.
• Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

• Disable automatic comment and CI monitoring

[github-actions]

🌿 Preview your docs: https://assemblyai-preview-eed0c31a-6628-4fda-ae79-33d2068de316.docs.buildwithfern.com/docs

[github-actions]

🌿 Preview your docs: https://assemblyai-preview-8c979b2a-b7d5-44d0-b14b-368720eaa3ad.docs.buildwithfern.com/docs

[github-actions]

🌿 Preview your docs: https://assemblyai-preview-615adc04-cfcf-433a-8dc3-148fa7ece426.docs.buildwithfern.com/docs

[github-actions]

🌿 Preview your docs: https://assemblyai-preview-202e3d26-0d4c-462c-a0fb-6cfc7054642f.docs.buildwithfern.com/docs

[github-actions]

🌿 Preview your docs: https://assemblyai-preview-fd754961-5ec3-4c4e-8656-f51c3ab6fd5f.docs.buildwithfern.com/docs

[github-actions]

🌿 Preview your docs: https://assemblyai-preview-b121e8b0-01ef-41ff-b55f-94d00284343a.docs.buildwithfern.com/docs

[github-actions]

🌿 Preview your docs: https://assemblyai-preview-85d3fed2-b575-4bea-97fd-1d5e1bbbfca4.docs.buildwithfern.com/docs