跳转到主要内容

​
基础信息

端点： https://api.laozhang.ai/v1/chat/completions带水印端点： https://api.laozhang.ai/v1/chat/completions?watermark=true方法： POST认证： Bearer Token（API Key）内容类型： application/json
10/18 新增：带水印功能默认生成的视频无水印。如需生成带 Sora 原生水印的视频，请在 URL 添加参数 ?watermark=true。

​
认证

在请求头中包含您的 API 密钥： 
Authorization: Bearer YOUR_API_KEY

​
请求格式

​
基础结构

{
  "model": "sora_video2",
  "messages": [
    {
      "role": "user",
      "content": [...]
    }
  ],
  "stream": false
}

​
请求参数

参数类型必需说明
modelstring✓模型名称，见 支持的模型
messagesarray✓消息数组
streamboolean✗是否启用流式输出，默认 false

​
Messages 数组

每个 message 对象包含：
字段类型必需说明
rolestring✓固定为 "user"
contentarray✓内容数组，包含文本或图片

​
Content 数组

支持两种类型的内容：

​
文本内容

{
  "type": "text",
  "text": "视频描述文字"
}
字段类型必需说明
typestring✓固定为 "text"
textstring✓视频生成提示词

​
图片内容（可选）

{
  "type": "image_url",
  "image_url": {
    "url": "https://example.com/image.png"
  }
}
字段类型必需说明
typestring✓固定为 "image_url"
image_url.urlstring✓图片 URL 或 Base64
图片限制
  • 最多 1 张图片
  • 支持 URL 或 Base64 格式
  • 推荐分辨率不超过 2048×2048
  • 不支持真人照片

​
支持的模型

模型名分辨率时长价格
sora_video2704×1280（竖屏）10s$0.15
sora_video2-landscape1280×704（横屏）10s$0.15
sora_video2-15s704×1280（竖屏）15s$0.15
sora_video2-landscape-15s1280×704（横屏）15s$0.15
sora-2-pro-all1024×1792（HD）15s$0.4
价格更新（10/20）15秒模型已降价至 0.15/次，与10秒模型同价！新增高清模型sora−2−pro−all（0.15/次，与10秒模型同价！新增高清模型 sora-2-pro-all（0.4/次）。

​
响应格式

​
非流式响应

{
  "id": "foaicmpl-xxx",
  "object": "chat.completion",
  "created": 1759759480,
  "model": "sora_video2",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "```json\n{\n    \"prompt\": \"...\",\n    \"mode\": \"竖屏模式\"\n}\n```\n\n> ✅ 视频生成成功，[点击这里](https://sora.gptkey.asia/assets/sora/xxx.mp4) 查看视频~~~\n\n"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 17,
    "completion_tokens": 244,
    "total_tokens": 261
  }
}

​
响应字段说明

字段类型说明
idstring请求唯一标识
objectstring对象类型
createdinteger创建时间戳
modelstring使用的模型
choices[].message.contentstring包含视频链接的内容
choices[].finish_reasonstring完成原因，"stop" 表示成功
usageobjectToken 使用统计

​
流式响应（SSE）

启用 "stream": true 时，返回 Server-Sent Events 格式： 
data: {"id":"foaicmpl-xxx","object":"chat.completion.chunk","created":1759759480,"model":"sora_video2","choices":[{"index":0,"delta":{"role":"assistant"},"finish_reason":null}]}

data: {"id":"foaicmpl-xxx","object":"chat.completion.chunk","created":1759759480,"model":"sora_video2","choices":[{"index":0,"delta":{"content":"```json\n{\n    \"prompt\": \"...\"\n}\n```\n\n"},"finish_reason":null}]}

data: {"id":"foaicmpl-xxx","object":"chat.completion.chunk","created":1759759480,"model":"sora_video2","choices":[{"index":0,"delta":{"content":"> ⌛️ 任务正在队列中，请耐心等待...\n\n"},"finish_reason":null}]}

data: {"id":"foaicmpl-xxx","object":"chat.completion.chunk","created":1759759480,"model":"sora_video2","choices":[{"index":0,"delta":{"content":"> 🏃 进度：36.0%\n\n"},"finish_reason":null}]}

data: {"id":"foaicmpl-xxx","object":"chat.completion.chunk","created":1759759480,"model":"sora_video2","choices":[{"index":0,"delta":{"content":"> ✅ 视频生成成功，[点击这里](https://sora.gptkey.asia/assets/sora/xxx.mp4) 查看视频~~~\n\n"},"finish_reason":null}]}

data: {"id":"foaicmpl-xxx","object":"chat.completion.chunk","created":1759759480,"model":"sora_video2","choices":[{"index":0,"delta":{},"finish_reason":"stop"}],"usage":{"prompt_tokens":17,"completion_tokens":244,"total_tokens":261}}

data: [DONE]

​
流式响应字段

字段类型说明
choices[].delta.rolestring角色，仅第一条消息包含
choices[].delta.contentstring增量内容（进度或视频链接）
choices[].finish_reasonstring为 "stop" 时表示完成
usageobject最后一条消息包含使用统计

​
完整示例

​
文生视频

curl -X POST "https://api.laozhang.ai/v1/chat/completions" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora_video2",
    "messages": [
      {
        "role": "user",
        "content": [
          {
            "type": "text",
            "text": "一只可爱的猫咪在阳光明媚的花园里玩球"
          }
        ]
      }
    ]
  }'

​
图生视频（URL）

curl -X POST "https://api.laozhang.ai/v1/chat/completions" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora_video2",
    "messages": [
      {
        "role": "user",
        "content": [
          {
            "type": "text",
            "text": "生成视频：让这个手办形象从桌子上跳出来，变成活人的一个场景~"
          },
          {
            "type": "image_url",
            "image_url": {
              "url": "https://filesystem.site/cdn/download/20250407/OhFd8JofOAJCsNOCsM1Y794qnkNO3L.png"
            }
          }
        ]
      }
    ]
  }'

​
图生视频（Base64）

import openai
import base64

client = openai.OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.laozhang.ai/v1"
)

# 读取本地图片
def encode_image(image_path):
    with open(image_path, "rb") as image_file:
        return base64.b64encode(image_file.read()).decode('utf-8')

base64_image = encode_image("/path/to/image.png")

response = client.chat.completions.create(
    model="sora_video2",
    messages=[
        {
            "role": "user",
            "content": [
                {
                    "type": "text",
                    "text": "让这个场景动起来"
                },
                {
                    "type": "image_url",
                    "image_url": {
                        "url": f"data:image/png;base64,{base64_image}"
                    }
                }
            ]
        }
    ]
)

print(response.choices[0].message.content)

​
流式输出

import openai

client = openai.OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.laozhang.ai/v1"
)

stream = client.chat.completions.create(
    model="sora_video2",
    messages=[
        {
            "role": "user",
            "content": [
                {
                    "type": "text",
                    "text": "一只可爱的猫咪在阳光明媚的花园里玩球"
                }
            ]
        }
    ],
    stream=True
)

for chunk in stream:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end='', flush=True)

​
错误码

HTTP 状态码错误类型说明
400Bad Request请求参数错误
401UnauthorizedAPI Key 无效或未提供
402Payment Required余额不足
429Too Many Requests请求过于频繁
500Internal Server Error服务器内部错误
503Service Unavailable服务暂时不可用

​
错误响应格式

{
  "error": {
    "message": "错误描述",
    "type": "invalid_request_error",
    "code": "invalid_api_key"
  }
}

​
速率限制

目前暂无严格的速率限制，但建议：
  • 批量生成时控制并发数（建议 2-3 个）
  • 避免在短时间内大量请求
  • 合理设置重试间隔

​
最佳实践

视频生成需要 2-4 分钟，建议设置超时时间为 5-10 分钟。
import httpx
import openai

client = openai.OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.laozhang.ai/v1",
    http_client=httpx.Client(timeout=300.0)  # 5分钟
)
添加重试逻辑处理临时错误：
import time

max_retries = 3
for i in range(max_retries):
    try:
        response = client.chat.completions.create(...)
        break
    except Exception as e:
        if i < max_retries - 1:
            print(f"错误，{30}秒后重试...")
            time.sleep(30)
        else:
            raise
生成后立即下载（有效期 1 天）：
import requests
import re

# 提取链接
video_url = re.search(r'https://[^\s\)]+\.mp4', content).group(0)

# 下载
response = requests.get(video_url, stream=True)
with open('video.mp4', 'wb') as f:
    for chunk in response.iter_content(chunk_size=8192):
        f.write(chunk)
使用流式输出实时查看进度：
stream = client.chat.completions.create(
    model="sora_video2",
    messages=[...],
    stream=True
)

for chunk in stream:
    if chunk.choices[0].delta.content:
        content = chunk.choices[0].delta.content
        print(content, end='', flush=True)

​
SDK 支持

​
官方 SDK

  • Python： openai >= 1.0.0
  • Node.js： openai >= 4.0.0

​
第三方 SDK

任何兼容 OpenAI API 格式的 SDK 都可以使用，只需修改 base_url。

​
技术规格

规格值
视频编码H.264
音频编码AAC
帧率24 fps
格式MP4
水印无
音频支持
最大文件大小~50MB（视时长和清晰度而定）

​
下一步

快速开始

查看快速开始指南

使用示例

查看更多代码示例

模型定价

了解模型对比和价格

常见问题

查看常见问题解答