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

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

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

# 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 charge once and synthesize the same content. 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.

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 own model names are not served and answer 400.

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 "text" or "srt" or "vtt"

What the response body carries. "json" (the default) answers application/json with the transcript in a text field. "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 60 characters a line. OpenAI's verbose_json is not served and answers 400. Every format is billed the same, by the recording's length.

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

การตอบกลับ#

The transcribed recording, in OpenAI's shape. Returned when response_format is "json" or absent.

textstringจำเป็น

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

ข้อผิดพลาด#

400validationThe request body or headers failed validation against the endpoint schema.

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 speech slot.

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.

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