常见问题

如何选择模型？

调用 GET /v1/models，从返回列表中选择与任务类型匹配的模型。图片生成示例 使用 gpt-image-2，但每个账号看到的可用模型可能不同；实时接口结果优先于 文档中的示例名称。

模型在列表中，为什么请求仍然失败？

模型列表表示当前可发现或可路由，并不保证每次请求都有可用通道。模型可能 暂时过载、被账号权限限制、上游故障，或不接受你传入的尺寸和可选字段。 先查看 HTTP 状态码和 error.message：400 修正参数，403 检查权限， 429 降低速率，502/503 按错误页退避重试。

/v1/models 会消耗额度吗？

模型查询本身是读取接口，通常不消耗文本、图片或视频生成额度；它不会提交 生成任务。速率限制和账号策略仍可能适用，应用不应高频轮询。

为什么流式响应会断开？

流式响应是持续的 SSE 连接，网络代理、客户端超时、服务重启或上游异常都 可能中断。客户端应增量处理已收到的事件，记录 request ID，并按 流式指南处理 data: [DONE]。断线不代表上游一定已取消， 尤其不要在未知接受状态时立即重复提交付费任务。

视频任务结果在哪里？

视频任务提交成功后保存公开的 task_id，然后查询 GET /v1/tasks/{task_id}。成功后调用 GET /v1/tasks/{task_id}/artifacts 获取产物列表，再使用 GET /v1/tasks/{task_id}/artifacts/{artifact_key}/content 下载指定产物。 结果 URL 可能过期，完成后应尽快下载。

客户端可以直接调用 GlobalStore 吗？

不能。客户端只应调用 YUNiversity API 的公开接口，例如 POST /v1/tasks/globalstore 以及对应的任务查询和产物接口。GlobalStore 的 上游地址、凭证和内部配置不属于公开 API 合同，也不应写入前端、日志或请求。

可以把 API Key 放在浏览器前端吗？

不可以。浏览器源码、网络请求和扩展都可能暴露 Key。将请求放在自己的后端， 由后端从 YUNIVERSITY_API_KEY 环境变量读取凭证，再向 API 发起调用。