Castingwords
castingwordsCastingWords offers high-quality, human-powered transcription services with a RESTful API for seamless integration into various workflows.
Acciones disponibles (8)
Cada acción es una operación que el agente puede ejecutar contra este conector. Haz clic en una acción para ver sus parámetros.
Cancel and Refund Audio FileCASTINGWORDS_CANCEL_AUDIOFILEAcciónTool to cancel an ordered audio file and issue a refund if applicable. use when no transcription work has been done on the file (pre-processing, audio processing, error states).
CASTINGWORDS_CANCEL_AUDIOFILEAcciónTool to cancel an ordered audio file and issue a refund if applicable. use when no transcription work has been done on the file (pre-processing, audio processing, error states).
Parámetros de entrada
teststringIf set to 'true', returns a fake approval for testing. Only valid when audiofile_id is 100 or 101.
audiofile_idintegerObligatorioID of the audio file to refund.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get Prepay BalanceCASTINGWORDS_GET_PREPAY_BALANCEAcciónTool to retrieve the current prepay balance for the account. use when you need to check available funds before placing new transcription orders.
CASTINGWORDS_GET_PREPAY_BALANCEAcciónTool to retrieve the current prepay balance for the account. use when you need to check available funds before placing new transcription orders.
Parámetros de entrada
Sin parámetros.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get registered webhook URLCASTINGWORDS_GET_WEBHOOKAcciónTool to retrieve the currently registered webhook url for account notifications. use when you need to verify your webhook setup.
CASTINGWORDS_GET_WEBHOOKAcciónTool to retrieve the currently registered webhook url for account notifications. use when you need to verify your webhook setup.
Parámetros de entrada
Sin parámetros.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Order TranscriptCASTINGWORDS_ORDER_TRANSCRIPTAcciónTool to create a new transcription order for audio/video at a url. use when you have an accessible media url and need to initiate transcription.
CASTINGWORDS_ORDER_TRANSCRIPTAcciónTool to create a new transcription order for audio/video at a url. use when you have an accessible media url and need to initiate transcription.
Parámetros de entrada
skustringObligatorioOne or more SKUs to order for each URL. Transcription SKUs: TRANS14 (Budget), TRANS2 (1-Day), TRANS6/7 (7-Day). Add-ons: DIFFQ2 (Difficult Audio), TSTMP1 (Timestamps), CAPTION1 (Captions), VERBATIM1 (Verbatim).
urlstringObligatorioURL or list of URLs of the audio/video file to transcribe (preferably MP3).
namestring[]List of speaker names in the audio. Alias 'name' also supported.
testbooleanIf true, creates a test-only order that will not actually be transcribed.
notesstringOptional comments for the transcribers about this file.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Order UpgradesCASTINGWORDS_ORDER_UPGRADESAcciónTool to order an upgrade for a specific audio file. use after transcription is complete to add items like timestamps or extra editing. example: 'order timestamps for file 12345'.
CASTINGWORDS_ORDER_UPGRADESAcciónTool to order an upgrade for a specific audio file. use after transcription is complete to add items like timestamps or extra editing. example: 'order timestamps for file 12345'.
Parámetros de entrada
skustring[]ObligatorioOne or more SKUs to order: DIFFQ2 (Difficult Audio), TSTMP1 (Timestamps), EDIT01 (Extra Editing), UPGRD1 (TRANS14→TRANS6), UPGRD2 (TRANS14→TRANS2), UPGRD3 (TRANS6→TRANS2)
testbooleanSet to true to run in test mode returning a fake success. Only valid for audiofile IDs 100 and 101.
audiofile_idintegerObligatorioID of the audio file to upgrade
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Register WebhookCASTINGWORDS_REGISTER_WEBHOOKAcciónTool to register a webhook url to receive transcript completion notifications. use when you want castingwords to post transcript-complete events to your service endpoint.
CASTINGWORDS_REGISTER_WEBHOOKAcciónTool to register a webhook url to receive transcript completion notifications. use when you want castingwords to post transcript-complete events to your service endpoint.
Parámetros de entrada
webhookstringObligatorioThe HTTPS endpoint URL for webhook notifications on transcript completion.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List Available SKUsCASTINGWORDS_SKU_LISTAcciónTool to retrieve list of available skus. use when you need to know available services and pricing before placing an order.
CASTINGWORDS_SKU_LISTAcciónTool to retrieve list of available skus. use when you need to know available services and pricing before placing an order.
Parámetros de entrada
Sin parámetros.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Test Webhook CallCASTINGWORDS_TEST_WEBHOOKAcciónTool to request a test webhook call for a specific event type. use after registering a webhook url to ensure webhook notifications are functioning properly.
CASTINGWORDS_TEST_WEBHOOKAcciónTool to request a test webhook call for a specific event type. use after registering a webhook url to ensure webhook notifications are functioning properly.
Parámetros de entrada
eventstringObligatorioenumType of webhook event to test. One of 'TRANSCRIPT_COMPLETE', 'DIFFICULT_AUDIO', or 'REFUND_ISSUED'.
TRANSCRIPT_COMPLETEDIFFICULT_AUDIOREFUND_ISSUED
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not