Source: https://ailoot.ai/models/en/fish-audio-transcribe-1/ Canonical: https://ailoot.ai/models/en/fish-audio-transcribe-1/ Language: en # Fish Audio: Transcribe 1 [Markdown](https://ailoot.ai/models/en/fish-audio-transcribe-1/index.md) · [JSON](https://ailoot.ai/models/en/fish-audio-transcribe-1/facts.json) ## [Fish Audio: Transcribe 1](https://ailoot.ai/models/en/fish-audio-transcribe-1/) Transcribe 1 converts short audio recordings into text with automatic language detection and optional word-level timestamps. Use the transcript for voice notes, searchable clips or caption preparation, keeping timed segments separate from the readable full text. - [**Ailoot Ultra · Transcription** `POST /v1/audio/transcriptions` `fish-audio/transcribe-1`](https://ailoot.ai/models/en/fish-audio-transcribe-1/#method-0) About the model This description covers the model’s capabilities. Available in Ailoot inputs, outputs and options are listed for the selected method below. Transcribe 1 is Fish Audio’s general speech-to-text model for short recordings. It accepts an audio file and returns the recognised words as text, with the recording’s duration, optional timed segments and language information when known. This model is useful for a short voice note, a spoken instruction, an excerpt from a recording or an audio clip that needs a readable text representation. An illustrative voice-note workflow keeps the recording together with its full transcript and an identifier for the original clip. A later application step can search that text, organise the note or develop a summary while preserving the spoken source. For a command, the transcript supplies recognised words to the application; any action is a separate interpretation and execution step. For an interview excerpt, record the clip’s position in the complete audio so a quotation can be checked at the right location. The producer accepts WAV, MP3, AAC including M4A/MP4, FLAC and Ogg containing Opus or Vorbis. Browser recordings in WebM should be converted to Ogg/Opus, MP3 or WAV for this model; Pro documents native support for additional containers. Supply one audio file per request. The base model’s documented request allowance is up to 50 MiB, with MP3 and Opus files kept under 25 MiB. File size and recording length are different considerations: a compressed file can fit the upload allowance while still taking too long to process. Transcribe 1 is designed for short recordings. The producer recommends Pro for audio longer than a few minutes; a long base-model request can fail if it exceeds the processing-time limit. When preparing a longer source for short-clip transcription, preserve each clip’s starting offset and confirm that the returned transcript covers the complete clip before combining the results. Add the original offset to local segment times to keep navigation connected to the full recording. The base model’s guidance should not be interpreted as Pro’s separate 60-minute allowance. The producer response includes text, duration and segments. Duration is expressed in seconds, and the readable full transcript should be kept as the primary wording of the clip. Timestamps are optional: ignore\_timestamps defaults to true in the producer API, while false requests word-level segments with text, start and end times in seconds. Requesting alignment adds processing time. An empty segments array can reflect skipped timing, no speech or temporarily unavailable alignment, so it should not automatically be interpreted as an empty full transcript. Segments are generally words, or a character or a few in Chinese and Japanese. Their text omits punctuation and can normalise a value differently from the full transcript; it is not a character-for-character copy of the readable response. A segment can have the same start and end time. Use segments for finding a position in the recording or preparing timed display, and use the full text when the wording and punctuation matter. Keep those two representations distinct in the resulting artifact. Language is detected automatically, whether or not an optional language hint is supplied. The producer documents lowercase ISO 639-1 codes for hints and returns a language code for application logic together with a language name for display when known. The response reports one language rather than every language in a recording that switches between languages. Keep the source wording and available language metadata with the result instead of treating the transcription request as a translation operation. For a caption workflow, group consecutive timed segments into readable cues rather than showing one word at a time. A useful output is an SRT or WebVTT file linked to the original clip, with cue boundaries that fit pauses and a manageable amount of text on screen. Check for missing timing and ensure each cue’s end follows its start. Caption grouping and file formatting are application steps built from the returned alignment, and their display choices should suit the player and audience. Transcribe 1’s documented controls are audio, a language hint and the timestamp choice. Pro’s speaker markers, structured speaker turns, emotion-event controls and speaker-count hints are separate features; they are not part of this base model’s documented response contract. Choose the required artifact before processing: plain readable text for a note, or text together with alignment for playback navigation and captions. Preserving the clip identifier, transcript and any available timing makes that result useful for the next application stage. **Ailoot Ultra · Transcription** `POST /v1/audio/transcriptions` `fish-audio/transcribe-1` [`fish-audio/transcribe-1`](https://ailoot.ai/models/en/#m=fish-audio%2Ftranscribe-1&route=Ultra&caller=fish-audio%2Ftranscribe-1&fmt=transcriptions) Fish Audio /`fish-audio/transcribe-1` ### Overview Transcribe 1 converts short audio recordings into text with automatic language detection and optional word-level timestamps. Use the transcript for voice notes, searchable clips or caption preparation, keeping timed segments separate from the readable full text. Accepted inputs Audio Results Text ### Available in Ailoot · inputs & methods **Ailoot Ultra · Transcription** `POST /v1/audio/transcriptions` Input types `audio` Output types `text` | Field | Type | Requirement | Values & limits | Default | | --- | --- | --- | --- | --- | | Field`model` | Type`string` | RequirementRequired | Values & limits fish-audio/transcribe-1 | Default— | | Field`input_audio` | Type`object` | RequirementRequired | Values & limits | Default— | Method parameters and lifecycle | Parameter | Contract | | --- | --- | | Parameter`content_type` | Contractapplication/json | | Parameter`required` | Contractmodel, input\_audio | | Parameter`material_types` | Contractaudio | | Parameter`material_conditions` | ContractThe example reads your actual nonempty PCM WAV file, encodes the complete file bytes as base64 and sends input\_audio.format as wav. | Lifecycle: `synchronous_result_then_owned_library` `GET /v1/media/tasks/{task_id}` · exact task\_id from an existing owned media record `GET /v1/media/assets/{asset_id}/content` `GET /v1/media/assets` `GET /v1/media/assets/{asset_id}` ### Pricing Tariff references do not add request options. Supported parameters are listed for the selected method. Fast mode Not specified When fast mode is selected Flex mode Not specified When flex mode is selected Maximum reasoning effort Not specified When maximum reasoning effort uses the default adjustment #### Ailoot rates #### Prices by configuration Match each charge to the conditions shown. Use one rate for each set of alternative configurations. | Configuration | Rate schedule | Billing unit | Charge | | --- | --- | --- | --- | | ConfigurationBase token rates | Rate scheduleBase rate | Billing unit— | Charge Input · Input tokens **—** / 1K tokens Output · Output tokens **—** / 1K tokens Input · Cache read **—** / 1K tokens Input · Cache write **—** / 1K tokens Input · Cache write, 1 hour **—** / 1K tokens | | Configurationinput audio second | Rate schedule— | Billing unitper input audio second | Charge Input · input audio second **$0.0002** per input audio second | Ailoot reserves an estimated amount before a request. After the result, it settles the final charge from measured usage. Streaming settlement uses the final usage record. [How reservation and settlement work →](https://ailoot.ai/docs/en/billing/reserve/) ### Example requests #### Ailoot Ultra · Transcription curl · actual WAV file and complete original result ```bash set -eu : "${AILOOT_API_KEY:?Set your Ailoot API key}" : "${AILOOT_AUDIO_FILE:?Set the path to your actual PCM WAV recording}" export AILOOT_AUDIO_FILE python3 - <<'PY_REQUEST' import base64, io, json, os, wave from pathlib import Path audio = Path(os.environ['AILOOT_AUDIO_FILE']).read_bytes() if not (audio[:4] == b'RIFF' and audio[8:12] == b'WAVE'): raise SystemExit('Supply your actual PCM WAV audio file') with wave.open(io.BytesIO(audio), 'rb') as recording: if recording.getcomptype() != 'NONE' or recording.getnframes() <= 0: raise SystemExit('Supply a nonempty PCM WAV recording') request = {'model': 'fish-audio/transcribe-1', 'input_audio': {'data': base64.b64encode(audio).decode('ascii'), 'format': 'wav'}} Path('request.json').write_text(json.dumps(request, ensure_ascii=False), encoding='utf-8') PY_REQUEST curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/audio/transcriptions \ -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \ --data-binary @request.json -D response-headers.txt -o response.bin # Retain the complete original response, headers and actual X-Client-Request-ID. # Read existing owned records for recovery; do not resubmit an uncertain operation. ``` ### Receive and save results #### Ailoot Ultra · Transcription Complete original response body, status and forwarded headers. No universal JSON shape, text field or task envelope is added by this handler. - `GET /v1/media/tasks/{task_id}` - `GET /v1/media/assets/{asset_id}/content` - `GET /v1/media/assets` - `GET /v1/media/assets/{asset_id}` ##### Keep all completed results Keep every complete returned response, file and content part. Retain the complete response and headers, every actual output, original returned identifiers and all usage fields. Recover the original operation without submitting creation again. ##### If the original response needs checking Retain the actual X-Client-Request-ID and complete response. Read the original owned assets and their exact signed content URLs; never resubmit an uncertain creation. Response fields | Field | Type | | --- | --- | | Field`text (when present)` | Type | | Field`usage (when present)` | Type | Errors and next steps | Response | Condition | Next step | | --- | --- | --- | | Response400 · `invalid_request_error` | ConditionThe JSON body or explicit canonical model ID is invalid. | Next stepRetain the response and correct the indicated request field. | | Response401 · `authentication_error` | ConditionThe Ailoot API key is invalid. | Next stepUse your authorized Ailoot API key. | | Response403 · `permission_error` | ConditionThe key group does not admit this method. | Next stepRetain the returned error details. | | Response404 · `not_found_error` | ConditionThe selected method has no admitted route. | Next stepRetain the returned error details. | | Response422 · `price_unavailable` | ConditionThe accepted tariff cannot obtain its required input quantity or bound. | Next stepRetain the response; use the input representation required by the accepted tariff. | | Response503 · `` | ConditionRequired storage, route, method price or reservation is unavailable. | Next stepKeep the complete original response. An uncertain reservation is not permission to resubmit. | | Response502 · `server_error` | ConditionThe original result, usage or settlement requires checking. | Next stepRetain the actual request ID and original response. Read the existing owned record; do not resubmit creation. | ### Aliases #### Model aliases **Ailoot Ultra** [`fish-audio/transcribe-1`](https://ailoot.ai/models/en/#m=fish-audio%2Ftranscribe-1&route=Ultra&caller=fish-audio%2Ftranscribe-1&fmt=transcriptions) #### Method path aliases Use the method paths shown above. #### Related caller IDs [`fish-audio/transcribe-1`](https://ailoot.ai/models/en/#m=fish-audio%2Ftranscribe-1&route=Ultra&caller=fish-audio%2Ftranscribe-1&fmt=transcriptions) FAQ · Fish Audio: Transcribe 1 What inputs and results are available? `POST /v1/audio/transcriptions` · `fish-audio/transcribe-1`: `audio` → `text` Which fields does the request use? `POST /v1/audio/transcriptions` · `fish-audio/transcribe-1`: `model`, `input_audio` Connect Ailoot to Claude Code, OpenCode, Hermes or your own app. ## The company and its project portfolio The company and its project portfolio: millions of customers; monthly sales in the billions. ## Buy tokens at a discount. Subscription discounts for regular use. Promo codes offer up to 50% off token purchases. Subscription Choose a discounted plan for your regular requests. Promo code: up to 50% off Enter your code at checkout. The price updates to reflect the current promotion. Spending in your history The model, tokens and amount are recorded for each request. [Choose a subscription](https://ailoot.ai/docs/en/billing/subscriptions/) · [View model prices](https://ailoot.ai/models/en/) ## Connect the API to a product you sell. Use Ailoot in SaaS, apps and bots under its official service offer and licence agreement. Request a reseller licence for resale. Commercial application Add text, image, video and audio generation to paid features in your service. Reseller licence Send a description of your project and how you provide access. Request written terms for use and resale. Documents on the website The service offer, licence agreement and data processing policy are available before you connect. [Request a reseller licence](mailto:support@ailoot.ai) · [Service offer and licence agreement](https://ailoot.ai/legal/offer?lang=en) ## Ailoot · The company and its project portfolio Ailoot combines established operating experience, a large client base, stable service and ongoing KPI control. The company and its project portfolio: millions of customers; monthly sales in the billions. Ailoot brings that operating experience to API access for AI features in customer products, agents, applications and automations.