A TTAPI Agent Skill gives Codex a repeatable project workflow. In this Suno example, Codex reads ttapi-suno, submits one chirp-v6 music task, retrieves two MP3 results, adds them to the project's Suno player and checks playback. The edited example and one playable track show the workflow from prompt to result.
What TTAPI Agent Skills do in Codex
TTAPI Agent Skills are project instructions for coding agents that can work with a terminal, files and web documentation. For a Suno task, ttapi-suno tells Codex how to inspect the project, read the current API schema, submit an asynchronous job, retrieve its result and save the audio.
The Skill is the workflow layer. Suno remains the music product and chirp-v6 remains the model value in the request. Installation does not generate media; generation uses the TTAPI balance for the selected operation.
- Use an agent that supports Skills and can access the project terminal.
- Install the product Skill the project needs.
- Keep the TTAPI key in the local environment used by the agent.
Choose ttapi-suno for a song workflow
This guide uses ttapi-suno because the example needs a short vocal song with a named style, tempo and model. The same Skill also covers instrumental music, lyrics, covers and stems; the request fields change with the operation.
Keep the first task small and reviewable. Give Codex one creative brief, one model and one output folder so the screenshot shows a clear request to result path.
| Input | Example |
|---|---|
| Skill | ttapi-suno |
| Model | chirp-v6 |
| Output | One generation task, two MP3 variants |
The example below follows one Suno request from submission through the saved audio result.
Install ttapi-suno in the project
Run the installer from the project folder, then ask your agent to confirm the Skill name and installed path. This prepares the workflow only; it does not submit a music request or spend generation credits.
Ask Codex to report the installed path and supported operations in English. Do not ask it to generate music during this inspection step.
npx skills add ttapi-io/ttapi-skills --skill ttapi-suno- Run the command from the project you want the agent to edit.
- Confirm the installed Skill file paths before generating media.
- Do not start a paid generation during the installation check.
Set TTAPI_API_KEY locally
The Skill can read the key from the environment, but it should never receive the secret in chat or source files. Set TTAPI_API_KEY in the same terminal or command environment that starts Codex, Claude Code, Cursor, or Gemini CLI.
Ask Codex to report only configured or missing. It should never print the key, make a generation request or claim that the balance is valid from an environment check alone.
# PowerShell
$taskKey = Read-Host 'TTAPI API key' -AsSecureString
$env:TTAPI_API_KEY = [System.Net.NetworkCredential]::new('', $taskKey).Password
Remove-Variable taskKey
# Bash
read -rsp 'TTAPI API key: ' TTAPI_API_KEY
export TTAPI_API_KEY
printf '\n'- Use a hidden local prompt or a client environment setting.
- Start the agent after the variable is set in its command environment.
- Keep the real key out of screenshots, logs, commits, and prompts.
Give Codex an English music brief
Use the prompt below to give Codex one clear task: create a short song with ttapi-suno, save both returned variants, and verify them in the existing Suno player. The prompt matches the edited conversation example.
Submit one generation job. Keep the API key private and retain the task ID so Codex can resume the same asynchronous job if it takes longer than expected.
Use the installed ttapi-suno Skill to create a short cinematic electronic-soul song with warm Rhodes piano, deep bass and low male vocals. Use chirp-v6. Read the TTAPI docs, submit one task, save both MP3 results and add them to this project's Suno player. Verify playback. Reply in English and keep the API key private.
Submit one Suno task
The compact Codex result should expose only the information a reader needs: the Skill, model, endpoint, status and next action. Keep the API key out of screenshots.
A submitted Suno task is asynchronous. The next action is to resume the existing task, not to submit another generation.
- Skill: ttapi-suno
- Model: chirp-v6
- Endpoint: /suno/v1/music
- Status: submitted
Listen to the saved MP3
The example Codex response shows one completed task and two returned MP3 variants. Play the first variant below to review the result yourself; a successful task status does not replace listening to the track.
- One generation task returned two MP3 variants.
- Use a player that starts only when the reader presses play.
- Review the audio before using it in a product.