NAiOS IconNAiOS Logo
Volver al catálogo

Castingwords

castingwords

CastingWords offers high-quality, human-powered transcription services with a RESTful API for seamless integration into various workflows.

Acciones
8
Triggers
0
Autenticación
OAuth gestionado
No
Información técnica: el detalle de parámetros, schemas y triggers de esta página está pensado para equipos de integración. Si solo necesitas saber si tu herramienta favorita está disponible, basta con ver la lista de acciones.

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ón

Tool 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

  • teststring

    If set to 'true', returns a fake approval for testing. Only valid when audiofile_id is 100 or 101.

  • audiofile_idintegerObligatorio

    ID of the audio file to refund.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get Prepay BalanceCASTINGWORDS_GET_PREPAY_BALANCEAcción

Tool 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

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get registered webhook URLCASTINGWORDS_GET_WEBHOOKAcción

Tool 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

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Order TranscriptCASTINGWORDS_ORDER_TRANSCRIPTAcción

Tool 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

  • skustringObligatorio

    One 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).

  • urlstringObligatorio

    URL 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.

  • testboolean

    If true, creates a test-only order that will not actually be transcribed.

  • notesstring

    Optional comments for the transcribers about this file.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Order UpgradesCASTINGWORDS_ORDER_UPGRADESAcción

Tool 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[]Obligatorio

    One or more SKUs to order: DIFFQ2 (Difficult Audio), TSTMP1 (Timestamps), EDIT01 (Extra Editing), UPGRD1 (TRANS14→TRANS6), UPGRD2 (TRANS14→TRANS2), UPGRD3 (TRANS6→TRANS2)

  • testboolean

    Set to true to run in test mode returning a fake success. Only valid for audiofile IDs 100 and 101.

  • audiofile_idintegerObligatorio

    ID of the audio file to upgrade

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Register WebhookCASTINGWORDS_REGISTER_WEBHOOKAcción

Tool 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

  • webhookstringObligatorio

    The HTTPS endpoint URL for webhook notifications on transcript completion.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List Available SKUsCASTINGWORDS_SKU_LISTAcción

Tool 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

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Test Webhook CallCASTINGWORDS_TEST_WEBHOOKAcción

Tool 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

  • eventstringObligatorioenum

    Type of webhook event to test. One of 'TRANSCRIPT_COMPLETE', 'DIFFICULT_AUDIO', or 'REFUND_ISSUED'.

    TRANSCRIPT_COMPLETEDIFFICULT_AUDIOREFUND_ISSUED

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not