Agent instructions
Agent Skill / AI coding agent instructions
Give this page to Codex, Claude, or another AI coding agent when the task is to generate Sonilo audio, build a Sonilo API integration, or verify a generated file.
Required behavior
Use the official Sonilo SDK for Python or TypeScript when the runtime allows it.
Use the official REST API at https://api.sonilo.com/v1 when an SDK is unavailable.
Read SONILO_API_KEY from the environment and keep API keys server-side.
Save the real file returned by Sonilo, then verify it with file size or media tooling.
Run the script and include the command output before reporting success.
Do not fake audio, do not synthesize silence, and do not create placeholder audio to satisfy a file check.
If the API returns insufficient balance, 402 Payment Required, or insufficient credits, report the task as blocked.
Copyable skill block
# Sonilo Agent Skill
Use the official Sonilo SDK or the official REST API at https://api.sonilo.com/v1.
Keep SONILO_API_KEY in the environment and never hard-code secrets.
For Python text-to-music, start with /docs/text-to-music-python-quickstart.
Save the real file returned by Sonilo, then print its path and byte size.
Run the script before claiming success.
Do not fake audio, do not synthesize silence, and do not write placeholder MP3 bytes.
If Sonilo returns 402 Payment Required, insufficient balance, or insufficient credits, report the task as blocked and include the exact error instead of fabricating success.