跳转到主要内容
POST
/
api
/
v1
/
sora2api
/
generate
生成Sora2API视频
curl --request POST \
  --url https://api.sora2api.ai/api/v1/sora2api/generate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "一只可爱的小猫在花园里玩耍,阳光明媚的春天",
  "imageUrls": [
    "https://example.com/image.jpg"
  ],
  "aspectRatio": "landscape",
  "quality": "hd",
  "watermark": "我的水印",
  "callBackUrl": "https://api.example.com/callback"
}
'
{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "sora2_task_abcdef123456"
  }
}

使用指南

  • 此端点根据您的文本提示词创建视频
  • 支持文本生成视频、图像生成视频等多种模式
  • 可自定义清晰度、宽高比和水印

Authorizations

Authorization
string
header
required

所有 API 都需要通过 Bearer Token 进行认证。

获取 API Key:

  1. 访问 API Key 管理页面 获取您的 API Key

使用方法: 添加到请求头: Authorization: Bearer YOUR_API_KEY

注意:

  • 请妥善保管您的 API Key,不要与他人分享
  • 如果您怀疑 API Key 已泄露,请立即在管理页面重置

Body

application/json
prompt
string
required

生成内容的提示词。详细描述所需的视频或图像内容。

  • 应该详细且具体地描述内容
  • 可以包含风格、构图、光线和其他视觉元素
Example:

"一只可爱的小猫在花园里玩耍,阳光明媚的春天"

aspectRatio
enum<string>
required

输出视频的宽高比。

支持的宽高比:

选项描述常见用途
landscape横屏高清视频,桌面壁纸,横向观看
portrait竖屏手机壁纸,短视频,竖向观看
可用选项:
landscape,
portrait
Example:

"landscape"

quality
enum<string>
required

生成内容的清晰度。

  • standard: 标准清晰度
  • hd: 高清
可用选项:
standard,
hd
Example:

"hd"

imageUrls
string[]

图片链接数组。用于图生图或图生视频的输入图片。

  • 可选参数
  • 必须是有效的图片URL
  • 图片必须能被API服务器访问
  • 文生图时可留空
Example:
["https://example.com/image.jpg"]
watermark
string

水印文字。

  • 可选参数
  • 如果提供,将在生成的内容上添加水印文字
Example:

"我的水印"

callBackUrl
string<uri>

回调地址,用于接收任务完成更新。

  • 可选但建议在生产环境中使用
  • 系统将通过POST请求将任务完成状态发送到此URL
  • 或者,可以使用获取任务详情接口检查状态
Example:

"https://api.example.com/callback"

Response

请求成功

code
enum<integer>

响应状态码

  • 200: 成功 - 请求已成功处理
  • 400: 请求错误 - 无效的请求参数
  • 401: 未授权 - 认证凭据缺失或无效
  • 402: 积分不足 - 账户没有足够的积分执行操作
  • 404: 未找到 - 请求的资源或端点不存在
  • 422: 验证错误 - 请求参数验证失败
  • 429: 请求限制 - 已超过该资源的请求限制
  • 455: 服务不可用 - 系统正在进行维护
  • 500: 服务器错误 - 处理请求时发生意外错误
  • 501: 生成失败 - 图像生成任务失败
  • 505: 功能禁用 - 请求的功能当前已禁用
可用选项:
200,
400,
401,
402,
404,
422,
429,
455,
500,
501,
505
msg
string

响应消息

Example:

"success"

data
object