ถอดเสียงบันทึก (แบบ OpenAI)

POSThttps://api.paxalabs.com/v1/audio/transcriptions

POST /v1/audio/transcriptions ให้บริการคำขอรูปแบบ audio.transcriptions ของ OpenAI ส่งไฟล์เสียงเป็น multipart และเลือกผลลัพธ์เป็น JSON ข้อความล้วน SubRip หรือ WebVTT ด้วย response_format

ดูเป็น Markdown

# The recording rides as a file part; nothing is base64 encoded.
curl -X POST https://api.paxalabs.com/v1/audio/transcriptions \
  --max-time 300 \
  -H "Authorization: Bearer $PAXA_API_KEY" \
  -F [email protected] \
  -F model=paxa-stt-lite-v1-preview \
  -F response_format=srt \
  -o meeting.srt

import { createReadStream } from "node:fs";
import { writeFile } from "node:fs/promises";
import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.paxalabs.com/v1",
  apiKey: process.env.PAXA_API_KEY,
});

const subtitles = await client.audio.transcriptions.create({
  file: createReadStream("meeting.m4a"),
  model: "paxa-stt-lite-v1-preview",
  response_format: "srt",
});

await writeFile("meeting.srt", subtitles);

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.paxalabs.com/v1",
    api_key=os.environ["PAXA_API_KEY"],
)

with open("meeting.m4a", "rb") as file:
    subtitles = client.audio.transcriptions.create(
        file=file,
        model="paxa-stt-lite-v1-preview",
        response_format="srt",
    )

with open("meeting.srt", "w") as out:
    out.write(subtitles)

ชี้ OpenAI SDK มาที่ https://api.paxalabs.com/v1 แล้วเรียก audio.transcriptions.create ราคา เพดานการใช้งาน และการคืนเครดิตเหมือน POST /v1/stt ซึ่งเป็นที่อยู่ของรูปแบบการเขียน ช่วงผู้พูด เวลาระดับคำ และคลังคำศัพท์ เอนด์พอยต์นี้ไม่อ่านฟิลด์เหล่านั้น ดูการจับคู่ฟิลด์ได้ที่คู่มือใช้ OpenAI SDK กับ Paxa

เฮดเดอร์#

authorizationBearer pxa_...จำเป็น

Authorization: Bearer pxa_... (recommended).

x-api-keypxa_...

Alternative to the Authorization header. Ignored when Authorization is present.

idempotency-keystring

Makes a retry safe: two requests carrying the same key are charged once. One request per key runs at a time. A concurrent duplicate answers 409 idempotency_in_flight. Reuse a key only to retry an identical request. A changed payload is rejected with 422. Accepts up to 200 printable ASCII characters other than space.

1 to 200 characterspattern ^[!-~]+$

การยืนยันตัวตน

เนื้อหา#

filefileจำเป็น

The recording, as a file part. MP3, WAV (PCM), FLAC, Ogg (Opus or Vorbis), M4A, AAC (ADTS), or WebM; the format and the length are read from the bytes. The part's filename and content type are ignored. Same ceilings, pricing, and refusals as the audio field on POST /v1/stt: up to 60 minutes and 26,214,400 bytes.

modelstringจำเป็น

Transcription model id, for example paxa-stt-lite-v1-preview. OpenAI's whisper-1, gpt-4o-transcribe, gpt-4o-mini-transcribe, gpt-4o-mini-transcribe-2025-03-20, gpt-4o-mini-transcribe-2025-12-15 are accepted and run on paxa-stt-lite-v1-preview.

1 to 100 charactersตัวอย่าง "paxa-stt-lite-v1-preview"

languagestring

The same field OpenAI defines. A BCP 47 tag the recording is expected to be in, such as "th". A hint that filters nothing. Omitted, the model detects the language itself.

up to 16 characterspattern ^[A-Za-z]{2,3}(-[A-Za-z0-9]{2,8})*$ตัวอย่าง "th"

response_format"json" or "verbose_json" or "text" or "srt" or "vtt"

What the response body carries. "json" (the default) answers application/json with the transcript in a text field. "verbose_json" answers OpenAI's verbose shape: the duration, the text, and the segments and words that timestamp_granularities names. "text" answers text/plain with the transcript alone. "srt" and "vtt" answer the subtitle file, cut the same way POST /v1/stt cuts it, at the default line length. Every format is billed the same, by the recording's length.

ค่าเริ่มต้น "json"

timestamp_granularitiesarray of "segment" or "word"s

The same field OpenAI defines, sent as one timestamp_granularities[] form field per value, and read only with verbose_json. "segment" fills segments and "word" fills words; omitted, segments alone are filled.

stream"false"

The OpenAI field of the same name. Streamed transcript events are not served here: "true" answers validation, and the transcript arrives as one body. WS /v1/stt/live transcribes as the audio arrives.

การตอบกลับ#

The transcribed recording, in OpenAI's shape. Returned when response_format is "json", "verbose_json", or absent; verbose_json adds the duration, segments, and words.

textstringจำเป็น

The transcript, verbatim in the language spoken. Empty when the recording carried no speech.

languagestring

The language hint the request sent, named as OpenAI names languages, such as "thai", or an empty string when it sent none. Carried by verbose_json.

durationnumber

The recording's length in seconds, carried by verbose_json.

segmentsarray of objects

The transcript cut into the cues POST /v1/stt cuts for subtitles, carried by verbose_json. OpenAI's decoding statistics are not measured. Their fields carry 0 and an empty tokens list, for clients that require OpenAI's full segment shape.

ดูฟิลด์ย่อย

segments[].idintegerจำเป็น

The segment's position, from 0.

segments[].seekintegerจำเป็น

Always 0.

segments[].startnumberจำเป็น

Start, in seconds.

segments[].endnumberจำเป็น

End, in seconds.

segments[].textstringจำเป็น

The segment's text, as the transcript renders it.

segments[].tokensarray of integersจำเป็น

Always empty.

segments[].temperaturenumberจำเป็น

Always 0.

segments[].avg_logprobnumberจำเป็น

Always 0.

segments[].compression_rationumberจำเป็น

Always 0.

segments[].no_speech_probnumberจำเป็น

Always 0.

wordsarray of objects

One entry per word, carried by verbose_json when timestamp_granularities names "word".

ดูฟิลด์ย่อย

words[].wordstringจำเป็น

The word, with Thai segmented.

words[].startnumberจำเป็น

Start, in seconds.

words[].endnumberจำเป็น

End, in seconds.

ข้อผิดพลาด#

400validationThe request body, query, or headers failed validation against the endpoint schema, or broke a rule the endpoint's reference states. A field the schema refused adds two fields to the problem body. path names the first failing field by location and name in dot form, such as body.voice or headers.idempotency-key. A body that could not be read gives the path body alone. reason is one stable code from the validation reasons list.

400unknown_modelThe model field does not name a served model.

400audio_invalidThe audio field could not be read as an MP3, WAV, FLAC, Ogg, M4A, AAC, or WebM recording, or its length could not be read from the container. A damaged or truncated file answers this code. Nothing was charged.

413audio_too_largeThe decoded recording exceeds the model's size ceiling. Nothing was charged.

400audio_too_longThe recording is longer than the model's per-request ceiling. Nothing was charged.

401unauthorizedThe request carried no API key, or the key is invalid or disabled.

402insufficient_creditsThe account does not have enough credits for this request. Nothing was charged.

403key_limitThis API key reached its spending cap. Nothing was charged.

409idempotency_in_flightAnother request with this Idempotency-Key is in flight right now.

409idempotency_refundedThe original request under this Idempotency-Key failed and was refunded.

422idempotency_mismatchThis Idempotency-Key was already used for a different request.

422content_blockedThe upstream safety system declined to process this content. The charge was refunded.

429rate_limitedRequests per minute for the plan are exhausted. One window covers the whole account, across every product and every key.

429concurrency_limitedThe account holds the plan's full count of concurrent requests for this product. Nothing was charged. Each product is limited separately, and an open live connection holds one slot of its product for its lifetime.

500internalRequest state was inconsistent on the server.

502provider_errorModel inference failed after the request was charged.

503provider_unavailableThe model behind this endpoint is not available right now. Nothing was charged.

ก่อนหน้าถอดเสียงแบบเรียลไทม์ถัดไปอ่านเอกสาร