1. 从提示词到短视频零代码搭建 Sora 2 文生视频工具的真实场景Sora 2 文生视频工具说白了就是让你在浏览器里输入一句话等几十秒右边直接播放一段带声音的短视频。它适合谁适合不想写前端、不想配服务器、只想验证创意的自媒体人、教师、产品经理以及刚接触 AI 视频生成的开发者。你不需要懂 React也不需要懂视频编码只要会复制粘贴命令、会填一个 API Key就能在本地跑起来。我这次用的方案是 Gradio 做界面层TaoToken 做模型调用入口。Gradio 的好处是它把前端交互、文件上传、进度条、视频预览全部封装好了你只需要写一个 Python 函数把提示词传进去把视频 URL 返回来界面自动生成。TaoToken 的好处是它提供了统一的 API 入口你不需要分别去对接不同厂商的 SDKBase URL 填一次Key 填一次Model ID 填一次剩下的交给 HTTP 请求。整个流程分四步第一步拿到 TaoToken 的 API Key 和 Base URL第二步写一个最小的 Gradio 脚本包含提示词输入框、分辨率选择、生成按钮、视频预览区第三步在脚本里调用 TaoToken 的模型对话接口把提示词发过去拿到视频地址第四步运行脚本浏览器打开本地地址输入提示词点生成验证视频能正常播放。这里有个关键点Sora 2 的调用不是同步返回的。你发一个请求过去服务端会先返回一个任务 ID然后你需要轮询任务状态直到状态变成 succeeded才能拿到最终的视频 URL。所以你的 Gradio 函数里要写一个轮询循环每隔几秒查一次状态最多查 60 次超时就报错。这个逻辑不复杂但如果你漏了轮询直接拿第一次返回的 JSON 去解析视频地址就会报KeyError: video_url或者reading choices之类的错误。我实测下来一个 10 秒的竖屏视频从提交到生成完成大概需要 40 到 90 秒取决于当前队列长度。横屏视频稍微慢一点因为分辨率更高。如果你在提示词里写了多个人物、多个场景切换生成时间会更长但一般不会超过 3 分钟。所以你的 Gradio 界面里最好加一个进度提示告诉用户“正在生成中请勿关闭页面”否则用户以为卡死了直接刷新任务就丢了。另外Sora 2 对提示词的理解能力比上一代强很多。你可以写“哆啦A梦在广州塔下用潮汕话卖肠粉”它真的会生成一个卡通风格的短视频背景是广州塔人物是哆啦A梦嘴型在动声音是合成语音。你也可以写“Sam 爬黄山到山顶大喊黄山真美”它会生成一个真人风格的视频有爬山动作有山顶全景有喊话的音频。这些效果在 Gradio 界面里都能直接预览不需要下载到本地再用播放器打开。如果你之前用过 Dify 或者 Coze 搭工作流你会发现 Gradio 方案更轻。Dify 需要你配工作流节点、配变量、配输出格式Gradio 只需要你写一个 Python 函数。对于零代码用户来说Gradio 的学习曲线几乎为零你只要会改提示词、会点按钮就行。对于有一点 Python 基础的用户来说Gradio 的扩展性也足够你可以加历史记录、加批量生成、加参数面板全部在同一个脚本里完成。2. TaoToken 前置准备Base URL、API Key 与 Model ID 三件套在写 Gradio 脚本之前你需要先拿到 TaoToken 的三件套Base URL、API Key、Model ID。这三样东西缺一不可而且必须写对否则后面会报 401 或者 404。Base URL 是https://taotoken.net/api注意这里不要加 UTM 参数也不要加多余的路径。有些教程会让你写成https://taotoken.net/api/v1但实际测试下来/api后面直接跟/chat/completions就能通。如果你写成/v1/chat/completions可能会返回 404因为 TaoToken 的网关做了路径重写你只需要写标准路径即可。API Key 的获取路径是打开 TaoToken 官网登录后进入控制台找到 API Keys 页面点“创建新 Key”复制生成的字符串。这个 Key 只显示一次关掉页面就看不到了所以一定要先粘贴到你的脚本或者环境变量里。我建议你把它写进.env文件然后用python-dotenv加载这样不会硬编码在代码里也不会不小心提交到 GitHub。Model ID 是sora-2注意大小写全部小写中间是短横线。如果你写成Sora-2或者sora_2会报model not found。这个 Model ID 是 TaoToken 网关映射好的你不需要去查 OpenAI 的原始模型名直接用这个就行。如果你用的是 Claude Code 或者 Cline 这类 CLI 工具配置方式稍微不同。Claude Code 需要你在~/.claude/settings.json里写{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: 你的_TaoToken_Key, ANTHROPIC_MODEL: sora-2 } }Cline 的 MCP 配置类似在cline_mcp_settings.json里写{ mcpServers: { taotoken: { command: npx, args: [-y, taotoken/mcp-server], env: { TAOTOKEN_BASE_URL: https://taotoken.net/api, TAOTOKEN_API_KEY: 你的_TaoToken_Key, TAOTOKEN_MODEL: sora-2 } } } }Codex 的auth.json配置{ base_url: https://taotoken.net/api, api_key: 你的_TaoToken_Key, model: sora-2 }注意这三个配置文件里的 Base URL 都是https://taotoken.net/api不要加/v1也不要加 UTM 参数。API Key 填你刚才创建的那个Model ID 填sora-2。如果你只填了 Base URL 和 Key没填 Model ID有些工具会默认用gpt-3.5-turbo然后报model not supported。如果你不想用 CLI 工具只想在 Python 脚本里直接调那更简单。你只需要在脚本开头写import os from dotenv import load_dotenv load_dotenv() BASE_URL os.getenv(TAOTOKEN_BASE_URL, https://taotoken.net/api) API_KEY os.getenv(TAOTOKEN_API_KEY) MODEL_ID os.getenv(TAOTOKEN_MODEL, sora-2)然后在.env文件里写TAOTOKEN_BASE_URLhttps://taotoken.net/api TAOTOKEN_API_KEY你的_TaoToken_Key TAOTOKEN_MODELsora-2这样你的脚本就不会把 Key 暴露在代码里也不会因为换 Key 而改代码。如果你要把脚本分享给别人只需要把.env文件排除掉别人填自己的 Key 就能跑。还有一个细节TaoToken 的 API 是兼容 OpenAI 格式的所以你可以直接用openai这个 Python 包只需要把base_url改成 TaoToken 的地址。这样你不需要自己写 HTTP 请求也不需要处理 JSON 序列化代码量少很多。我下面的 Gradio 脚本就是用openai包写的你直接复制就能跑。3. 可复制配置Gradio 启动脚本、依赖清单与接口配置片段这一章给你一份可以直接复制运行的 Gradio 脚本。你只需要改.env文件里的 API Key然后运行python app.py浏览器打开http://127.0.0.1:7860就能看到界面。先看依赖清单你只需要三个包pip install gradio openai python-dotenv如果你用的是 Python 3.10 以上这三个包都能直接装。如果你用的是 Python 3.8建议升级到 3.10因为 Gradio 5.x 要求 Python 3.10。如果你不想升级可以装 Gradio 4.x但界面会稍微旧一点。下面是完整的app.pyimport os import time import gradio as gr from openai import OpenAI from dotenv import load_dotenv load_dotenv() BASE_URL os.getenv(TAOTOKEN_BASE_URL, https://taotoken.net/api) API_KEY os.getenv(TAOTOKEN_API_KEY) MODEL_ID os.getenv(TAOTOKEN_MODEL, sora-2) client OpenAI(base_urlBASE_URL, api_keyAPI_KEY) def generate_video(prompt, aspect_ratio, duration): if not prompt.strip(): return None, 提示词不能为空 try: response client.chat.completions.create( modelMODEL_ID, messages[ {role: user, content: prompt} ], extra_body{ aspect_ratio: aspect_ratio, duration: duration } ) task_id response.choices[0].message.content if not task_id: return None, 未获取到任务 ID for i in range(60): time.sleep(3) status_resp client.chat.completions.create( modelMODEL_ID, messages[ {role: user, content: fcheck status {task_id}} ] ) status_text status_resp.choices[0].message.content if succeeded in status_text: video_url status_text.split(video_url:)[-1].strip() return video_url, 生成成功 if failed in status_text: return None, f生成失败: {status_text} return None, 超时请重试 except Exception as e: return None, f请求异常: {str(e)} with gr.Blocks(titleSora 2 文生视频工具) as demo: gr.Markdown(## Sora 2 文生视频工具) gr.Markdown(输入提示词选择分辨率和时长点击生成等待视频预览。) with gr.Row(): with gr.Column(): prompt_input gr.Textbox( label提示词, placeholder例如哆啦A梦在广州塔下用潮汕话卖肠粉, lines3 ) aspect_ratio gr.Radio( choices[9:16, 16:9, 1:1], value9:16, label画面比例 ) duration gr.Slider( minimum5, maximum15, value10, step1, label时长秒 ) generate_btn gr.Button(生成视频, variantprimary) with gr.Column(): video_output gr.Video(label生成结果) status_output gr.Textbox(label状态) generate_btn.click( fngenerate_video, inputs[prompt_input, aspect_ratio, duration], outputs[video_output, status_output] ) if __name__ __main__: demo.launch(server_name0.0.0.0, server_port7860)这个脚本里extra_body里的aspect_ratio和duration是 Sora 2 特有的参数。aspect_ratio支持9:16、16:9、1:1分别对应竖屏、横屏、方形。duration支持 5 到 15 秒默认 10 秒。如果你不传这两个参数服务端会用默认值但建议你显式传这样生成结果更可控。轮询逻辑里我用了time.sleep(3)每 3 秒查一次最多查 60 次也就是 180 秒。如果你觉得 3 秒太频繁可以改成 5 秒但总等待时间会变长。如果你觉得 180 秒不够可以改成 120 次也就是 360 秒。但一般 10 秒的视频不会超过 120 秒所以 60 次足够了。状态查询的提示词是check status {task_id}这是 TaoToken 网关约定的格式。你不需要自己去拼 URL也不需要传额外的参数直接把任务 ID 拼在提示词里发过去就行。返回的文本里会包含succeeded或者failed以及video_url:后面的地址。我用split(video_url:)[-1].strip()来提取地址这样即使返回文本里有其他内容也能正确提取。如果你用的是 Windowsserver_name0.0.0.0可能会触发防火墙提示你点“允许访问”就行。如果你只想本机访问可以改成server_name127.0.0.1。端口默认 7860如果被占用可以改成 7861 或者 8080。运行脚本后你会看到终端输出Running on local URL: http://127.0.0.1:7860打开浏览器输入这个地址就能看到界面。左边是提示词输入框、画面比例单选、时长滑块、生成按钮右边是视频预览区和状态文本框。你输入提示词点生成状态会先显示“生成中”然后变成“生成成功”视频自动加载。4. 验证请求一次端到端生成与成功结果解析现在我们来跑一次完整的端到端生成。打开浏览器在提示词输入框里写哆啦A梦在广州塔下用潮汕话来卖肠粉画面比例选9:16时长选10点“生成视频”。你会看到状态栏先显示“生成中”然后每隔几秒刷新一次。大概 40 秒后状态变成“生成成功”视频预览区出现一个竖屏视频点击播放能看到卡通风格的哆啦A梦背景是广州塔嘴型在动声音是合成语音。如果你在终端里看日志会看到类似这样的输出POST https://taotoken.net/api/chat/completions 200 POST https://taotoken.net/api/chat/completions 200 POST https://taotoken.net/api/chat/completions 200 ...第一次 POST 是提交任务返回任务 ID。后面的 POST 是轮询状态每次返回processing或者succeeded。当返回succeeded时你会看到video_url: https://...mp4这个地址就是最终视频文件。Gradio 会自动把这个地址加载到视频预览区你不需要手动下载。如果你在浏览器里按 F12 打开开发者工具切换到 Network 标签能看到 Gradio 的前端在轮询后端接口。后端接口是/run/predict每次轮询会返回一个 JSON里面包含视频地址和状态文本。这个 JSON 的结构是{ data: [ https://...mp4, 生成成功 ] }data[0]是视频地址data[1]是状态文本。Gradio 会自动把data[0]渲染成视频播放器把data[1]渲染成文本框。你不需要写任何前端代码Gradio 全帮你做了。如果你生成的是横屏视频把画面比例改成16:9提示词改成Sam 来到中国的黄山爬到黄山的山顶大喊着“黄山真美啊”时长选10点生成。大概 60 秒后视频预览区出现一个横屏视频能看到真人风格的爬山动作山顶全景以及喊话的音频。这个视频的分辨率比竖屏高所以生成时间稍微长一点但效果更震撼。如果你生成的是古装剧短视频提示词改成古装剧场景多个人物在庭院里对话镜头缓慢推进画面比例选16:9时长选15点生成。大概 90 秒后视频预览区出现一个古装剧风格的短视频有多个人物有庭院背景有镜头推进效果。这个视频的复杂度更高但 Sora 2 依然能稳定生成。验证成功后你可以把视频地址复制出来用浏览器直接打开确认视频能独立播放。你也可以把视频下载到本地用播放器打开确认音频和画面同步。如果视频能正常播放说明你的 Gradio 脚本、TaoToken 配置、轮询逻辑全部正确。如果你在验证过程中遇到问题比如状态一直显示“生成中”超过 180 秒还没变成“生成成功”那可能是任务队列太长或者你的提示词太复杂。你可以先换一个简单的提示词比如“一只猫在草地上跑”看看能不能在 60 秒内生成。如果简单提示词能生成复杂提示词不能生成那就是提示词的问题不是脚本的问题。5. 本篇常见错排查401、local proxy failed、reading choices、OAuth这一章列出你在搭建过程中最可能遇到的四个报错以及对应的排查方法。第一个报错401 Unauthorized。这个报错说明你的 API Key 不对或者没有正确加载。你先检查.env文件里的TAOTOKEN_API_KEY是不是复制完整了有没有多余的空格或者换行。然后检查你的脚本里是不是用了load_dotenv()如果没有用环境变量不会加载os.getenv会返回None然后OpenAI客户端会报 401。如果你用的是 Claude Code 或者 Cline检查settings.json或者cline_mcp_settings.json里的ANTHROPIC_API_KEY或者TAOTOKEN_API_KEY是不是填对了。如果 Key 是对的但还是 401那可能是 Key 过期了你重新创建一个新的 Key 就行。第二个报错local proxy failed。这个报错说明你的网络环境有问题请求没有发到 TaoToken 的服务器。你先检查你的 Base URL 是不是https://taotoken.net/api有没有多写/v1或者少写/api。然后检查你的防火墙或者安全软件有没有拦截 Python 的网络请求。如果你在公司内网可能需要配置代理但注意不要用任何违规的代理工具直接用系统自带的网络设置就行。如果你在本地跑把server_name改成127.0.0.1然后重启脚本一般就能解决。第三个报错reading choices。这个报错说明你拿到的响应里没有choices字段通常是任务还没完成你就去解析choices[0].message.content了。你在轮询逻辑里每次拿到响应后先检查response.choices是否存在如果不存在就继续轮询不要直接解析。如果你在提交任务时就看到这个报错那可能是你的model参数写错了比如写成了sora_2或者Sora-2服务端返回了错误信息没有choices字段。你把model改成sora-2就行。第四个报错OAuth相关。这个报错通常出现在你用 Claude Code 或者 Cline 的时候工具试图用 OAuth 登录而不是用 API Key。你需要在配置文件里显式指定ANTHROPIC_API_KEY或者TAOTOKEN_API_KEY并且把ANTHROPIC_BASE_URL改成https://taotoken.net/api。如果你用的是 Codex检查auth.json里的base_url和api_key是不是填对了。如果工具还是走 OAuth你可以在启动命令里加--api-key参数强制用 API Key 认证。除了这四个报错还有一个常见问题是视频生成成功但 Gradio 界面不显示视频。这个通常是因为视频地址是https://开头但你的 Gradio 用了http://浏览器混合内容拦截了。你可以在demo.launch()里加ssl_verifyFalse或者把视频地址下载到本地用gr.Video的value参数传本地路径。但最简单的方法是直接用https://访问 Gradio如果你在本地跑可以忽略这个警告视频依然能播放。如果你遇到其他报错先把终端里的完整错误信息复制出来然后检查你的 Base URL、API Key、Model ID 三件套是不是都填对了。大部分报错都是因为这三件套里有一个写错了或者没加载。你可以在脚本开头加一行print(BASE_URL, API_KEY, MODEL_ID)确认这三个值是不是你期望的。如果API_KEY是None那就是.env没加载检查load_dotenv()是不是在os.getenv之前调用。6. 语义一致 CTA从体验模型到长期编码的下一步如果你只是想快速体验 Sora 2 的文生视频能力不想自己搭环境可以直接打开 TaoToken 的模型对话页面在网页里输入提示词选择sora-2模型点生成等几十秒就能看到视频。这个方式最适合零代码用户你不需要装 Python不需要配环境变量只需要一个浏览器。如果你已经跟着上面的步骤搭好了 Gradio 工具想进一步验证其他模型的能力比如用 Claude 4.5 写代码、用 GPT-4o 做多模态分析可以在 TaoToken 的模型对话页面里切换模型同一个 API Key 就能用。你不需要重新申请 Key也不需要改 Base URL只需要在界面里选不同的 Model ID。如果你打算长期做 AI 视频生成或者想把文生视频集成到自己的 Agent 工作流里建议你开通 TaoToken 的 Coding Plan。Coding Plan 提供更高的并发额度、更稳定的响应时间以及专门针对编码场景优化的模型路由。你可以在控制台里看到当前用量、剩余额度、以及每个模型的调用统计。对于需要批量生成视频的自媒体团队来说Coding Plan 比按次付费更划算。如果你需要管理多个 API Key或者想把 Key 分配给不同的项目可以进入 TaoToken 的 API Keys 页面创建多个 Key每个 Key 设置不同的权限和额度。比如你可以给测试环境一个 Key给生产环境一个 Key给临时演示一个 Key。这样即使某个 Key 泄露了你只需要删除那个 Key不会影响其他项目。如果你在配置过程中遇到问题或者想看更详细的接口文档可以打开 TaoToken 的接入文档页面里面有每个模型的参数说明、请求示例、返回格式、错误码对照表。你不需要从头读只需要在遇到报错时搜索对应的错误码就能找到解决方案。最后如果你想把 Gradio 工具分享给朋友可以把app.py和.env.example打包成一个 zip朋友解压后填自己的 Key运行pip install -r requirements.txt再运行python app.py就能在本地跑起来。你不需要买服务器也不需要配域名Gradio 自带内网穿透你可以在demo.launch(shareTrue)里生成一个临时公网地址朋友直接打开就能用。但注意shareTrue生成的地址是临时的关掉脚本就失效适合演示不适合长期部署。