Agent SkillsTutorialsTTAPI Agent Skills with Codex

How to use TTAPI Agent Skills in Codex: Suno API

Follow a concise Codex workflow with the TTAPI Suno Skill: install it, submit one music task, resume the job, and verify the saved MP3.

TTAPI4 min read
IN THIS NOTE

What you will take away

  • Understand how Codex uses a TTAPI product Skill
  • Submit one Suno music task with a short English prompt
  • Resume the task and verify the saved MP3 result
THE TAKEAWAY

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.

The compact Suno case used in this guide
InputExample
Skillttapi-suno
Modelchirp-v6
OutputOne 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.

Install ttapi-suno in the project
Shell
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.

Set the key locally
Shell
# 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.

Paste this into your project chat
Prompt
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.
Edited Codex conversation showing a TTAPI Suno Skill request and two returned MP3 variants
Edited Codex conversation example · one Suno task returned two MP3 variants

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.

After the Blue HourPlay the example track
Example audio · first MP3 variant from the Suno workflow shown above
Open audio file
  • 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.