跳转到主要内容
POST
/
v1beta
/
models
/
{model}
:generateContent
curl --request POST \
  --url https://api.foxapi.cc/v1beta/models/{model}:generateContent \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "创建一首 30 秒的欢快民谣，使用吉他和口琴。"
        }
      ]
    }
  ],
  "generationConfig": {
    "responseModalities": [
      "AUDIO",
      "TEXT"
    ]
  }
}
'
{
  "candidates": [
    {
      "content": {
        "parts": [
          {
            "text": "这是一首欢快的民谣，使用了吉他和口琴。",
            "inlineData": {
              "mimeType": "audio/mpeg",
              "data": "SUQzBAAAAAAAI1RTU0UAAAAPAAADTGF2ZjU4..."
            }
          }
        ],
        "role": "model"
      },
      "finishReason": "STOP",
      "safetyRatings": [
        {
          "category": "<string>",
          "probability": "<string>"
        }
      ]
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 15,
    "candidatesTokenCount": 200,
    "totalTokenCount": 215
  }
}

授权

​
Authorization
string
header
必填

所有接口均需要使用Bearer Token进行认证

使用时在请求头中添加：

Authorization: Bearer YOUR_API_KEY

路径参数

​
model
enum<string>
必填

模型名称。lyria-3-clip-preview 生成 30 秒短片段（默认 MP3 / audio/mpeg）。lyria-3-pro-preview 生成完整歌曲；可请求 audio/mpeg 或 audio/wav，实际输出格式以返回的 inlineData.mimeType 为准

可用选项:
lyria-3-clip-preview,
lyria-3-pro-preview
示例:

"lyria-3-clip-preview"

请求体

application/json
​
contents
object[]
必填

内容列表。音乐生成为单轮过程，不支持多轮迭代编辑

​
generationConfig
object
必填

生成配置；音乐生成请求的 responseModalities 必须包含 AUDIO

​
systemInstruction
object

系统指令。Lyria 3 模型对该字段的支持未经官方文档确认，效果可能不生效

​
safetySettings
object[]

内容安全过滤设置

响应

音乐生成响应

​
candidates
object[]

生成结果候选列表

​
usageMetadata
object

Token 使用统计