com.octavius.audio.describe

octavius.delve.town

Documentation

Analyze audio and describe it in structured text.

main procedure

Analyze audio and describe it in structured text.

Input

Encodingapplication/json
url stringuri Optional

A URL to an audio file to analyze.

Output

Encodingapplication/json
Schema#audioDescription
Try It

Requests are sent directly from your browser. Some servers may block requests due to CORS.

Base URL for XRPC calls (e.g., https://bsky.social)
Enter valid JSON for the request body
View raw schema 
{
  "description": "Analyze audio and describe it in structured text.",
  "input": {
    "encoding": "application/json",
    "schema": {
      "properties": {
        "url": {
          "description": "A URL to an audio file to analyze.",
          "format": "uri",
          "type": "string"
        }
      },
      "required": [],
      "type": "object"
    }
  },
  "output": {
    "encoding": "application/json",
    "schema": {
      "ref": "#audioDescription",
      "type": "ref"
    }
  },
  "type": "procedure"
}
audioDescription object

No description available.

Properties

prose string Required

A human-readable multi-line description of the audio.

service string Required

No description available.

version string Required

Ears service version.

View raw schema 
{
  "properties": {
    "features": {
      "ref": "#audioFeatures",
      "type": "ref"
    },
    "prose": {
      "description": "A human-readable multi-line description of the audio.",
      "type": "string"
    },
    "service": {
      "const": "com.octavius.audio.describe",
      "type": "string"
    },
    "version": {
      "description": "Ears service version.",
      "type": "string"
    }
  },
  "required": [
    "service",
    "version",
    "features",
    "prose"
  ],
  "type": "object"
}
audioFeatures object

No description available.

Properties

audio object Optional

No description available.

dynamics object Optional

No description available.

key object Optional

No description available.

tempo object Optional

No description available.

texture object Optional

No description available.

timbre object Optional

No description available.

View raw schema 
{
  "properties": {
    "audio": {
      "properties": {
        "channels": {
          "type": "integer"
        },
        "duration_seconds": {
          "type": "number"
        },
        "sample_rate": {
          "type": "integer"
        }
      },
      "type": "object"
    },
    "dynamics": {
      "properties": {
        "onset_density_per_second": {
          "type": "number"
        },
        "rms_dynamic_range_db": {
          "type": "number"
        }
      },
      "type": "object"
    },
    "key": {
      "properties": {
        "confidence": {
          "type": "number"
        },
        "mode": {
          "type": "string"
        },
        "name": {
          "type": "string"
        },
        "tonic": {
          "type": "string"
        }
      },
      "type": "object"
    },
    "tempo": {
      "properties": {
        "avg_beat_interval_seconds": {
          "type": "number"
        },
        "beat_count": {
          "type": "integer"
        },
        "bpm": {
          "type": "number"
        },
        "half_time_fold_applied": {
          "type": "boolean"
        }
      },
      "type": "object"
    },
    "texture": {
      "properties": {
        "percussive_share": {
          "type": "number"
        },
        "tonal_share": {
          "type": "number"
        }
      },
      "type": "object"
    },
    "timbre": {
      "properties": {
        "mfcc_mean": {
          "items": {
            "type": "number"
          },
          "type": "array"
        },
        "spectral_centroid_hz": {
          "type": "number"
        },
        "spectral_flatness": {
          "type": "number"
        },
        "spectral_flux": {
          "type": "number"
        },
        "spectral_rolloff_hz": {
          "type": "number"
        },
        "zero_crossing_rate": {
          "type": "number"
        }
      },
      "type": "object"
    }
  },
  "type": "object"
}

Lexicon Garden

@