action shutterstock_fetch_renders {
  label: "Get details about audio renders"
  description: "This endpoint shows the status of one or more audio renders, including download links for completed audio."
  provider: shutterstock
  method: GET
  path: "/v2/ai/audio/renders"
  encoding: json
  input: {
    type: "object"
    properties: {
      id: {
        type: "array"
        items: {
          type: "string"
        }
      }
    }
    required: ["id"]
    additionalProperties: false
  }
  output: {
    description: "Audio render data"
    required: ["audio_renders"]
    properties: {
      audio_renders: {
        type: "array"
        description: "Audio render results"
        items: {
          type: "object"
          description: "The output of an audio render in WAV or MP3 format"
          required: ["id", "timeline", "status"]
          properties: {
            created_date: {
              type: "string"
              format: "date-time"
              description: "The time the render was submitted to the API"
            }
            files: {
              type: "array"
              description: "The files associated with the render"
              items: {
                type: "object"
                description: "Files associated with the render"
                required: ["filename", "bits_sample", "content_type", "download_url", "frequency_hz", "kbits_second", "size_bytes", "tracks"]
                properties: {
                  bits_sample: {
                    type: "number"
                    description: "The bit depth of the audio files in bits/sample"
                  }
                  content_type: {
                    type: "string"
                    description: "The content-type of the file"
                  }
                  download_url: {
                    type: "string"
                    description: "The internet-accessible URL from which the file can be downloaded. Any redirects encountered when using this URL must be followed"
                  }
                  filename: {
                    type: "string"
                    description: "The user-specified file name suggestion from the render request; this file name becomes the filename property of the Content-Disposition header when the user downloads the rendered audio file"
                  }
                  frequency_hz: {
                    type: "number"
                    description: "The Sample rate of the audio files in Hertz (Hz)"
                  }
                  kbits_second: {
                    type: "number"
                    description: "The data rate of the audio files in kilobits/second"
                  }
                  size_bytes: {
                    type: "number"
                    description: "Size of the file in bytes"
                  }
                  tracks: {
                    type: "array"
                    description: "An array of track names included in the file"
                    items: {
                      type: "string"
                    }
                  }
                }
              }
            }
            id: {
              type: "string"
              description: "The alphanumeric ID of the simple render"
            }
            preset: {
              type: "string"
              description: "The file format preset"
              enum: ["MASTER_MP3", "MASTER_WAV", "STEMS_WAV"]
            }
            progress_percent: {
              type: "integer"
              description: "The current progress of the render as a percentage"
            }
            status: {
              type: "string"
              description: "A coarse progress indicator"
              enum: ["WAITING_COMPOSE", "RUNNING_COMPOSE", "WAITING_RENDER", "RUNNING_RENDER", "CREATED", "FAILED_CREATE"]
            }
            timeline: {
              type: "object"
              description: "A timeline object that represents either a request for music to be created or an entire music composition"
              properties: {
                spans: {
                  type: "array"
                  description: "A span object that represents the beginning of a period of absolute time"
                  items: {
                    type: "object"
                    description: "The beginning of a non-overlapping period of absolute time"
                    required: ["span_type", "time"]
                    properties: {
                      id: {
                        type: "number"
                        description: "An identifier which must be unique within the parent span"
                      }
                      instrument_groups: {
                        type: "array"
                        description: "An array of instrument_group objects that are used in this span"
                        items: {
                          type: "object"
                          description: "An instrument and the status objects that specify when that instrument plays"
                          required: ["instrument_group"]
                          properties: {
                            instrument_group: {
                              type: "object"
                              additionalProperties: true
                            }
                            statuses: {
                              type: "object"
                              additionalProperties: true
                            }
                          }
                        }
                      }
                      regions: {
                        type: "array"
                        description: "An array of region objects within the span"
                        items: {
                          type: "object"
                          description: "A period of music or silence, measured in beats"
                          required: ["id", "region", "descriptor", "beat"]
                          properties: {
                            beat: {
                              type: "object"
                              additionalProperties: true
                            }
                            descriptor: {
                              type: "object"
                              additionalProperties: true
                            }
                            end_type: {
                              type: "object"
                              additionalProperties: true
                            }
                            id: {
                              type: "object"
                              additionalProperties: true
                            }
                            key: {
                              type: "object"
                              additionalProperties: true
                            }
                            region: {
                              type: "object"
                              additionalProperties: true
                            }
                          }
                        }
                      }
                      span_type: {
                        type: "string"
                        description: "Type of span; metered spans represent a pariod of time with music, and unmetered spans denote the end of the prior metered span"
                        enum: ["metered", "unmetered"]
                      }
                      tempo: {
                        type: "integer"
                        description: "The tempo, in beats per minute, at the start of the span; if not provided, the API selects a random tempo"
                      }
                      tempo_changes: {
                        type: "array"
                        description: "Two or more inflection points in a tempo curve; the API creates a smoothly changing tempo by using a linear interpolation of the time between each tempo change"
                        items: {
                          type: "object"
                          description: "An inflection point in a tempo curve; the API creates the overall tempo by using a linear interpolation of the time between each tempo change"
                          required: ["time", "tempo"]
                          properties: {
                            tempo: {
                              type: "object"
                              additionalProperties: true
                            }
                            time: {
                              type: "object"
                              additionalProperties: true
                            }
                          }
                        }
                      }
                      time: {
                        type: "integer"
                        description: "The absolute time, in seconds, at which the span starts"
                      }
                    }
                  }
                }
              }
            }
            updated_date: {
              type: "string"
              format: "date-time"
              description: "The time that the audio output was uploaded"
            }
          }
        }
      }
    }
  }
}