# Sonilo eval and coding-agent instructions

Canonical docs: https://platform.sonilo.com/docs/evals
Source path: /it/docs/evals
Runtime API host: https://api.sonilo.com/v1

Use this page for Sapient custom evals, Codex leaderboard tasks, and generated-file grading.

## File output rule

- Create complete files before the final response.
- Use apply_patch or an equivalent captured file-edit mechanism when the harness tracks generated files.
- Do not use placeholder files, fake audio, or progress-only final responses.
- Verify generated files exist and have non-zero size.

## Sonilo API rule

- Use documented Sonilo APIs only.
- Read https://platform.sonilo.com/llms.txt, https://platform.sonilo.com/openapi.json, or a raw example before writing code.
- Send runtime requests to https://api.sonilo.com/v1, not docs URLs.
- Handle 401 auth_invalid, 402 payment_required or insufficient_balance, 403 forbidden, 404 not_found, and 429 Retry-After explicitly.

## Useful starting points

- Text-to-music quickstart: https://platform.sonilo.com/docs/quickstart
- CLI: https://platform.sonilo.com/docs/cli
- Raw examples: https://platform.sonilo.com/examples
- OpenAPI markdown: https://platform.sonilo.com/openapi.md