概述
清波 API 的端点分为两类：同步端点
请求后阻塞等待，直接返回结果。适用于文本生成、语音合成等快速任务。
异步任务
请求后立即返回 task_id，通过轮询或 Webhook 获取结果。适用于图像、视频生成等耗时任务。
同步端点
以下端点为同步模式，请求完成后直接返回结果：异步任务端点
图像和视频生成使用统一的异步任务系统：任务族只有异步语义。需要”提交并等待”时，用
POST /v1/tasks + Prefer: wait=N 请求头
（N ≤ 60 秒）：窗口内完成直接返回完整结果，超窗返回当前状态转轮询。
详见 提交任务。如何选择
- 文本对话 → 使用同步端点，支持流式输出（SSE）
- 图像生成 → 简单场景用
/v1/images/generations，复杂场景用/v1/tasks（不想轮询加Prefer: wait） - 视频生成 → 只能用
/v1/tasks（耗时较长） - 需要回调通知 → 使用
/v1/tasks+callback_url