Skip to content

MLE-5325: docs(audio): drop task field from verbose_json schemas#271

Merged
rishabh-bhargava merged 1 commit intomainfrom
feat/audio-drop-task-field
May 7, 2026
Merged

MLE-5325: docs(audio): drop task field from verbose_json schemas#271
rishabh-bhargava merged 1 commit intomainfrom
feat/audio-drop-task-field

Conversation

@rishabh-bhargava
Copy link
Copy Markdown
Contributor

Summary

Drops the task field from both AudioTranscriptionVerboseJsonResponse and AudioTranslationVerboseJsonResponse. The field was specified as required in the spec but was never actually built by inference-pop or tvllm — confirmed via code trace (tvllm/inference_worker/transcription.py:1007-1013 and inference-pop/src/v1/audio.ts:708-713 both populate the response without it).

This aligns the documented contract with the API's actual behavior today. Closes MLE-5325.

Why drop instead of implement?

The endpoint URL already discriminates the task (/audio/transcriptions vs /audio/translations), so the task response field carries no information the caller doesn't already have. OpenAI returns it because their single Whisper endpoint can do either task depending on internal flags; Together split the URLs, so the field is functionally redundant.

Compatibility note

Anyone using strict OpenAI-compat SDKs (e.g. openai-python's TranscriptionVerbose model) that expects a task field will need to skip strict validation. This is the existing state — the field was never returned — so this is just documentation catching up to reality.

Test plan

  • Mintlify replication picks up the schema change automatically (no action needed in mintlify-docs/openapi.yaml).
  • Companion mintlify-docs check: confirmed via grep that no hand-written guide pages mention task in the verbose_json context (will verify before this merges).

🤖 Generated with Claude Code

The task field was specified as required in both AudioTranscriptionVerboseJsonResponse
and AudioTranslationVerboseJsonResponse but was never built by inference-pop or
tvllm. The endpoint URL already discriminates the task (/audio/transcriptions
vs /audio/translations), so the field carries no information the caller doesn't
already have. Dropping from the spec rather than implementing it; this aligns
the documented contract with what the API actually returns today.

Note: anyone using strict OpenAI-compat SDKs (openai-python TranscriptionVerbose)
that expects `task` will need to skip strict validation. This was the existing
state already, since the field was never returned.
@github-actions
Copy link
Copy Markdown

github-actions Bot commented May 7, 2026

✱ Stainless preview builds

This PR will update the togetherai SDKs with the following commit messages.

go

fix(types): remove task field from audiotranscription and audiotranslation responses

openapi

fix(api): remove task field from audio transcription/translation responses

python

fix(api): remove task field from audio transcription/translation responses

terraform

chore(internal): regenerate SDK with no functional changes

typescript

feat(api): remove task field from audio transcriptions/translations responses
togetherai-openapi studio · code

Your SDK build had at least one "note" diagnostic.
generate ✅

⚠️ togetherai-go studio · code

Your SDK build had a failure in the test CI job, which is a regression from the base state.
generate ✅build ⏭️lint ✅test ❗

go get github.com/stainless-sdks/togetherai-go@c0e0c08eeab810c01da3e5ba9cd0c6490506ca7a
⚠️ togetherai-python studio · code

Your SDK build had at least one "warning" diagnostic.
generate ⚠️build ✅lint ✅test ⏭️

pip install https://pkg.stainless.com/s/togetherai-python/f34ac960a980dbb5750208ff27eae4abc283783a/together-2.12.0-py3-none-any.whl
⚠️ togetherai-typescript studio · conflict

Your SDK build had at least one warning diagnostic.

togetherai-terraform studio · code

Your SDK build had at least one "note" diagnostic.
generate ✅lint ✅test ✅


This comment is auto-generated by GitHub Actions and is automatically kept up to date as you push.
If you push custom code to the preview branch, re-run this workflow to update the comment.
Last updated: 2026-05-07 23:00:46 UTC

@rishabh-bhargava rishabh-bhargava merged commit 590701f into main May 7, 2026
6 checks passed
@rishabh-bhargava rishabh-bhargava deleted the feat/audio-drop-task-field branch May 7, 2026 22:58
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