跳转到主要内容
POST
/
v1
/
videos
curl --request POST \
  --url 'https://api.elkapi.com/v1/videos' \
  --header 'Authorization: Bearer <token>' \
  --form 'model=sora-2' \
  --form 'prompt=一只小猫在阳光下的花园里奔跑,电影感,高细节' \
  --form 'image=https://example.com/image.png' \
  --form 'duration=5' \
  --form 'width=1280' \
  --form 'height=720' \
  --form 'fps=30' \
  --form 'seed=12345' \
  --form 'n=1' \
  --form 'response_format=json' \
  --form 'user=user-1234' \
  --form 'metadata=[object Object]'
{
  "id": "id",
  "object": "object",
  "model": "sora-2",
  "status": "status",
  "progress": 1,
  "created_at": 1,
  "seconds": "seconds",
  "completed_at": 1,
  "expires_at": 1,
  "size": "1024x1024",
  "error": {
    "message": "message",
    "code": "code"
  },
  "metadata": {}
}

Documentation Index

Fetch the complete documentation index at: https://docs.elkapi.com/llms.txt

Use this file to discover all available pages before exploring further.

curl --request POST \
  --url 'https://api.elkapi.com/v1/videos' \
  --header 'Authorization: Bearer <token>' \
  --form 'model=sora-2' \
  --form 'prompt=一只小猫在阳光下的花园里奔跑,电影感,高细节' \
  --form 'image=https://example.com/image.png' \
  --form 'duration=5' \
  --form 'width=1280' \
  --form 'height=720' \
  --form 'fps=30' \
  --form 'seed=12345' \
  --form 'n=1' \
  --form 'response_format=json' \
  --form 'user=user-1234' \
  --form 'metadata=[object Object]'
{
  "id": "id",
  "object": "object",
  "model": "sora-2",
  "status": "status",
  "progress": 1,
  "created_at": 1,
  "seconds": "seconds",
  "completed_at": 1,
  "expires_at": 1,
  "size": "1024x1024",
  "error": {
    "message": "message",
    "code": "code"
  },
  "metadata": {}
}

Authorizations

Authorization
string
必填
所有接口均需要使用 Bearer Token 进行认证。在请求头中添加:
Authorization: Bearer YOUR_API_KEY

Body

model
string
默认值:"sora-2"
模型/风格 ID示例:sora-2
prompt
string
文本描述提示词示例:宇航员站起身走了
image
string
图片输入 (URL 或 Base64)示例:https://example.com/image.jpg
duration
number
视频时长(秒)示例:5
width
integer
视频宽度示例:1280
height
integer
视频高度示例:720
fps
integer
视频帧率示例:30
seed
integer
随机种子示例:20231234
n
integer
生成视频数量示例:1
response_format
string
响应格式示例:url
user
string
用户标识示例:user-1234
metadata
object
扩展参数 (如 negative_prompt, style, quality_level 等)

Response

id
string
视频 ID
object
string
对象类型
model
string
默认值:"sora-2"
使用的模型示例:sora-2
status
string
任务状态
progress
integer
进度百分比
created_at
integer
创建时间戳
seconds
string
视频时长
completed_at
integer
完成时间戳
expires_at
integer
过期时间戳
size
string
视频尺寸
error
object
OpenAI 视频错误信息
error.message
string
错误信息
error.code
string
错误码
metadata
object
额外元数据