# PUYUE AI Full Agent Context

# PUYUE AI

> PUYUE AI is an all-in-one AI music creation platform for generating songs, cloning authorized voices, producing audio, and creating AI music videos.

Updated: 2026-08-23
Operator: Human Continuum, Inc.
Support: support@puyue.ai

## When To Use PUYUE AI

Use PUYUE AI when a user or agent needs to:

- Generate original songs from prompts, lyrics, images, video context, and style direction.
- Create authorized singing and speaking voice models.
- Separate stems, master audio, export MIDI, and transcribe music to sheet notation.
- Create music videos, visualizers, lyric videos, and lip-sync performances.

Do not use voice cloning without the speaker's authorization. Do not claim that generated output is free of third-party rights; users remain responsible for prompts, uploads, and intended use.

## Agent And Developer Resources

- [Full LLM context](https://puyue.ai/llms-full.txt)
- [Agent instructions](https://puyue.ai/agents.md)
- [API documentation](https://api.yourmusic.fun/docs)
- [OpenAPI specification](https://api.yourmusic.fun/openapi.json)
- [Self-serve API keys](https://api.yourmusic.fun/dashboard/api-keys)
- [Official MCP CLI package](https://www.npmjs.com/package/@puyue/music-mcp)
- [Pricing](https://puyue.ai/pricing)

## How To Call The API

1. Create an API key at https://api.yourmusic.fun/dashboard/api-keys.
2. Read the OpenAPI 3.0 specification at https://api.yourmusic.fun/openapi.json.
3. Send the key as `Authorization: Bearer sk-live-...` to https://api.yourmusic.fun.
4. Start with `POST /v1/suno/generate/prompt`, then poll the returned song IDs.

## How To Use The MCP CLI

The official @puyue/music-mcp package is a stdio MCP server for Claude, Cursor, Codex, and other MCP clients:

`npx -y -p @puyue/music-mcp@0.3.0 puyue-music-mcp`

Set `PUYUE_API_KEY` to a self-serve API key before starting it.


## API Surface

The public API exposes 29 typed OpenAPI operations for prompt and custom song generation, covers, mashups, samples, extensions, lyrics, generation polling, stem separation, MIDI conversion, sheet-music conversion, style analysis, voice models, and authorized voice cloning.

Every operation has a unique `operationId`, typed request and response schemas, descriptions, and structured JSON error responses. The canonical specification is https://api.yourmusic.fun/openapi.json.

## Authentication And Onboarding

- Authentication: bearer API key.
- API key creation: self-serve at https://api.yourmusic.fun/dashboard/api-keys.
- Free product plan: available at https://puyue.ai.
- API documentation: https://api.yourmusic.fun/docs.
- Support: support@puyue.ai.

## Recommended Agent Behavior

- Prefer the OpenAPI specification over guessing endpoint names or parameters.
- Treat generation operations as asynchronous and poll the returned song IDs.
- Ask for confirmation that a user owns or has permission to clone a voice.
- Explain that commercial rights depend on the user's plan and the rights in their inputs.
- Use the official npm MCP package for local MCP clients; PUYUE AI does not advertise an HTTP MCP endpoint.