Skip to main content
让 Agent 调用 WaveAPI 生成图像、视频和音频。要在 Codex、Claude Code 中使用 WaveAPI 的文本模型,见 Codex、Claude Code。 三种接入方式,按客户端选一种: MCP 与 Skill 调用的是同一套接口,价格、校验和计费与直接调用 POST /v1/tasks 相同。

设置 API Key

在 控制台 创建 API Key,保存到环境变量 WAVEAPI_API_KEY。不要把 Key 写进命令、配置文件或对话。 macOS(zsh):
launchctl setenv 让 Codex、Cursor 等图形应用读到变量,执行后重启应用。终端里使用时,另在 ~/.zshrc 中 export WAVEAPI_API_KEY。

远程 MCP

Claude Code 的命令用单引号,${WAVEAPI_API_KEY} 原样写进配置,运行时再读环境变量。 配好后发一句测试:

工具

  • create_task 支持 idempotency_key:重试时用同一个值和同样的参数,不会重复建任务。
  • create_task 支持 wait_seconds(0–45),在时限内完成的任务直接返回结果。
  • get_task 返回 terminal、should_poll、next_poll_after_seconds。结果链接的过期时间见 result 里的 expires_at(Unix 秒)。
  • 费用字段 cost、pre_consumed_cost 是 quota,另给出折合美元的 cost_usd、pre_consumed_cost_usd。

Agent Skill

Skill 自带一个零依赖脚本,读取 WAVEAPI_API_KEY,客户端不用配置 MCP。说明见 waveapi-media。

AI 文档

  • 文档索引:https://docs.qingbo.dev/llms.txt
  • 任一文档页地址后加 .md 即为 Markdown 原文,如 https://docs.qingbo.dev/cn/api-reference/video/seedance.md
  • 不能联网的对话类应用(豆包、元宝等),把 PROMPT.md 粘贴到对话开头

限制