QuantumNous / QuantumNous/new-api

改进说明:Veo 不得走 generateContent / chat,需走 Vertex 长运行视频接口

Open
#4,476 2 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

bug documentation enhancement
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

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. 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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.