← 所有文章

Sora API 与 MCP：如何把视频生成接入你的项目

发光的天空与抽象的光粒子云

Sora 是一系列视频生成模型。NeuralSpace 提供以下模型：Sora 2, Sora 2 Pro。它们都通过同一个公开 API 运行，并为 AI 智能体提供了现成的 MCP 服务器。密钥在 API 密钥页面 签发。本文介绍它的能力、请求示例和接入方法。

Sora 能做什么

Sora 2 根据文本生成视频，价格取决于时长（10 或 15 秒）。Sora 2 Pro 还可选择 standard 或 high 质量。支持 landscape 和 portrait 方向，并可通过 image_urls 传入原图进行图生视频。

API 端点

请求发送到 POST /v1/videos/generations。示例：{"model": "sora-2", "prompt": "日落时海岸上的波浪", "duration": 10, "aspect_ratio": "landscape"}。授权使用请求头 x-api-key 中的 API key。可用的模型 id：sora-2, sora-2-pro。

发光的抽象光粒子云

MCP 工具

NeuralSpace 的 MCP 服务器位于 POST /mcp（Streamable HTTP）。要使用 Sora，智能体调用工具：generate_video, check_video, list_models, get_balance。这让 Claude Code、Cursor 等 MCP 客户端能直接使用网站模型。

如何接入

在 NeuralSpace 注册，打开 API 密钥页面 并创建 nsk-… 格式的密钥。然后在请求头或 MCP 客户端设置中传入它。完整文档见 /v1/docs 页面。

常见问题

有哪些时长？

10 秒和 15 秒。

Pro 和普通版有什么区别？

Pro 还可选择 standard 或 high 质量。

支持参考图吗？

支持，通过 image_urls 进行图生视频。