QuantumNous / QuantumNous/new-api
改进说明:Veo 不得走 generateContent / chat,需走 Vertex 长运行视频接口
Nobody has claimed this yet.
- Dominant language
- Go
- Stars
- 48.5k
- Forks
- 11.6k
- Avg merge
- 1d 13h
- Merged PRs (30d)
- 58
Description
[√] 我已确认目前没有类似 issue
[√] 我已确认我已升级到最新版本
[√] 我已完整查看过项目 README,已确定现有版本无法满足需求
[√] 我理解并愿意跟进此 issue,协助测试和提供反馈
[√] 我理解并认可上述内容,并理解项目维护者精力有限,不遵循规则的 issue 可能会被无视或直接关闭
功能描述
希望在项目中明确、集中地说明 Veo 的正确接入方式,并尽可能在错误路径上给出可操作的提示,避免用户通过「聊天/补全」或 OpenAI 风格 chat/completions 调用以 veo- 开头的模型,从而反复收到 Google 侧类似错误:
Veo must be accessed through the Vertex PredictLongRunning API(常见伴随 HTTP 429 / RESOURCE_EXHAUSTED)。
具体期望(可任选或补充):
README / 文档:单独一节说明 Veo 仅能通过 Vertex 的 :predictLongRunning(或官方 google-genai 的 generate_videos)及本项目中对应的视频/任务类接口(如 /v1/videos、视频 generations 等),不要在 generateContent 或普通对话路由中使用 veo-。
(可选)产品行为:在误用 veo- 于非视频任务通道时,返回或日志中附简短指引链接或一句「请改用视频任务接口 / Vertex 任务渠道」。
应用场景
在 self-hosted 网关后接入 Google Vertex / Gemini 的 Veo 视频生成能力。
使用 与聊天共用的「模型名」配置时,容易把 veo-3.x-* 误配到对话/补全渠道,需要文档与产品侧一眼能区分「对话模型」与「Veo 视频任务」,降低排障成本。
新成员或下游客户端开发者在对接时,能按文档一步走对 API,少踩 Google 侧的长错误链。
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start with the README and the existing /v1/videos and video-generation interfaces, then review how Vertex/Gemini Veo usage is described. Done means documenting that Veo uses Vertex predictLongRunning or google-genai generate_videos rather than chat or generateContent, with an optional actionable warning for the wrong route.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- google-cloud
- Domain
- api, documentation
- Issue type
- Documentation
- Difficulty
- 3/5
- Estimated time
- 1-2 days
- Activity status
- Quiet
- Clarity
- Mostly clear
- Newbie friendliness
- 55/100