跳转到主要内容

​
使用 Vidgo API 构建

通过一个 API Key 调用图像、视频、音频、音乐、3D 和 LLM 模型。生成类模型共用同一套异步的提交与查询流程；LLM 模型使用兼容 OpenAI、Claude 和 Gemini 的接口。

获取 API Key

在 Vidgo 仪表盘中创建和管理 API Key。

发起第一个请求

使用 cURL、Python 或 JavaScript 提交任务并轮询结果。

查看价格

查看当前模型价格。

处理错误

响应格式与 HTTP 状态码。

用 AI 编程助手接入

将 Claude Code、Codex、Cursor 或 OpenCode 接入 Vidgo 文档 MCP 服务（https://docs.vidgo.ai/mcp），并复制一段适用于任意编程助手的接入提示词。

​
1. 可用模型

每个模型分类都有一个概览页，列出全部模型及其 model ID：

图像

文生图与图像编辑。

视频

文本、图像与参考素材生成视频。

音频

文本转语音（TTS）。

LLM

GPT、Claude、Gemini、Grok 和 Kimi。

3D

文本与图像生成 3D 模型。

音乐

Suno 音乐接口与音乐模型。

​
2. 认证

在 API Key 页面创建 API Key。每个请求都必须包含：
Claude Messages 也接受 x-api-key，Gemini Native Format 也接受 x-goog-api-key。
切勿在前端代码中暴露 API Key（浏览器、移动应用、公开仓库）。请只在服务端保存。

​
3. 提交生成任务

生成任务是异步的。向 POST /api/generate/submit 提交任务，并保存返回的 task_id。
提交成功只表示任务已被接受，并不表示生成已经完成。

​
4. 获取结果

1

提交

发送生成请求，并保存返回的 task_id。
2

等待结果

轮询获取任务状态，或传入 callback_url，在任务变为 finished 或 failed 时接收 Webhook。
3

保存输出

下载 files 中的文件，并保存到你自己的存储中。
Suno 音乐接口使用查询音乐详情和音乐 Webhook，而不是统一的任务状态接口。

​
5. 数据保留

生成的文件有效期为 24 小时。请及时下载并保存结果。

​
6. 上线前检查

API Key 只保存在服务端，不要暴露在浏览器或移动端代码中。
提交前按所选模型页面校验输入参数。
明确处理 400、401、429 和临时性的 5xx 响应，参见错误码。
每次重试提交都可能产生新的计费任务；重新提交前先确认原请求是否已创建任务。
通过查询用户余额查看剩余积分。

​
7. 支持

邮件

[email protected]

常见问题

计费、模型与常见问题。