Seed Audio API 文档

Seed Audio API 是异步接口：先创建生成任务并保存任务 ID，然后轮询状态接口，直到任务成功或失败。供应商选择和故障切换由平台内部处理。

查看 API 产品介绍 · 创建或管理 API Key

Base URL

https://seedaudio.co/api/v1

鉴权

在 设置 → API Keys 创建密钥。每个请求都需要携带：

Authorization: Bearer sk_your_api_key

只有购买过套餐或 Credits 的用户可以使用 API。完整密钥只在创建时展示一次。

计费

• 网页和 API 共用同一个 Credits 余额。
• 按实际输出时长逐秒结算，每分钟 75 Credits。
• 最低消费 10 Credits。
• 创建任务时临时预留 150 Credits，对应最长 120 秒。
• 成功后退回未使用的预留 Credits，失败则全额退回。
• 内部切换供应商不会向用户重复收费。

创建音频任务

POST /audio/generations

curl -X POST 'https://seedaudio.co/api/v1/audio/generations' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: demo-request-001' \
  -d '{
    "model": "seed-audio-1.0",
    "prompt": "Generate a short suspense radio drama in English",
    "output_format": "mp3",
    "sample_rate": 24000
  }'

提交成功返回 HTTP 202：

{
  "id": "audio_task_xxx",
  "object": "audio.generation",
  "model": "seed-audio-1.0",
  "status": "processing",
  "billing": { "reserved_credits": 150 },
  "output": null,
  "usage": null,
  "error": null
}

请求字段

字段	类型	必填	说明
model	string	是	固定为 seed-audio-1.0
prompt	string	是	音频场景提示词，最多 2,048 字符
voice	string	否	支持的预设音色 ID
audio_references	string[]	否	最多三个公开音频 URL
image_url	string	否	一个公开图片 URL，不能与参考音频同时使用
output_format	string	否	mp3、wav、pcm 或 ogg_opus
sample_rate	number	否	支持的输出采样率
speed	number	否	语速
volume	number	否	音量
pitch	number	否	音调调整

建议每次创建任务都发送唯一的 Idempotency-Key。相同 Key 和相同请求会返回原任务，不会重复扣费；相同 Key 携带不同请求会返回 HTTP 409。

查询任务状态

GET /audio/generations/{task_id}

curl 'https://seedaudio.co/api/v1/audio/generations/audio_task_xxx' \
  -H 'Authorization: Bearer YOUR_API_KEY'

建议每 3–5 秒查询一次。成功响应：

{
  "id": "audio_task_xxx",
  "object": "audio.generation",
  "model": "seed-audio-1.0",
  "status": "succeeded",
  "output": {
    "url": "https://cdn.seedaudio.co/.../output.mp3",
    "duration_seconds": 43.2,
    "format": "mp3"
  },
  "usage": { "credits": 54 },
  "error": null
}

状态包括：queued、processing、succeeded、failed、canceled。

错误格式

{
  "error": {
    "code": "insufficient_credits",
    "message": "At least 150 credits are required",
    "request_id": "request_xxx"
  }
}

HTTP	Code	含义
400	invalid_request	请求参数错误
401	invalid_api_key	API Key 缺失、无效或已删除
402	insufficient_credits	可用 Credits 少于 150
403	api_access_required	用户没有付费记录
404	task_not_found	任务不存在或不属于当前用户
409	idempotency_conflict	幂等 Key 已用于其他请求
429	rate_limit_exceeded	请求过于频繁

机器可读的 OpenAPI 文件位于 https://seedaudio.co/openapi.json。