一、Sora2 API 简介
Sora2 API 是 小镜AI 提供的一套视频生成接口，开发者可以通过编程方式快速生成高质量的视频内容。该接口支持Sora2与Sora2‑Pro两种模型，既能满足基础视频生成需求，也可输出高清（HD）视频，适用于广告投放、创意短视频、品牌宣传等多种业务场景。
本文将从接口说明、请求参数、使用流程及最佳实践等方面，详细介绍 Sora2 API 的集成方法。
二、Sora2 API 功能概览
Sora2 API 主要提供视频生成相关能力，核心接口如下：
- 视频生成接口
注册及说明地址：
https://open.xiaojingai.com/register?aff=xeu4
通过该接口可基于文本提示创建异步视频生成任务，支持选择不同模型，并可灵活配置视频方向、时长和清晰度。
接口采用API Key方式进行身份认证，同时支持 Webhook 回调，在任务完成或失败时主动通知调用方。
三、接入前准备
在使用 Sora2 API 之前，请确保满足以下条件：
- 具备可发送 HTTP 请求的开发环境，例如：
- Python（requests）
- Node.js（axios）
- 其他支持 REST API 的工具
- 对 JSON 数据格式及异步任务处理流程有基本了解
四、视频生成接口说明
4.1 接口地址
import requests import json # 配置 API 端点 (以小镜AI开放平台为例) API_URL = "https://api.xiaojingai.com/v1/images/generations" API_KEY = "sk-your-api-key-here" def generate_studio_image(): headers = { "Authorization": f"Bearer {API_KEY}", "Content-Type": "application/json" } # 构造 Prompt，注意强调光影和文字 payload = { "model": "gemini-3-pro-image-preview", # 或 nano-banana-pro "prompt": ( "一张科技感十足的产品海报，主体是一个透明的AI芯片。" "背景是赛博朋克风格的实验室，霓虹蓝光从左侧照射。" "芯片下方有清晰的白色文字写着：'Nano Banana Core'。" "4k resolution, studio lighting, hyper-realistic." ), "n": 1, "size": "1024x1024", "response_format": "url", # 高级参数（假设平台支持透传） "parameters": { "aspect_ratio": "16:9", "guidance_scale": 7.5, "style_preset": "photographic" } } try: response = requests.post(API_URL, headers=headers, json=payload) response.raise_for_status() result = response.json() print("生成成功！图片地址：") print(result['data'][0]['url']) except requests.exceptions.RequestException as e: print(f"请求失败: {e}") if __name__ == "__main__": generate_studio_image()请求体为 JSON 格式，支持的参数如下：
| 参数名 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| model | String | 是 | 使用的视频模型：sora-2（基础）或sora-2-pro（高清） |
| prompt | String | 是 | 视频内容的文字描述，最长 4000 字符 |
| referImages | Array | 否 | 参考图片 URL 列表（禁止包含人物头像） |
| orientation | String | 否 | 视频方向：portrait（竖屏，720×1280 或 1024×1792）或landscape（横屏，1280×720 或 1792×1024） |
| duration | Integer | 否 | 视频时长（秒）：10、15、25（仅限 Sora2‑Pro） |
| size | String | 否 | 清晰度级别：small（普通）或large（高清，仅限 Sora2‑Pro；25 秒仅支持 small） |
| hookUrl | String | 否 | 任务完成或失败时的回调地址；若未提供需手动查询结果 |
使用建议与最佳实践
错误处理机制
通过响应中的status和message字段判断请求是否成功。对于失败请求，可结合指数退避策略进行重试。轮询与回调选择
若未配置hookUrl，可每隔约 10 秒调用 fetch 接口查询任务状态。注意避免高频请求，以免触发限流。提示词优化（Prompt Engineering）
描述越清晰，生成效果越理想。建议明确指定画面风格、场景元素、镜头语言、光照条件和动作细节。配额监控
API 返回结果中包含quota字段，用于显示剩余调用额度。建议在系统中持续监控，防止超额使用。模型选择建议
- 追求生成速度与成本控制：选择sora-2
- 追求更高画质与灵活参数：选择sora-2-pro
