跳转到主要内容

​
开始之前

1

获取 API Key

登录 老张API控制台 创建 API Key
重要: Veo-3.1 模型需要使用按次付费令牌,不支持按量付费令牌。创建令牌时请选择”按次付费”类型。
2

确保账户余额

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

​
第一个请求

​
文生视频示例

使用 cURL 快速测试文生视频功能: 
curl --location --request POST 'https://api.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 个不同的视频

​
图生视频示例

使用图片作为参考生成视频: 
curl --location --request POST 'https://api.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": "https://example.com/start-frame.jpg"
                }
            },
            {
                "type": "image_url",
                "image_url": {
                    "url": "https://example.com/end-frame.jpg"
                }
            }
        ]
    }],
    "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://api.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='')

​
图生视频代码

from openai import OpenAI

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

response = client.chat.completions.create(
    model="veo-3.1-fl",
    messages=[{
        "role": "user",
        "content": [
            {
                "type": "text",
                "text": "根据图片生成平滑的过渡动画"
            },
            {
                "type": "image_url",
                "image_url": {
                    "url": "https://example.com/image1.jpg"
                }
            },
            {
                "type": "image_url",
                "image_url": {
                    "url": "https://example.com/image2.jpg"
                }
            }
        ]
    }],
    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://api.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}")

​
图片格式支持

Veo-3.1 支持多种图片输入格式:
  • URL 引用
  • Base64 编码
{
  "type": "image_url",
  "image_url": {
    "url": "https://example.com/image.jpg"
  }
}
图片要求:
  • 支持格式: 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://api.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}")

​
完整示例

查看完整代码示例

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

​
下一步

代码示例

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

最佳实践

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

常见问题

遇到问题?查看解决方案

​
获取帮助

技术支持

遇到问题?联系技术支持

Telegram 社区

加入社区讨论和交流