> ## Documentation Index
> Fetch the complete documentation index at: https://docs.senseaudio.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# 音效生成介绍

> 根据文本描述快速生成音效素材

export const PlatformLink = ({href, children}) => {
  const MOBILE_MAX_WIDTH = 768;
  const TOAST_TEXT = '为了更好的支付体验，请在电脑端进行操作';
  const TOAST_DURATION_MS = 2400;
  const [toastVisible, setToastVisible] = useState(false);
  const hideTimerRef = useRef(0);
  useEffect(() => {
    return () => {
      if (hideTimerRef.current) clearTimeout(hideTimerRef.current);
    };
  }, []);
  const handleClick = event => {
    const isMobile = typeof window !== 'undefined' && window.matchMedia(`(max-width: ${MOBILE_MAX_WIDTH - 1}px)`).matches;
    if (!isMobile) return;
    event.preventDefault();
    event.stopPropagation();
    setToastVisible(true);
    if (hideTimerRef.current) clearTimeout(hideTimerRef.current);
    hideTimerRef.current = window.setTimeout(() => {
      setToastVisible(false);
    }, TOAST_DURATION_MS);
  };
  return <>
      <a href={href} onClick={handleClick} target="_blank" rel="noreferrer" className="text-primary">
        {children}
      </a>
      {toastVisible && <div role="status" aria-live="polite" className="fixed left-1/2 bottom-20 -translate-x-1/2 max-w-[calc(100vw-32px)] px-5 py-3 bg-black/85 text-white text-sm leading-normal rounded-lg shadow-lg z-[99999] text-center pointer-events-none">
          {TOAST_TEXT}
        </div>}
    </>;
};

SenseAudio 音效生成服务面向短视频、影视、动画、游戏、有声内容、广告和产品演示等场景，提供统一的文生音效 API。开发者只需传入清晰具体的声音描述，即可快速生成对应的音效素材，减少素材检索、现场录制和前期试音成本。

## 什么是音效生成

音效生成能力将自然语言中的声音描述转换为短音频素材，适合从声音创意到内容配音素材的自动化工作流。

**核心能力**：

* **文生音效**：根据文字描述生成事件声、动作声或环境声
* **时长控制**：支持固定时长，也支持由模型根据提示词自动决定时长
* **多结果生成**：支持一次生成多个候选结果，便于后续筛选和使用
* **格式选择**：支持按业务需求选择 `mp3` 或 `wav` 输出格式

## 主要特性

* **一句话生成**：用简单描述即可完成音效创作，不依赖专业录音设备或复杂编辑流程。
* **输入更直接**：优先使用具体声源名称或声音事件，而不是抽象形容词，便于获得稳定结果。
* **降低准备成本**：减少素材搜索、现场录制和反复试音等前期工作。
* **适配多种内容**：可用于视频、游戏、广告和产品演示等内容制作场景。

## 模型版本

当前音效生成相关模块统一使用以下模型：

* `senseaudio-sfx-1.0-260626`

## API 能力概览

SenseAudio 音效生成提供以下核心 API 接口：

### 1. 创建音效生成任务

根据文本描述同步生成 1-4 个音效变体，适合事件声、动作声、环境声和产品演示音效等素材生成场景。

* 文档：**[音效生成](/api-reference/endpoint/sfx/create)**
* 接口地址：`POST https://api.senseaudio.cn/v1/sound-effects/generations`

## 提示词写法建议

输入明确、具体的声音名称通常就能获得良好效果。

推荐：

* 使用具体声源名称或声音事件，如脚步声、关门声、玻璃碎裂声。
* 表述尽量简单、直接，一次描述一种主要声音。

避免只写抽象描述的声音。

| 想要的声音 | 推荐描述  | 不建议只写 |
| :---- | :---- | :---- |
| 黑板敲击  | 黑板敲击声 | 课堂转场  |
| 下雨    | 下雨声   | 氛围感   |
| 玻璃碎裂  | 玻璃碎裂声 | 高级音效  |

## 参数选择建议

| 场景        | 推荐参数     | 说明                        |
| :-------- | :------- | :------------------------ |
| 常规音效生成    | 创建音效生成任务 | 输入明确、具体的声音描述，生成相应音效       |
| 多候选结果生成   | 创建音效生成任务 | 默认一次生成 4 条候选结果，便于筛选       |
| 定长或自动时长生成 | 创建音效生成任务 | 可指定音效时长，也可由模型自动判断         |
| 指定音频格式    | 创建音效生成任务 | 根据业务需求选择 `mp3` 或 `wav` 格式 |

## 计费说明

请参考 **[计费规则](/guides/account/billing#音效生成)**。

## 典型应用场景

### 短视频与影视制作

为短视频、动画和短剧快速补充动作声、拟音和环境声，让画面反馈更加清晰。

### 游戏与互动体验

为界面反馈、角色动作、道具交互和环境事件探索声音方案。

### 广告与产品演示

为包装拆封、瓶盖开启、液体倾倒、旋钮转动和设备启动等画面补充声音。

## 开始使用

<Steps>
  <Step title="获取 API Key">
    前往 [API 密钥](https://senseaudio.cn/api-platform/api-key) 创建您的 API Key。
  </Step>

  <Step title="描述目标声音">
    输入清晰具体的声音描述，例如“玻璃碎裂声”“雨打窗户声”或“按钮点击反馈音”。
  </Step>

  <Step title="创建音效任务">
    调用 [音效生成](/api-reference/endpoint/sfx/create) 接口，按需设置 `variants_count`、`duration_seconds`、`smart_duration` 和 `output_format`。
  </Step>

  <Step title="获取生成结果">
    请求完成后直接获取生成结果，并从候选音效中选择适合业务场景的版本。
  </Step>
</Steps>

## 相关资源

<CardGroup cols={2}>
  <Card title="音效生成 API" icon="file-audio" href="/api-reference/endpoint/sfx/create">
    根据文本描述同步生成 1-4 个音效变体。
  </Card>

  <Card title="模型列表" icon="list" href="/guides/account/model-list">
    查看音效生成模型和价格信息。
  </Card>

  <Card title="计费规则" icon="credit-card" href="/guides/account/billing">
    查看音效生成的积分消耗规则。
  </Card>
</CardGroup>