快速开始（同步 API，暂不可用）

Veo-3.1 旧接入方案故障通知veo-3.1 系列旧接入方案自 2026 年 5 月 14 日起出现故障，当前暂时无法使用。请暂停按本文示例发起新的同步 API 调用，恢复时间以网站公告和控制台通知为准。

寻找更稳定的方案？本页面介绍同步 API（适合快速测试）。如需更稳定的生产环境方案，推荐使用异步 API。

开始之前

获取 API Key

登录老张API控制台创建 API Key

重要: Veo-3.1 模型需要使用按次付费令牌,不支持按量付费令牌。创建令牌时请选择”按次付费”类型。

确保账户余额

确保账户有足够余额,Veo-3.1 模型按次计费($0.15-$0.25/次)

第一个请求

文生视频示例

使用 cURL 快速测试文生视频功能:

curl --location --request POST 'https://api2.laozhang.ai/v1/chat/completions' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer sk-YOUR_API_KEY' \
--data-raw '{
    "messages": [{
        "role": "user",
        "content": [
            {
                "type": "text",
                "text": "生成两只猫和一只狗打架的视频"
            }
        ]
    }],
    "model": "veo-3.1",
    "stream": true,
    "n": 2
}'

参数说明:

model: 选择 veo-3.1 系列模型
stream: 设置为 true 启用流式响应
n: 生成结果数量,这里设置为 2 会生成 2 个不同的视频

图生视频示例

使用图片作为参考生成视频:

# 注意: 同步 API 必须使用 Base64 格式的图片
# 这里仅为示例格式,实际使用时需要将 BASE64_STRING 替换为真实的 Base64 字符串
curl --location --request POST 'https://api2.laozhang.ai/v1/chat/completions' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer sk-YOUR_API_KEY' \
--data-raw '{
    "messages": [{
        "role": "user",
        "content": [
            {
                "type": "text",
                "text": "根据两张图片生成一个完整的过渡视频"
            },
            {
                "type": "image_url",
                "image_url": {
                    "url": "data:image/jpeg;base64,BASE64_STRING_1"
                }
            },
            {
                "type": "image_url",
                "image_url": {
                    "url": "data:image/jpeg;base64,BASE64_STRING_2"
                }
            }
        ]
    }],
    "model": "veo-3.1-fl",
    "stream": true,
    "n": 2
}'

Python 快速示例

安装 OpenAI SDK

pip install openai

文生视频代码

from openai import OpenAI

client = OpenAI(
    api_key="sk-YOUR_API_KEY",
    base_url="https://api2.laozhang.ai/v1"
)

response = client.chat.completions.create(
    model="veo-3.1",
    messages=[{
        "role": "user",
        "content": [
            {
                "type": "text",
                "text": "生成一只可爱的小猫在草地上玩耍的视频"
            }
        ]
    }],
    stream=True,
    n=1
)

{-# JSX注释: 处理流式响应 #-}
for chunk in response:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end='')

图生视频代码

import base64
from openai import OpenAI

# 辅助函数: 编码图片为 Base64
def encode_image(image_path):
    with open(image_path, "rb") as image_file:
        return base64.b64encode(image_file.read()).decode('utf-8')

client = OpenAI(
    api_key="sk-YOUR_API_KEY",
    base_url="https://api2.laozhang.ai/v1"
)

# 读取本地图片
base64_image1 = encode_image("start.jpg")
base64_image2 = encode_image("end.jpg")

response = client.chat.completions.create(
    model="veo-3.1-fl",
    messages=[{
        "role": "user",
        "content": [
            {
                "type": "text",
                "text": "根据图片生成平滑的过渡动画"
            },
            {
                "type": "image_url",
                "image_url": {
                    "url": f"data:image/jpeg;base64,{base64_image1}"
                }
            },
            {
                "type": "image_url",
                "image_url": {
                    "url": f"data:image/jpeg;base64,{base64_image2}"
                }
            }
        ]
    }],
    stream=True
)

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

Node.js 快速示例

安装 OpenAI SDK

npm install openai

基本用法

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: 'sk-YOUR_API_KEY',
  baseURL: 'https://api2.laozhang.ai/v1'
});

async function generateVideo() {
  const stream = await client.chat.completions.create({
    model: 'veo-3.1',
    messages: [{
      role: 'user',
      content: [
        {
          type: 'text',
          text: '生成一个日落时分海边的视频'
        }
      ]
    }],
    stream: true,
    n: 1
  });

  for await (const chunk of stream) {
    const content = chunk.choices[0]?.delta?.content;
    if (content) {
      process.stdout.write(content);
    }
  }
}

generateVideo().catch(console.error);

流式响应处理

Veo-3.1 支持流式响应,可以实时获取生成进度和结果:

Python
Node.js
cURL

response = client.chat.completions.create(
    model="veo-3.1",
    messages=[...],
    stream=True
)

for chunk in response:
    if chunk.choices[0].delta.content:
        content = chunk.choices[0].delta.content
        {-# JSX注释: 这里会收到视频URL或进度信息 #-}
        print(f"收到数据: {content}")

const stream = await client.chat.completions.create({
  model: 'veo-3.1',
  messages: [...],
  stream: true
});

for await (const chunk of stream) {
  const content = chunk.choices[0]?.delta?.content;
  if (content) {
    console.log('收到数据:', content);
  }
}

curl --location --request POST 'https://api2.laozhang.ai/v1/chat/completions' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer sk-YOUR_API_KEY' \
--data-raw '{
    "messages": [{"role": "user", "content": [{"type": "text", "text": "生成视频"}]}],
    "model": "veo-3.1",
    "stream": true
}' \
--no-buffer

图片格式支持

Veo-3.1 支持多种图片输入格式:

Base64 编码 (推荐)

{
  "type": "image_url",
  "image_url": {
    "url": "data:image/jpeg;base64,/9j/4AAQSkZJRg..."
  }
}

注意： 同步 API 必须使用 Base64 编码的图片，不支持 http/https 链接。如需使用 URL 链接，请使用异步 API。

图片要求:

支持格式: JPEG, PNG, WebP
最大尺寸: 10MB
推荐分辨率: 1024x1024 或更高
最多支持: 2张图片(开始帧+结束帧)

常用模型选择

根据你的需求选择合适的模型:

快速测试

推荐: veo-3.1-fast适合快速验证想法,价格成本较低($0.15/次)

标准质量

推荐: veo-3.1平衡质量和成本,适合大多数场景($0.25/次)

图生视频

推荐: veo-3.1-fl基于图片生成视频或过渡动画($0.25/次)

横屏视频

推荐: veo-3.1-landscape专业横屏格式,适合影视制作($0.25/次)

错误处理

from openai import OpenAI, OpenAIError

client = OpenAI(
    api_key="sk-YOUR_API_KEY",
    base_url="https://api2.laozhang.ai/v1"
)

try:
    response = client.chat.completions.create(
        model="veo-3.1",
        messages=[{
            "role": "user",
            "content": [{"type": "text", "text": "生成视频"}]
        }],
        stream=True
    )

    for chunk in response:
        if chunk.choices[0].delta.content:
            print(chunk.choices[0].delta.content)

except OpenAIError as e:
    print(f"API错误: {e}")
except Exception as e:
    print(f"其他错误: {e}")

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: 'sk-YOUR_API_KEY',
  baseURL: 'https://api2.laozhang.ai/v1'
});

try {
  const stream = await client.chat.completions.create({
    model: 'veo-3.1',
    messages: [{
      role: 'user',
      content: [{ type: 'text', text: '生成视频' }]
    }],
    stream: true
  });

  for await (const chunk of stream) {
    const content = chunk.choices[0]?.delta?.content;
    if (content) {
      console.log(content);
    }
  }
} catch (error) {
  if (error instanceof OpenAI.APIError) {
    console.error('API错误:', error.message);
  } else {
    console.error('其他错误:', error);
  }
}

完整示例

查看完整代码示例

包含 Python、Node.js、Go、Java 等多种语言的完整示例代码

下一步

异步 API（推荐）

更稳定的任务队列方式，失败计费以控制台记录为准

代码示例

查看更多编程语言的完整示例

最佳实践

学习如何写出更好的提示词

常见问题

遇到问题?查看解决方案

获取帮助

技术支持

遇到问题?联系技术支持

Telegram 社区

加入社区讨论和交流

产品基础

核心 API

文本 API

视频生成 API

图像生成 API

AI 理解能力

快速开始（同步 API，暂不可用）

开始之前

第一个请求

文生视频示例

图生视频示例

Python 快速示例

安装 OpenAI SDK

文生视频代码

图生视频代码

Node.js 快速示例

安装 OpenAI SDK

基本用法

流式响应处理

图片格式支持

常用模型选择

快速测试

标准质量

图生视频

横屏视频

错误处理

完整示例

查看完整代码示例

下一步

异步 API（推荐）

代码示例

最佳实践

常见问题

获取帮助

技术支持

Telegram 社区

​开始之前

​第一个请求

​文生视频示例

​图生视频示例

​Python 快速示例

​安装 OpenAI SDK

​文生视频代码

​图生视频代码

​Node.js 快速示例

​安装 OpenAI SDK

​基本用法

​流式响应处理

​图片格式支持

​常用模型选择

快速测试

标准质量

图生视频

横屏视频

​错误处理

​完整示例

查看完整代码示例

​下一步

异步 API（推荐）

代码示例

最佳实践

常见问题

​获取帮助

技术支持

Telegram 社区

开始之前

第一个请求

文生视频示例

图生视频示例

Python 快速示例

安装 OpenAI SDK

文生视频代码

图生视频代码

Node.js 快速示例

安装 OpenAI SDK

基本用法

流式响应处理

图片格式支持

常用模型选择

错误处理

完整示例

下一步

获取帮助