- 异步处理模式,返回任务ID用于后续查询
- 支持文本转视频、图生视频(首帧/首尾帧控制)
- 支持标准模式(720P)和专业模式(1080P)
- 专业模式支持自动音频生成和指定音色
请求示例
bash
curl --request POST \
--url https://api.openveer.com/v1/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "kling-v2-6",
"prompt": "一只金色的猫咪在阳光下的草地上奔跑,慢动作,电影质感",
"mode": "std",
"duration": 5,
"aspect_ratio": "16:9"
}'
```python
import requests
url = "https://api.openveer.com/v1/videos/generations"
payload = {
"model": "kling-v2-6",
"prompt": "一只金色的猫咪在阳光下的草地上奔跑,慢动作,电影质感",
"mode": "std",
"duration": 5,
"aspect_ratio": "16:9"
}
headers = {
"Authorization": "Bearer
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())
```
```javascript
const url = "https://api.openveer.com/v1/videos/generations";
const payload = {
model: "kling-v2-6",
prompt: "一只金色的猫咪在阳光下的草地上奔跑,慢动作,电影质感",
mode: "std",
duration: 5,
aspect_ratio: "16:9"
};
const headers = {
"Authorization": "Bearer
"Content-Type": "application/json"
};
fetch(url, {
method: "POST",
headers: headers,
body: JSON.stringify(payload)
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));
```
```go
package main
import (
"bytes"
"encoding/json"
"fmt"
"io/ioutil"
"net/http"
)
func main() {
url := "https://api.openveer.com/v1/videos/generations"
payload := map[string]interface{}{
"model": "kling-v2-6",
"prompt": "一只金色的猫咪在阳光下的草地上奔跑,慢动作,电影质感",
"mode": "std",
"duration": 5,
"aspect_ratio": "16:9",
}
jsonData, _ := json.Marshal(payload)
req, _ := http.NewRequest("POST", url, bytes.NewBuffer(jsonData))
req.Header.Set("Authorization", "Bearer <token>")
req.Header.Set("Content-Type", "application/json")
client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
body, _ := ioutil.ReadAll(resp.Body)
fmt.Println(string(body))
}
```
```java
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;
public class Main {
public static void main(String[] args) throws Exception {
String url = "https://api.openveer.com/v1/videos/generations";
String payload = """
{
"model": "kling-v2-6",
"prompt": "一只金色的猫咪在阳光下的草地上奔跑,慢动作,电影质感",
"mode": "std",
"duration": 5,
"aspect_ratio": "16:9"
}
""";
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create(url))
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.POST(HttpRequest.BodyPublishers.ofString(payload))
.build();
HttpResponse<String> response = client.send(request,
HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
}
}
```
```php
"kling-v2-6",
"prompt" => "一只金色的猫咪在阳光下的草地上奔跑,慢动作,电影质感",
"mode" => "std",
"duration" => 5,
"aspect_ratio" => "16:9"
];
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($payload));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
"Authorization: Bearer
```
```ruby
require 'net/http'
require 'json'
require 'uri'
url = URI("https://api.openveer.com/v1/videos/generations")
payload = {
model: "kling-v2-6",
prompt: "一只金色的猫咪在阳光下的草地上奔跑,慢动作,电影质感",
mode: "std",
duration: 5,
aspect_ratio: "16:9"
}
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = "Bearer
request["Content-Type"] = "application/json"
request.body = payload.to_json
response = http.request(request)
puts response.body
```
```swift
import Foundation
let url = URL(string: "https://api.openveer.com/v1/videos/generations")!
let payload: [String: Any] = [
"model": "kling-v2-6",
"prompt": "一只金色的猫咪在阳光下的草地上奔跑,慢动作,电影质感",
"mode": "std",
"duration": 5,
"aspect_ratio": "16:9"
]
var request = URLRequest(url: url)
request.httpMethod = "POST"
request.setValue("Bearer
request.setValue("application/json", forHTTPHeaderField: "Content-Type")
request.httpBody = try? JSONSerialization.data(withJSONObject: payload)
let task = URLSession.shared.dataTask(with: request) { data, response, error in
if let error = error {
print("Error: (error)")
return
}
if let data = data, let responseString = String(data: data, encoding: .utf8) {
print(responseString)
}
}
task.resume()
```
```csharp
using System;
using System.Net.Http;
using System.Text;
using System.Threading.Tasks;
class Program
{
static async Task Main(string[] args)
{
var url = "https://api.openveer.com/v1/videos/generations";
var payload = @"{
""model"": ""kling-v2-6"",
""prompt"": ""一只金色的猫咪在阳光下的草地上奔跑,慢动作,电影质感"",
""mode"": ""std"",
""duration"": 5,
""aspect_ratio"": ""16:9""
}";
using var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer <token>");
var content = new StringContent(payload, Encoding.UTF8, "application/json");
var response = await client.PostAsync(url, content);
var result = await response.Content.ReadAsStringAsync();
Console.WriteLine(result);
}
}
```
响应示例
json
{
"code": 200,
"data": [
{
"status": "submitted",
"task_id": "task_xxxxxxxxxx"
}
]
}
json
{
"error": {
"code": 400,
"message": "请求参数无效",
"type": "invalid_request_error"
}
}
json
{
"error": {
"code": 401,
"message": "身份验证失败,请检查您的API密钥",
"type": "authentication_error"
}
}
json
{
"error": {
"code": 402,
"message": "账户余额不足,请充值后再试",
"type": "payment_required"
}
}
json
{
"error": {
"code": 429,
"message": "请求过于频繁,请稍后再试",
"type": "rate_limit_error"
}
}
json
{
"error": {
"code": 500,
"message": "服务器内部错误,请稍后重试",
"type": "server_error"
}
}
认证
Authorization string请求参数
model stringprompt stringmode stringduration integeraspect_ratio stringnegative_prompt stringimage_urls stringaudio booleanwatermark boolean功能支持矩阵
| 类型 | 功能 | std 5s | std 10s | pro 5s | pro 10s |
|---|---|---|---|---|---|
| 文生视频 | 视频生成 | ✅(仅无声) | ✅(仅无声) | ✅ | ✅ |
| 文生视频 | 自动音频 | - | - | ✅ | ✅ |
| 图生视频 | 视频生成 | ✅(仅无声) | ✅(仅无声) | ✅ | ✅ |
| 图生视频 | 首帧 | ✅ | ✅ | ✅ | ✅ |
| 图生视频 | 尾帧 | - | - | ✅ | ✅ |
| 图生视频 | 自动音频 | - | - | ✅ | ✅ |
注意:在
pro模式下,尾帧和声音控制不能同时使用,二者互斥。
文生视频 vs 图生视频
系统通过是否传入 image_urls 自动判断模式:不传图片为文生视频,传图片为图生视频。
| 参数 | 文生视频 | 图生视频 |
|---|---|---|
prompt |
✅ 必填 | ✅ 必填 |
image_urls |
❌ 不传 | ✅ 必填(1-2 张,尾帧需 pro) |
negative_prompt |
✅ 可选 | ✅ 可选 |
mode |
✅ 可选 | ✅ 可选 |
duration |
✅ 可选 | ✅ 可选 |
aspect_ratio |
✅ 可选 | ⚠️ 可能被图片比例覆盖 |
audio |
✅ 可选(需 pro) |
✅ 可选(需 pro) |
watermark |
✅ 可选 | ✅ 可选 |
响应
code integerdata arraytask_id string使用场景
场景 1:文生视频(标准模式)
{
"model": "kling-v2-6",
"prompt": "一只金色的猫咪在阳光下的草地上奔跑,慢动作,电影质感",
"mode": "std",
"duration": 5,
"aspect_ratio": "16:9"
}
场景 2:文生视频(专业模式 + 负面提示词)
{
"model": "kling-v2-6",
"prompt": "东京涩谷十字路口,雨夜霓虹灯倒映在湿漉漉的地面上,行人撑伞穿行",
"negative_prompt": "模糊, 低画质, 变形",
"mode": "pro",
"duration": 10,
"aspect_ratio": "16:9"
}
场景 3:图生视频(首帧图片)
{
"model": "kling-v2-6",
"prompt": "让画面中的人物转头微笑",
"image_urls": ["https://example.com/portrait.jpg"],
"mode": "std",
"duration": 5,
"aspect_ratio": "16:9"
}
场景 4:图生视频(首帧 + 尾帧控制)
{
"model": "kling-v2-6",
"prompt": "从白天过渡到黑夜的城市延时摄影",
"image_urls": ["https://example.com/day-city.jpg", "https://example.com/night-city.jpg"],
"mode": "pro",
"duration": 5
}
场景 5:专业模式 + 自动音频
{
"model": "kling-v2-6",
"prompt": "海浪拍打礁石,海鸥在空中盘旋,远处有灯塔",
"mode": "pro",
"duration": 10,
"audio": true,
"aspect_ratio": "16:9"
}