action shutterstock_list_custom_descriptors {
  label: "List computer audio descriptors"
  description: "This endpoint lists the descriptors that you can use in the audio regions in an audio render."
  provider: shutterstock
  method: GET
  path: "/v2/ai/audio/descriptors"
  encoding: json
  input: {
    type: "object"
    properties: {
      band_id: {
        type: "string"
      }
      band_name: {
        type: "string"
      }
      id: {
        type: "array"
        items: {
          type: "string"
        }
      }
      instrument_id: {
        type: "string"
      }
      instrument_name: {
        type: "string"
      }
      name: {
        type: "string"
      }
      page: {
        type: "integer"
      }
      per_page: {
        type: "integer"
      }
      render_speed_over: {
        type: "number"
      }
      tag: {
        type: "string"
      }
      tempo: {
        type: "number"
      }
      tempo_from: {
        type: "number"
      }
      tempo_to: {
        type: "number"
      }
    }
    additionalProperties: false
  }
  output: {
    type: "object"
    description: "List Descriptors results"
    properties: {
      data: {
        type: "array"
        description: "List of descriptors"
        items: {
          type: "object"
          description: "Information about a descriptor"
          properties: {
            average_render_speed: {
              type: "number"
              description: "The average ratio of the length of the music to the time it takes to render; for example, a render speed of 3.0 generates 30 seconds of music in about 10 seconds"
            }
            bands: {
              type: "array"
              description: "The bands that are available to use this descriptor"
              items: {
                type: "object"
                description: "A band that can be used to generate music"
                properties: {
                  id: {
                    type: "string"
                    description: "The ID of the band"
                  }
                  name: {
                    type: "string"
                    description: "The name of the band"
                  }
                }
              }
            }
            id: {
              type: "string"
              description: "The ID of the descriptor"
            }
            instruments: {
              type: "array"
              description: "The instruments that can play with this descriptor"
              items: {
                type: "object"
                description: "Instruments"
                properties: {
                  id: {
                    type: "string"
                    description: "The string id of the instrument"
                  }
                  name: {
                    type: "string"
                    description: "The string name of the instrument"
                  }
                }
              }
            }
            max_tempo: {
              type: "number"
              description: "The maximum beats per minute that the descriptor is intended to be used with"
            }
            min_tempo: {
              type: "number"
              description: "The minimum beats per minute that the descriptor is intended to be used with"
            }
            name: {
              type: "string"
              description: "The name of the descriptor"
            }
            previews: {
              type: "array"
              description: "Preview of the descriptor"
              items: {
                type: "object"
                description: "Preview information"
                properties: {
                  content_type: {
                    type: "string"
                    description: "Content type of the preview, currently audio/mp3"
                    enum: ["audio/mp3"]
                  }
                  url: {
                    type: "string"
                    description: "Url of the instrument's preview file"
                  }
                }
              }
            }
            tags: {
              type: "array"
              description: "Tags that describe the descriptor"
              items: {
                type: "string"
              }
            }
          }
        }
      }
      page: {
        type: "integer"
        description: "Current page that is returned"
      }
      per_page: {
        type: "integer"
        description: "Number of results per page"
      }
    }
  }
}