> Is there a benefit to describing APIs using YAML instead of just, y'know, prose?

Automatic generation of tests à la quickcheck.

Then, pydantic/fastapi does the YAML generation for me.