> ## Documentation Index
> Fetch the complete documentation index at: https://docs.yelinai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 快速开始（同步 API）

> 5分钟快速上手 Veo-3.1 视频生成同步 API

**寻找更稳定的方案？**本页面介绍**同步 API**（适合快速测试）。如需更稳定的生产环境方案，推荐使用 [异步 API](/api-capabilities/veo/veo-31-async-api)。

## 开始之前

1

获取 API Key

登录 [YeLIn AI控制台](https://api.yelinai.com/token) 创建 API Key

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

2

确保账户余额

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

## 第一个请求

### 文生视频示例

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

```
curl --location --request POST 'https://api.yelinai.com/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.yelinai.com/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://api.yelinai.com/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.yelinai.com/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://api.yelinai.com/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://api.yelinai.com/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](/api-capabilities/veo/veo-31-async-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/次)

## 错误处理

Python

Node.js

```
from openai import OpenAI, OpenAIError

client = OpenAI(
    api_key="sk-YOUR_API_KEY",
    base_url="https://api.yelinai.com/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（推荐）

更稳定的任务队列方式，失败不扣费

## 代码示例

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

## 最佳实践

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

## 常见问题

遇到问题?查看解决方案

## 获取帮助

## 技术支持

遇到问题?联系技术支持

## Telegram 社区

加入社区讨论和交流