NAiOS IconNAiOS Logo
Contacto
Volver al catálogo

Amara

amara

Amara is an online platform that enables users to create, edit, and manage subtitles and captions for videos, facilitating accessibility and multilingual content.

Video & AudioTranscriptionWeb del proveedor
Acciones
15
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 (15)

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.

Add Subtitle NoteAMARA_ADD_SUBTITLE_NOTEAcción

Tool to add a note to a subtitle set. use after retrieving the notes uri of the subtitle set.

Parámetros de entrada

  • bodystringObligatorio

    Text of the note to add to the subtitle set.

  • video_idstringObligatorio

    Amara video ID.

  • language_codestringObligatorio

    BCP-47 code for the subtitle language.

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

Create Subtitle LanguageAMARA_CREATE_SUBTITLE_LANGUAGEAcción

Tool to create a new subtitle language for a video. use when you need to add a language track (iso 639-1 code) before uploading subtitles.

Parámetros de entrada

  • languagestringObligatorio

    ISO 639-1 language code to add (e.g., 'fr').

  • video_idstringObligatorio

    The ID or slug of the video to which to add the subtitle language.

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

Fetch Subtitles DataAMARA_FETCH_SUBTITLES_DATAAcción

Tool to fetch subtitle data for a video in a specific language. use when you need to retrieve subtitle segments after confirming video id and language code.

Parámetros de entrada

  • formatstringenum

    Subtitle format to retrieve. Defaults to 'json' when omitted.

    jsonsrtvtt
  • video_idstringObligatorio

    Amara video ID.

  • language_codestringObligatorio

    BCP-47 code for the subtitle language.

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 Subtitle Language DetailsAMARA_GET_SUBTITLE_LANGUAGE_DETAILSAcción

Tool to retrieve details for a single subtitle language. use when you have video id and language code and need metadata about that language track.

Parámetros de entrada

  • video_idstringObligatorio

    Amara video ID.

  • language_codestringObligatorio

    BCP-47 code for the subtitle language.

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

Tool to get details on a specific team by slug. use when you need metadata for a single team.

Parámetros de entrada

  • slugstringObligatorio

    Machine name (slug) of the team to retrieve details for.

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

Tool to get user data by username or id. use when you need to fetch account details for a user.

Parámetros de entrada

  • identifierstringObligatorio

    User identifier: username or user ID prefixed with 'id$'.

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 Video URL DetailsAMARA_GET_VIDEO_URL_DETAILSAcción

Tool to get details for a specific video url. use when you have a public or embeddable video url and need its amara metadata (id, title, duration, thumbnails, etc.).

Parámetros de entrada

  • urlstringObligatorio

    A public or embeddable video URL to look up.

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

Tool to get a list of all supported languages. use when you need to know available language options from amara.

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

List Subtitle LanguagesAMARA_LIST_SUBTITLE_LANGUAGESAcción

Tool to list all subtitle languages for a video. use when you have a video id and need to fetch its available subtitle languages.

Parámetros de entrada

  • video_idstringObligatorio

    Amara video ID for which to list subtitle languages.

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

Tool to list all teams. use when you need to retrieve your accessible teams with pagination.

Parámetros de entrada

  • limitinteger

    Maximum number of teams to return.

  • offsetinteger

    Results offset for pagination.

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

Tool to list all videos. use when you need to fetch a paginated list of videos with optional filters.

Parámetros de entrada

  • pageinteger

    Page number of results to fetch.

  • sortstring

    Sorting order, e.g., '-created' or '-primary_audio_language_code'.

  • teamstring

    Filter by team slug.

  • ownerstring

    Filter by owner username.

  • archiveboolean

    If true, only archived videos are returned.

  • projectstring

    Filter by project slug.

  • languagestring

    Filter by language code (BCP-47), e.g., 'en'.

  • video_idstring

    Comma-separated list of video IDs to filter.

  • page_sizeinteger

    Number of results per page.

  • video_urlstring

    Filter by exact video URL.

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

Tool to list all urls associated with a video. use when you need to retrieve every url for embedding or processing.

Parámetros de entrada

  • limitinteger

    Maximum number of URLs to return.

  • offsetinteger

    Index of the first URL to return (0-indexed).

  • video_idstringObligatorio

    Amara video ID for which to list all associated video URLs.

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

Make Video URL PrimaryAMARA_MAKE_VIDEO_URL_PRIMARYAcción

Tool to set a video url as the primary url. use when you need to designate one of a video's urls as primary for embedding and display. call after listing video urls to confirm the url id.

Parámetros de entrada

  • url_idintegerObligatorio

    The internal ID of the video URL resource to mark as primary.

  • primarybooleanObligatorio

    Set to true to mark this URL as the primary URL.

  • video_idstringObligatorio

    The Amara video identifier (e.g., 'NI1hLjBxuTpk').

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

Update Subtitle LanguageAMARA_UPDATE_SUBTITLE_LANGUAGEAcción

Tool to update a subtitle language for a video. use after reviewing existing subtitle language settings and needing to adjust completeness flags or soft-limit constraints.

Parámetros de entrada

  • video_idstringObligatorio

    Amara video ID.

  • language_codestringObligatorio

    BCP-47 code for the subtitle language.

  • soft_limit_cplinteger

    Maximum characters per line; warning shown if exceeded.

  • soft_limit_cpsinteger

    Maximum characters per second; warning shown if exceeded.

  • soft_limit_linesinteger

    Maximum number of lines per subtitle; warning shown if exceeded.

  • subtitles_completeboolean

    Indicates if the subtitles are complete for this language.

  • soft_limit_max_durationinteger

    Maximum subtitle duration in milliseconds; used in guidelines dialog.

  • soft_limit_min_durationinteger

    Minimum subtitle duration in milliseconds; warning shown if violated.

  • is_primary_audio_languageboolean

    Indicates if this is the primary spoken language of the video.

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

View Video DetailsAMARA_VIEW_VIDEO_DETAILSAcción

Tool to view details of a specific video by id. use when you need complete metadata for a given video.

Parámetros de entrada

  • video_idstringObligatorio

    Amara video identifier

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