文字起こし API

AI文字起こしとプロジェクト作成のためにメディアを送信します。動画と音声ファイルの両方をサポートしています。

POST/api/v1/transcribe

クイック実装

curl -X POST https://api.srtgen.com/api/v1/transcribe \
  -H "x-api-key: <YOUR_API_KEY>" \
  -F "file=@/path/to/your/video.mp4"

POSThttps://api.srtgen.com/api/v1/transcribe

リクエストパラメータ

パラメータ	タイプ	必須	説明
`file`	File	Yes	文字起こしするメディアファイル (Multipart)。サポート形式: 動画 (mp4, mov, avi, webm, mkv), 音声 (mp3, wav, m4a, flac)。最大2GB。
`videoUrl`	String	No*	メディアの外部リンク (本文にファイルが提供されない場合は必須)。
`name`	String	No	プロジェクトのカスタム名。
`languageCode`	String	No	ソース言語コード (例: 'en-us')。省略した場合は 'auto' (自動検出) になります。
`filterProfanity`	Boolean	No	不適切な言葉を自動検閲するかどうか。デフォルトは false です。
`disfluencies`	Boolean	No	フィラー（'えー'、'あのー'など）を含めるかどうか。デフォルトは false です。
`medicalMode`	Boolean	No	ヘルスケア/医療音声用に最適化された文字起こし。デフォルトは false です。

高度: URL + AI設定

curl -X POST https://api.srtgen.com/api/v1/transcribe \
  -H "x-api-key: <YOUR_API_KEY>" \
  -F "videoUrl=https://example.com/medical_lecture.mp4" \
  -F "languageCode=en-us" \
  -F "filterProfanity=true" \
  -F "disfluencies=false" \
  -F "medicalMode=true"

POSThttps://api.srtgen.com/api/v1/transcribe

成功レスポンス

リクエストに成功すると、プロジェクトとバックグラウンドジョブの詳細を含む200 OKステータスを返します。

projectIdプロジェクトの一意の識別子。
status'inProgress' (文字起こし進行中)。
注意: クレジットは、文字起こしプロセスが完了した後に、残高から非同期で計算・差し引かれます。

{
  "success": true,
  "projectId": "proj_8k2n9m1b",
  "status": "inProgress"
}

エラーコード

ステータス	エラーコード	説明
400	missing_file	'file' または 'video' フィールドにファイルが見つかりません。
400	unreachable_url	提供された videoUrl にアクセスできないか、エラーが返されました。
400	invalid_parameter	パラメータの1つ（例: videoUrl）が不正です。
400	file_read_failed	アップロードされたファイルを読み取ることができないか、破損しています。
401	unauthorized	APIキーが欠落しているか無効です。
403	insufficient_balance	このメディアの長さを処理するためのクレジットが不足しています。
403	storage_quota_exceeded	ファイルがプランの残りクラウドストレージ容量を超えています。
413	payload_too_large	ファイルがシステムの絶対的なアップロード制限である2GBを超えています。
500	transcription_failed	文字起こしジョブを開始できませんでした（AIプロバイダーの停止）。
500	server_error	問題が発生しました。しばらくしてからもう一度お試しください。

エラーレスポンス構造

{
  "success": false,
  "error": "insufficient_balance",
  "message": "プロジェクトには5クレジット必要ですが、残高は2です。"
}

このページは役に立ちましたか？