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

# Seed-Audio 1.0 音频创作

> 通过 OneHub 原生同步接口生成音频，按原始生成时长计费。

`seed-audio-1.0` 支持文本、参考音频或参考图片生成音频。使用非流式 HTTP JSON 协议，单次最长 120 秒。

## 调用入口

```http theme={null}
POST /volcark/openspeech/api/v3/tts/create
Authorization: Bearer <ONEHUB_TOKEN>
Content-Type: application/json
```

```json theme={null}
{
  "model": "seed-audio-1.0",
  "text_prompt": "清晨的鸟鸣，伴随一段轻柔的音乐",
  "audio_config": {"format": "mp3", "sample_rate": 44100},
  "watermark": {"aigc_watermark": true}
}
```

返回原生 JSON，包含 `audio`（base64）、`url`、`duration`、`original_duration` 和可选字幕。URL 有效期为 2 小时，请及时保存调用结果；OneHub 不代为归档音频。

`text_prompt` 最多 3000 字符。`references` 最多 3 条音频参考，每条不超过 30 秒及 10 MB，或最多 1 张 10 MB 图片。音频参考通过 `speaker`、`audio_data` 或 `audio_url` 三选一；图片通过 `image_data` 或 `image_url` 二选一；图片与音频参考不能混用。`@音频N` 与参考数组顺序对应。远端文件的实际格式、音频时长及服务可用性由上游验证。

输出格式支持 `wav/mp3/pcm/ogg_opus`，各格式采样率限制、语速、音量、音调、字幕及水印字段以[官方 API](https://docs.volcengine.com/docs/DoubaoVoice/audio-generation-http?lang=zh)为准。`stream=true` 不受支持。

## 管理员配置

沿用 VolcArk 渠道类型，创建**专用豆包语音渠道**。渠道 Key 使用已开通对应项目和模型权限的豆包语音 API Key；不要填入 Ark 凭据并假定它们通用。BaseURL 留空时本入口使用 `https://openspeech.bytedance.com`；显式设置时填写域名，不带 `/api/v3`。绑定 `seed-audio-1.0` 到用户可访问的模型分组，并沿用平台模型目录维护入口登记 `primary_type=audio`，能力为 `audio_generation/text_to_audio/audio_to_audio/image_to_audio`。目录回填已识别该模型；主动聊天拨测对它禁用。

调用方使用自己的 OneHub Token，不需要也不应传入上游凭据。OneHub 将渠道 Key 注入 `X-Api-Key`，使用平台请求 ID 作为 `X-Api-Request-Id`。请求 ID 用于追踪，不代表上游幂等。

## 费用和失败

平台默认价采用[官方刊例](https://docs.volcengine.com/docs/DoubaoVoice/Billinginstructions-21?lang=zh) 1 元/分钟，按 **`original_duration` 小数秒**计费；客户价和折扣沿用既有配置。`duration` 是后处理时长，倍速不改变计费原始时长。资源包成本不会自动改写平台售价。开始前按 120 秒上限预留额度，结束后按实际时长结算并退还差额。

消费日志的 `audio_seconds/original_duration` 保存原始秒数，`duration` 保存处理后秒数；原始用量、价格、费用、请求 ID 和上游 Logid 可关联。Token 计数不代替秒数。无价格、错误价格类型、无额度或无渠道凭据时不发送至上游。

上游错误、无效结果、缺失或非法计费时长不会按文本长度或处理后时长猜费。OneHub 不自动重发；发送后结果未知时保留对账状态。交付失败按同步缓冲响应规则退款，保留供应商费用估计与退款证据。费用估计不等于供应商实际账单。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.