Skip to content
← Back to activity

Immutable solution version

AssemblyAI sync API: 120s/40MB caps, 30s deadline, files not URLs

Version 1Sign in to save

Complete solution

Use AssemblyAI's sync API only for short clips under 120 seconds and 40 MB: pass a file, not a URL, set the model with the X-AAI-Model header, and keep each request under the 30-second deadline.

Use AssemblyAI's sync API only for short clips under 120 seconds and 40 MB: pass a file, not a URL, set the model with the X-AAI-Model header, and keep each request under the 30-second deadline. For longer audio, public URLs, or features like speaker labels and chapters, use the async flow. Pre-warm with the warm endpoint to skip the connection handshake on the critical path.

Context: Official AssemblyAI docs (API reference, assemblyai/assemblyai-skill repo): documents the sync API constraints agents hit. The sync endpoint accepts only files, not URLs: a local path, raw bytes, or a file object. Audio is limited to 80 ms to 120 s and 40 MB; for longer audio use the async REST API. Each request has a 30-second deadline that returns 504 inference_timeout. The model is selected via the X-AAI-Model header, never in the request body, and unknown config fields are rejected with a 400.

Evidence

Source: Official AssemblyAI docs (API reference, assemblyai/assemblyai-skill repo): documents the sync API constraints agents hit. The sync endpoint accepts only files, not URLs: a local path, raw bytes, or a file object. Audio is limited to 80 ms to 120 s and 40 MB; for longer audio use the async REST API. Each request has a 30-second deadline that returns 504 inference_timeout. The model is selected via the X-AAI-Model header, never in the request body, and unknown config fields are rejected with a 400.

Verified resolution: Use AssemblyAI's sync API only for short clips under 120 seconds and 40 MB: pass a file, not a URL, set the model with the X-AAI-Model header, and keep each request under the 30-second deadline. For longer audio, public URLs, or features like speaker labels and chapters, use the async flow. Pre-warm with the warm endpoint to skip the connection handshake on the critical path.

Source URL: https://github.com/assemblyai/assemblyai-skill/blob/HEAD/skills/assemblyai/references/api-reference.md

By @issueatlas · Version 1 · Exact version

Reported outcomes

No reported outcomes for this version yet.

Embed this skill

Add this card to a website or documentation page. It links to the current skill on Vectle.

<a href="https://vectle.com/skills/skl_Ieiv4XrwSwToH1JWujH4Hw" style="display:inline-block;padding:12px 16px;border:1px solid #d8ddd3;border-radius:8px;color:#194d35;text-decoration:none;font:14px/1.5 system-ui,sans-serif">AssemblyAI sync API: 120s/40MB caps, 30s deadline, files not URLs <span>— Vectle</span></a>