Ae · Deepgram · Post · Listen · Transcribe

1.00积分/次
ae_deepgram_post_listen_transcribe

使用 Deepgram 的语音转文本 API,将 URL 中的音频或视频文件转录为文本。

转录音频视频
1.00积分/次

价格说明

1.00积分/次

API 调用

通过统一工具网关发起同步请求,鉴权和计费由 AgentEarth 处理。

cURL
curl --request POST \
  --url 'https://api.agentearth.ai/v1/tools/run' \
  --header 'Authorization: Bearer $AGENTEARTH_API_KEY' \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "tool": "ae_deepgram_post_listen_transcribe",
  "input": {
    "tag": "xxx",
    "url": "xxx",
    "extra": "xxx",
    "model": "base-general",
    "redact": "xxx",
    "search": "xxx",
    "topics": "false",
    "diarize": "false",
    "intents": "false",
    "keyterm": "xxx",
    "replace": "xxx",
    "version": "latest",
    "encoding": "xxx",
    "keywords": "xxx",
    "language": "en",
    "numerals": "false",
    "dictation": "false",
    "punctuate": "false",
    "sentiment": "false",
    "summarize": "xxx",
    "utt_split": "0.8",
    "paragraphs": "false",
    "utterances": "false",
    "mip_opt_out": "false",
    "custom_topic": "xxx",
    "filler_words": "false",
    "measurements": "false",
    "multichannel": "false",
    "smart_format": "false",
    "custom_intent": "xxx",
    "diarize_model": "xxx",
    "detect_entities": "false",
    "detect_language": "xxx",
    "profanity_filter": "false",
    "custom_topic_mode": "extended",
    "custom_intent_mode": "extended"
  }
}'
请求方式
POST
接口地址
/v1/tools/run
鉴权方式
Bearer Token
超时时间
60 秒
当前版本
—
响应示例
{
  "error_no": 0,
  "error_msg": "",
  "result": [
    {
      "type": "text",
      "text": "xxx"
    }
  ],
  "platform_annotations": {
    "source": "AgentEarth",
    "platform_note": "xxx",
    "platform_suggestion": "xxx"
  }
}

工具参数

未传入的可选参数将使用平台默认值。

参数类型必填说明默认值
tagunknown否Label your requests for the purpose of identification during usage reporting—
urlstring是暂无参数说明。—
extraunknown否Arbitrary key-value pairs that are attached to the API response for usage in downstream processing—
modelstring否AI model used to process submitted audiobase-general
redactunknown否Redaction removes sensitive information from your transcripts—
searchunknown否Search for terms or phrases in submitted audio—
topicsboolean否Detect topics throughout a transcript or textfalse
diarizeboolean否Deprecated: use `diarize_model` instead. Recognize speaker changes. Each word in the transcript will be assigned a speaker number starting at 0.false
intentsboolean否Recognizes speaker intent throughout a transcript or textfalse
keytermarray否Key term prompting can boost or suppress specialized terminology and brands. Only compatible with Nova-3—
replaceunknown否Search for terms or phrases in submitted audio and replaces them—
versionstring否Version of an AI model to uselatest
encodingenum (linear16 | flac | mulaw | amr-nb | amr-wb | opus | speex | g729)否Specify the expected encoding of your submitted audio—
keywordsunknown否Keywords can boost or suppress specialized terminology and brands—
languagestring否The [BCP-47 language tag](https://tools.ietf.org/html/bcp47) that hints at the primary spoken language. Depending on the Model and API endpoint you choose only certain languages are availableen
numeralsboolean否Numerals converts numbers from written format to numerical formatfalse
dictationboolean否Dictation mode for controlling formatting with dictated speechfalse
punctuateboolean否Add punctuation and capitalization to the transcriptfalse
sentimentboolean否Recognizes the sentiment throughout a transcript or textfalse
summarizeunknown否Summarize content. For Listen API, supports string version option. For Read API, accepts boolean only.—
utt_splitnumber否Seconds to wait before detecting a pause between words in submitted audio0.8
paragraphsboolean否Splits audio into paragraphs to improve transcript readabilityfalse
utterancesboolean否Segments speech into meaningful semantic unitsfalse
mip_opt_outboolean否Opts out requests from the Deepgram Model Improvement Program. Refer to our Docs for pricing impacts before setting this to true. https://dpgr.am/deepgram-mipfalse
custom_topicunknown否Custom topics you want the model to detect within your input audio or text if present Submit up to `100`.—
filler_wordsboolean否Filler Words can help transcribe interruptions in your audio, like "uh" and "um"false
measurementsboolean否Spoken measurements will be converted to their corresponding abbreviationsfalse
multichannelboolean否Transcribe each audio channel independentlyfalse
smart_formatboolean否Apply formatting to transcript output. When set to true, additional formatting will be applied to transcripts to improve readabilityfalse
custom_intentunknown否Custom intents you want the model to detect within your input audio if present—
diarize_modelenum (latest | v1 | v2)否Select and enable a specific diarization model version. Specifying this parameter enables diarization and selects the model — you do not need to also set the deprecated `diarize=true` parameter. For batch, supported values are `latest` (currently v2), `v1`, and `v2`. For streaming, supported values are `latest` (currently v1) and `v1`; `v2` returns a validation error on streaming requests.—
detect_entitiesboolean否Identifies and extracts key entities from content in submitted audiofalse
detect_languageunknown否Identifies the dominant language spoken in submitted audio—
profanity_filterboolean否Profanity Filter looks for recognized profanity and converts it to the nearest recognized non-profane word or removes it from the transcript completelyfalse
custom_topic_modeenum (extended | strict)否Sets how the model will interpret strings submitted to the `custom_topic` param. When `strict`, the model will only return topics submitted using the `custom_topic` param. When `extended`, the model will return its own detected topics in addition to those submitted using the `custom_topic` paramextended
custom_intent_modeenum (extended | strict)否Sets how the model will interpret intents submitted to the `custom_intent` param. When `strict`, the model will only return intents submitted using the `custom_intent` param. When `extended`, the model will return its own detected intents in the `custom_intent` param.extended