团队工作空间与 API 使用
对外 API 的 Key、计费、任务、资产和 Webhook 均以团队工作空间为归属边界。
Yeehoo 对外 API 仅支持团队工作空间。个人工作空间可用于个人产品和订阅，但不能创建或调用 API Key。
接入前提
请先在控制台创建或切换到一个有效的团队工作空间。团队工作空间的 Owner 或 Admin 可创建和管理该空间的 API Key。
每个 API Key 创建后固定归属于一个团队工作空间。调用 API 时，以下数据均归属该 Key 的团队工作空间：
- 积分余额、扣费与用量
- 图片和视频任务
- 参考图上传与生成结果资产
- 模型权限、允许调用的模型和 Webhook 投递
标准接入流程
- 在控制台创建或切换到团队工作空间。
- 创建 API Key，并按需配置 scopes、模型白名单和 Webhook。
- 使用
GET /v1/models确认该 Key 可调用的模型。 - 有参考图时先调用图片上传，再将返回 URL 用于生成请求。
- 图片或视频先调用
POST /v1/quote获取预计积分，再调用POST /v1/generations创建任务。 - 通过
GET /v1/tasks/{task_id}轮询终态，或接收 Webhook 通知。
不要用请求头切换空间
/v1/* 只根据 Authorization: Bearer 中的 API Key 解析团队工作空间，不读取 X-Yeehoo-Workspace-ID。即使请求携带或伪造该 Header，也不会改变计费、任务或资产归属。
如需切换 API 归属，请在对应团队工作空间中创建并使用新的 API Key。