Documentation Index
Fetch the complete documentation index at: https://docs.laozhang.ai/llms.txt
Use this file to discover all available pages before exploring further.
寻找更稳定的方案？本页面介绍同步 API（适合快速测试）。如需更稳定的生产环境方案，推荐使用 异步 API。 开始之前
获取 API Key
登录 老张API控制台 创建 API Key重要: Veo-3.1 模型需要使用按次付费令牌,不支持按量付费令牌。创建令牌时请选择”按次付费”类型。
确保账户余额
确保账户有足够余额,Veo-3.1 模型按次计费(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 个不同的视频
图生视频示例
使用图片作为参考生成视频:
# 注意: 同步 API 必须使用 Base64 格式的图片
# 这里仅为示例格式,实际使用时需要将 BASE64_STRING 替换为真实的 Base64 字符串
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": "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
文生视频代码
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='')
图生视频代码
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://api.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
基本用法
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 支持流式响应,可以实时获取生成进度和结果:
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://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
}' \
--no-buffer
图片格式支持
Veo-3.1 支持多种图片输入格式:
{
"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://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 等多种语言的完整示例代码
下一步
异步 API（推荐）
更稳定的任务队列方式，失败不扣费
获取帮助
