LogoSoraVideo 文档

API 概述

Sora 2 视频 API 入门指南

简介

Sora 2 视频 API 允许您将 AI 视频生成功能集成到应用程序中。通过我们的 API，您可以通过编程方式从文本提示或图像创建视频、去除水印以及生成分镜头。

文字转视频

使用最先进的 AI 模型从文本描述生成视频。

图像转视频

将静态图像转换为动态视频内容。

专业版功能

获取更长时长和更高质量的增强生成服务。

分镜头

从结构化提示创建多镜头视频序列。

快速开始

1. 获取 API 密钥

在仪表板中导航至 设置 → API 密钥 创建 API 密钥。

保护好您的密钥

API 密钥仅在创建时显示一次。请安全存储，切勿在客户端代码中暴露。

2. 发起第一个请求

生成视频
curl -X POST https://soravideo.art/api/v1/sora2/text-to-video \
  -H "Authorization: Bearer sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "一只金毛犬在阳光明媚的公园里玩耍"
  }'

3. 查询任务状态

获取任务状态
curl https://soravideo.art/api/v1/tasks/task_abc123 \
  -H "Authorization: Bearer sk_your_api_key"

API 端点

端点描述积分消耗
POST /api/v1/sora2/text-to-video从文字生成视频100
POST /api/v1/sora2/image-to-video从图像生成视频100
POST /api/v1/sora2-pro/text-to-video专业版文字转视频200
POST /api/v1/sora2-pro/image-to-video专业版图像转视频200
POST /api/v1/sora2/watermark-remove去除水印50
POST /api/v1/sora2-pro/storyboard生成分镜头65-162*
GET /api/v1/tasks/{taskId}获取任务状态0
POST /api/v1/upload上传图片0
GET /api/v1/credits获取积分余额0

*分镜头积分按时长计费：10秒 = 65，15秒 = 98，25秒 = 162

响应格式

所有 API 响应遵循统一的 JSON 结构：

成功响应
{
  "code": 200,
  "msg": "success",
  "data": {
    "task_id": "task_abc123",
    "status": "pending"
  }
}
错误响应
{
  "code": 401,
  "error": "Invalid API key"
}

积分系统

每次 API 调用根据端点消耗积分：

  • 标准端点：每次请求 50-100 积分
  • 专业版端点：每次请求 200-300 积分
  • 工具端点（任务、上传、积分）：免费

在 API 密钥 页面购买积分包：

套餐积分价格
基础版100$9.9
标准版200$14.9
高级版500$39.9
企业版1,000$69.9

下一步

认证

了解如何验证您的 API 请求。

端点

所有 API 端点的详细文档。

速率限制

了解使用限制和配额。

代码示例

各种编程语言的示例代码。