智狐AI视频平台（video.aicns.cn）是基于智创聚合API搭建的一个基于AI技术的视频生成服务平台，支持通过文本提示或图片描述生成高质量视频内容，目前已提供API给用户接入自己的AI视频应用，目前支持OpenAI的Sora系列模型和谷歌Gemini的Veo系列模型，相同视频接口可以调用不同视频模型，以下为详细教程

1. 认证方式

API Token

所有API请求都需要在请求头中包含有效的API Token：

Authorization: Bearer YOUR_API_TOKEN

获取API Token

请进入官网生成n.lconai.com。

2. 请求格式

基础请求头

Authorization: Bearer YOUR_API_TOKEN
Content-Type: application/json
# 或 multipart/form-data (用于文件上传)

请求URL

https://n.lconai.com/v1/videos

3. 视频生成接口

3.1 基本文本生成视频

请求参数

参数名	类型	必填	说明
prompt	string	是	视频描述文本
model	string	是	模型名称，如 “sora-2”
seconds	string	是	视频时长（秒）
size	string	是	视频分辨率，如 “1280x720”

JSON格式请求示例

{
  "prompt": "一只猫在沙滩上奔跑",
  "model": "sora-2",
  "seconds": "4",
  "size": "1280x720"
}

cURL请求示例

curl --location -g --request POST 'https://n.lconai.com/v1/videos' \
--header 'Authorization: Bearer YOUR_API_TOKEN' \
--header 'Content-Type: application/json' \
--data-raw '{
  "prompt": "一只猫在沙滩上奔跑",
  "model": "sora-2",
  "seconds": "4",
  "size": "1280x720"
}'

3.2 带参考图片的视频生成

multipart/form-data格式请求

curl --location -g --request POST 'https://n.lconai.com/v1/videos' \
--header 'Authorization: Bearer YOUR_API_TOKEN' \
--form 'prompt="牛马起飞"' \
--form 'model="sora-2"' \
--form 'seconds="4"' \
--form 'size="1280x720"' \
--form 'input_reference=@/path/to/image.png'

4. 响应格式

4.1 成功响应 (HTTP 200)

{
  "id": "video_68e688d4950481918ec389280c2f78140fcb904657674466",
  "object": "video",
  "created_at": 1759938772,
  "status": "queued",
  "completed_at": null,
  "error": null,
  "expires_at": null,
  "model": "sora-2",
  "progress": 0,
  "remixed_from_video_id": null,
  "seconds": "4",
  "size": "720x1280"
}

响应字段说明

字段名	类型	说明
id	string	视频唯一标识符
object	string	对象类型，固定为 “video”
created_at	integer	创建时间戳
status	string	视频状态（queued/processing/completed/failed）
completed_at	integer/null	完成时间戳
error	string/null	错误信息
expires_at	integer/null	过期时间戳
model	string	使用的模型
progress	integer	进度百分比（0-100）
seconds	string	视频时长
size	string	视频分辨率

4.2 错误响应

{
  "error": {
    "message": "Invalid API key",
    "type": "authentication_error",
    "code": 401
  }
}

常见错误码

错误码	类型	说明
401	authentication_error	API密钥无效
400	invalid_request	请求参数错误
429	rate_limit_error	请求频率超限
500	api_error	服务器内部错误

5. 状态查询接口

查询视频状态

curl --location -g --request GET 'https://n.lconai.com/v1/videos/{video_id}' \
--header 'Authorization: Bearer YOUR_API_TOKEN'

6. 使用示例

Python示例

import requests
import json

# API配置
API_TOKEN = "YOUR_API_TOKEN"
API_URL = "https://n.lconai.com/v1/videos"

# 请求头
headers = {
    "Authorization": f"Bearer {API_TOKEN}",
    "Content-Type": "application/json"
}

# 请求数据
data = {
    "prompt": "一只猫在沙滩上奔跑",
    "model": "sora-2",
    "seconds": "4",
    "size": "1280x720"
}

# 发送请求
response = requests.post(API_URL, headers=headers, data=json.dumps(data))

# 处理响应
if response.status_code == 200:
    result = response.json()
    print(f"视频ID: {result['id']}")
    print(f"状态: {result['status']}")
else:
    error = response.json()
    print(f"错误: {error['error']['message']}")

JavaScript示例

const axios = require('axios');

const API_TOKEN = 'YOUR_API_TOKEN';
const API_URL = 'https://n.lconai.com/v1/videos';

async function generateVideo() {
    try {
        const response = await axios.post(API_URL, {
            prompt: '一只猫在沙滩上奔跑',
            model: 'sora-2',
            seconds: '4',
            size: '1280x720'
        }, {
            headers: {
                'Authorization': `Bearer ${API_TOKEN}`,
                'Content-Type': 'application/json'
            }
        });
        
        console.log('视频生成成功:', response.data);
    } catch (error) {
        console.error('错误:', error.response.data.error.message);
    }
}

generateVideo();

7. 最佳实践

7.1 提示词优化

• 使用具体、详细的描述
• 包含动作、场景、风格等信息
• 避免模糊或歧义的表达

7.2 参数选择建议

• 时长: 建议4-8秒，过长可能影响生成质量
• 分辨率: 根据实际需求选择，高分辨率需要更长的生成时间
• 模型: 使用推荐的最新模型获得最佳效果

7.3 错误处理

• 实现重试机制，处理临时性错误
• 合理设置请求间隔，避免触发频率限制
• 记录错误日志，便于问题排查

8. 注意事项

• API Token需要妥善保管，不要暴露在客户端代码中
• 遵守服务条款，不要生成违规内容
• 关注API使用配额，避免超额使用
• 定期检查API更新，及时调整集成代码

本文档基于智创聚合API最新版本编写，如有更新请以官方文档为准。