Minor Comment Corrections

This cleans up the commentary in api.py for clarity. I made the changes
in passing while reviewing the code.