If you have multiple API Description Documents in a single repository (for example a single project with multiple APIs), with GitHub Integration you can sync each file to a separate API Project on Apiary by selecting a different file path.

Be aware, this isn’t a solution for splitting single API Description Document across multiple files.