跳转到主要内容

概述

WaveAPI 的端点分为两类:

同步端点

请求后阻塞等待,直接返回结果。适用于文本生成、语音合成等快速任务。

异步任务

请求后立即返回 task_id,通过轮询或 Webhook 获取结果。适用于图像、视频生成等耗时任务。

同步端点

以下端点为同步模式,请求完成后直接返回结果:
端点用途
/v1/chat/completions文本生成(OpenAI 兼容)
/v1/messages文本生成(Claude 原生)
/v1/beta/models/{model}:generateContent文本生成(Gemini 原生)
/v1/audio/speechTTS 文字转语音
/v1/audio/transcriptionsSTT 语音识别
/v1/images/generations同步图像生成
/v1/embeddings文本嵌入
/v1/responsesOpenAI Responses API

异步任务端点

图像和视频生成使用统一的异步任务系统:
端点用途
POST /v1/tasks提交异步任务,立即返回 task_id
POST /v1/tasks/sync提交并等待完成(超时回退为轮询)
GET /v1/tasks/{task_id}查询任务状态和结果
POST /v1/tasks/{task_id}/cancel取消排队中的任务

如何选择

  • 文本对话 → 使用同步端点,支持流式输出(SSE)
  • 图像生成 → 简单场景用 /v1/images/generations,复杂场景用 /v1/tasks
  • 视频生成 → 只能用 /v1/tasks(耗时较长)
  • 需要回调通知 → 使用 /v1/tasks + callback_url