ClavueClavue
AI platform · IDE · agents · models

歌曲生成

clavue-music 是官方歌曲产品 ID(premium 池)。打 api.clavue.com 的 POST /v1/audio/speech。旗舰档:TTT-ready 词 + 三段 caption,默认 30 秒、seed 11、一枪。一句话是方便档:网关会并联扩词和 caption 再出歌。不要对引擎一次发 180 或 240(请 90∥90 / 110∥110)。新闻口播和朗读走 clavue-tts。产品代码不要写上游模型名。

如何生成

  • POST /v1/audio/speech,model=clavue-music
  • 旗舰档:自己送带标签歌词 + 三段 caption(30 秒 / seed 11 / 一枪)
  • 一句话:网关并联扩词和 caption(关思考)再出歌 — 不如锁定包
  • L1:caption ∥ 歌词两枪 auto 并联,再 speech
  • input = 带标签歌词(标签单独成行)或 (instrumental)
  • instructions = 英文三段 Structured Caption
  • audio_duration 默认 30;引擎最长 110;seed 默认 11;公网同时传 voice 秒数字符串
  • 180 秒:并行两次 90,caption 相同、Chorus 复用 — 不要发 180
  • 集群现网并发 12(10s 批量 4–8 路,不要打满)
curl -sS https://api.clavue.com/v1/audio/speech \
  -H "Authorization: Bearer $CLAVUE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model":"clavue-music",
    "input":"[Verse]\nMorning light filtering through the pine\n[Chorus]\nStay with me in this light",
    "instructions":"Global Metadata\nAcoustic pop, 96 BPM, intimate morning.\nVocal Details\nSoft female lead, close-mic.\nArrangement\nFingerpicked guitar, soft piano, brushed snare in the chorus.",
    "audio_duration":30,
    "voice":"30",
    "seed":11,
    "response_format":"wav"
  }' --output song.wav --max-time 600

先创作控制器(TTT)

TTT 是 clavue-music 上面的创作控制器,不是第四个引擎,也不微调 Music3。检索、critic、--commit 留在 imusic,不进每一次公网 speech。公网一句话由 hop 并联扩词和 caption(关思考)再出歌。旗舰质量仍来自你们自己存的 TTT-ready 词和 caption。公网流量不得默认写入检索加权。

一句话是方便档(峰值更弱)。不要在每一次 speech 上跑 SQLite / dossiers。新闻稿仍 400 use_tts。

推荐设置

引擎采样锁死。只传时长、seed、歌词和 caption。单段超时 ≥600s。不要传 temperature / top_p / speed / 音色名。

  • audio_duration:默认 30 · 引擎最长 110 · 产品 240 用 90∥90 或 110∥110
  • voice:同一秒数的字符串,例如 "30"
  • seed:热路径 11;用户要换一版再换 seed
  • response_format:wav · 读真实时长,不要只看 HTTP 200
{
  "model": "clavue-music",
  "audio_duration": 30,
  "voice": "30",
  "seed": 11,
  "response_format": "wav"
}

提示词演示(30 秒原声)

旗舰档:用 auto 或 clavue-2.1-fast(关思考)并联扩歌词和 caption,再交给 /v1/audio/speech。不下这一步时 hop 会给一句话做方便档扩写。标签必须单独成行。弱 caption:Genre: pop. BPM: 96.

# User intent
Duration: 30 seconds. Acoustic pop. Soft female, close-mic, no belting.
Theme: pine needles at a morning window, a quiet street.
No full drum kit, no celebrity names.

# Caption rewriter system
You are a song caption engineer. Expand the user's intent into an English Structured Caption.
Output only three headings. No title, no lyrics, no explanation.
### Global Metadata — genre, BPM, mood arc, scene, production
### Vocal Details — gender, register, verse vs chorus, harmony, space
### Arrangement — instrument entries by section; 2–3 lead instruments; 250–450 words

# Lyrics rewriter system
Write lyrics for the target duration. Tags on their own line.
Allowed: [Intro] [Verse] [Pre-Chorus] [Chorus] [Bridge] [Outro]
Chorus short and repeatable. ~2–3 Chinese characters per second.
30s = Verse + Chorus, 8–12 lines. Lyrics only.

# Example input (lyrics)
[Verse]
晨光穿过窗边的松针
这条安静的街像只属于我们
把昨夜的 rumble 轻轻放下
让呼吸自己找到节奏

[Chorus]
世界慢慢醒来
你走在我左边
别说话,先听风
把名字吹成一天

# Example instructions (caption)
Global Metadata
Basic Attributes: bpm is 96. key is C, and scale is major. Contemporary acoustic pop.
Global Emotional Progression: Opens intimate and still, then lifts into a wider, hopeful chorus without turning anthemic.
Application Scenarios & Imagery: Early morning apartment, pine light through a window.
Sonics & Production Profile: Intimate, mid-focused, warm low mids, no harsh cymbals.

Vocal Details
Soft female lead, breathy, close to the microphone. Conversational verse; sustained chorus; no belting.
Light stacked doubles only in the chorus. Short plate, almost dry in the verse.

Arrangement
Intro: fingerpicked steel-string guitar alone.
Verse: guitar plus very soft piano; no full drum kit.
Chorus: brushed snare, upright bass, piano opens; keep the guitar pattern continuous.

限制

单次引擎 10–110 秒。单段超时 ≥600s。不要传 temperature / speed / 音色名。词不够会提前结束 — 读 WAV 时长。180/240 必须并行两段。

一次发 180 或 240 会失败。把默认单曲做成 3 分钟,墙钟会到大约 19 分钟。

不是这个产品

新闻播报、栏目口播、稿件朗读走同一端点上的 clavue-tts(预设声)。不要把新闻稿当歌词。不要把歌曲 caption 当播报 instruct。

下一步