Veo OpenAI 图生视频
提交、查询与下载
- 提交视频并保存 ID:POST https://api.apizt.com/v1/videos,按本页 multipart 表单提交 model、prompt、seconds、size 和参考图文件,保存视频对象的 id。
- 查询任务状态:GET https://api.apizt.com/v1/videos/{id},使用创建返回的完整 id 替换路径参数。GET 不发送 body,等待该 OpenAI 视频格式任务完成。
- 下载视频文件:任务完成后 GET https://api.apizt.com/v1/videos/{id}/content,将视频二进制保存为文件;不要按 JSON 或 choices 解析。
当前目录收录 veo_3_1、veo_3_1-fast、veo_3_1-components,均声明 OpenAI 视频格式。本页保留 veo_3_1 示例;不同型号的参考图、时长与输出限制请分别核对。
本页为 apizt 兼容路由示例,模型可用性以当前平台分组为准。文件名为本地演示文件,请先准备文件并设置令牌。
▼
Authorization
在 Header 添加参数 Authorization,其值为 Bearer 之后拼接 Token
示例:
Authorization: Bearer ********************
概述
请求参数
Header 参数
Content-Type
string
必需
由客户端自动生成 multipart/form-data boundary。
Authorization
string
必需
示例: Bearer $OPENAI_API_KEY
Body 参数 multipart/form-data
multipart/form-data
可选
model
string
必需
现目前只支持veo_3_1 和 veo_3_1-fast,分组选择 限时特价和默认分组 示例:
veo_3_1
可选
prompt
string
可选
提示词 必需 示例: 让牛快乐的跳科目三
seconds
string
可选
时长 必需 示例: 8
input_reference
file
可选
垫图 必需 示例: file://C:\Users\Administrator\Desktop\场景1.png
size
string
必需
720x1280 竖屏 1280x720 横屏 示例: 16x9
watermark
string
可选
示例:
false
可选
请求
示例
请求使用 multipart/form-data。文本字段如下,文件通过 input_reference 上传;不要把本地路径当成文件内容或手动指定没有 boundary 的 Content-Type。
{
"model": "veo_3_1",
"prompt": "让参考图中的主体自然运动",
"seconds": "8",
"size": "1280x720"
}
请求示例代码
curl --fail-with-body --request POST 'https://api.apizt.com/v1/videos' \
--header "Authorization: Bearer ${tokenba_API_KEY}" \
--form 'model=veo_3_1' \
--form 'prompt=让参考图中的主体自然运动' \
--form 'seconds=8' \
--form 'size=1280x720' \
--form '[email protected]'
async function main() {
const headers = { Authorization: "Bearer " + process.env.tokenba_API_KEY };
const { readFile } = require("node:fs/promises");
const body = new FormData();
body.append("model", "veo_3_1");
body.append("prompt", "让参考图中的主体自然运动");
body.append("seconds", "8");
body.append("size", "1280x720");
body.append("input_reference", new Blob([await readFile("reference.png")], { type: "image/png" }), "reference.png");
const response = await fetch("https://api.apizt.com/v1/videos", { method: "POST", headers, body });
const result = await response.text();
if (!response.ok) throw new Error("HTTP " + response.status + ": " + result);
console.log(result);
}
main().catch(console.error);
import okhttp3.*;
import java.io.File;
class Example {
public static void main(String[] args) throws Exception {
OkHttpClient client = new OkHttpClient();
MultipartBody.Builder form = new MultipartBody.Builder().setType(MultipartBody.FORM);
form.addFormDataPart("model", "veo_3_1");
form.addFormDataPart("prompt", "让参考图中的主体自然运动");
form.addFormDataPart("seconds", "8");
form.addFormDataPart("size", "1280x720");
form.addFormDataPart("input_reference", "reference.png", RequestBody.create(MediaType.parse("image/png"), new File("reference.png")));
RequestBody body = form.build();
Request.Builder request = new Request.Builder().url("https://api.apizt.com/v1/videos").header("Authorization", "Bearer " + System.getenv("tokenba_API_KEY"));
request.method("POST", body);
try (Response response = client.newCall(request.build()).execute()) {
if (!response.isSuccessful()) throw new Exception("HTTP " + response.code());
System.out.println(response.body().string());
}
}
}
import Foundation
var request = URLRequest(url: URL(string: "https://api.apizt.com/v1/videos")!)
request.httpMethod = "POST"
request.setValue("Bearer " + ProcessInfo.processInfo.environment["tokenba_API_KEY"]!, forHTTPHeaderField: "Authorization")
let boundary = UUID().uuidString
var data = Data()
func append(_ value: String) { data.append(value.data(using: .utf8)!) }
append("--\(boundary)\r\nContent-Disposition: form-data; name=\"model\"\r\n\r\nveo_3_1\r\n")
append("--\(boundary)\r\nContent-Disposition: form-data; name=\"prompt\"\r\n\r\n让参考图中的主体自然运动\r\n")
append("--\(boundary)\r\nContent-Disposition: form-data; name=\"seconds\"\r\n\r\n8\r\n")
append("--\(boundary)\r\nContent-Disposition: form-data; name=\"size\"\r\n\r\n1280x720\r\n")
append("--\(boundary)\r\nContent-Disposition: form-data; name=\"input_reference\"; filename=\"reference.png\"\r\nContent-Type: image/png\r\n\r\n")
data.append(try Data(contentsOf: URL(fileURLWithPath: "reference.png")))
append("\r\n")
append("--\(boundary)--\r\n")
request.setValue("multipart/form-data; boundary=\(boundary)", forHTTPHeaderField: "Content-Type")
request.httpBody = data
let (data, response) = try await URLSession.shared.data(for: request)
print((response as? HTTPURLResponse)?.statusCode ?? 0)
print(String(data: data, encoding: .utf8) ?? "")
package main
import (
"bytes"
"fmt"
"io"
"net/http"
"os"
"mime/multipart"
)
func main() {
var buffer bytes.Buffer
writer := multipart.NewWriter(&buffer)
if err := writer.WriteField("model", "veo_3_1"); err != nil { panic(err) }
if err := writer.WriteField("prompt", "让参考图中的主体自然运动"); err != nil { panic(err) }
if err := writer.WriteField("seconds", "8"); err != nil { panic(err) }
if err := writer.WriteField("size", "1280x720"); err != nil { panic(err) }
file0, err := os.Open("reference.png")
if err != nil { panic(err) }; defer file0.Close()
part0, err := writer.CreateFormFile("input_reference", "reference.png")
if err != nil { panic(err) }
if _, err = io.Copy(part0, file0); err != nil { panic(err) }
if err := writer.Close(); err != nil { panic(err) }
req, err := http.NewRequest("POST", "https://api.apizt.com/v1/videos", &buffer)
if err != nil { panic(err) }
req.Header.Set("Authorization", "Bearer " + os.Getenv("tokenba_API_KEY"))
req.Header.Set("Content-Type", writer.FormDataContentType())
resp, err := http.DefaultClient.Do(req)
if err != nil { panic(err) }; defer resp.Body.Close()
data, err := io.ReadAll(resp.Body)
if err != nil { panic(err) }
fmt.Println(resp.Status, string(data))
}
<?php
$headers = ["Authorization: Bearer " . getenv("tokenba_API_KEY")];
$body = [
'model' => 'veo_3_1',
'prompt' => '让参考图中的主体自然运动',
'seconds' => '8',
'size' => '1280x720',
'input_reference' => new CURLFile('reference.png'),
];
$curl = curl_init('https://api.apizt.com/v1/videos');
curl_setopt_array($curl, [CURLOPT_CUSTOMREQUEST => 'POST', CURLOPT_HTTPHEADER => $headers, CURLOPT_RETURNTRANSFER => true, CURLOPT_POSTFIELDS => $body]);
$result = curl_exec($curl);
if ($result === false) throw new Exception(curl_error($curl));
echo $result;
curl_close($curl);
import os
import requests
from contextlib import ExitStack
headers = {"Authorization": "Bearer " + os.environ["tokenba_API_KEY"]}
data = {'model': 'veo_3_1', 'prompt': '让参考图中的主体自然运动', 'seconds': '8', 'size': '1280x720'}
with ExitStack() as stack:
files = {
'input_reference': ('reference.png', stack.enter_context(open('reference.png', "rb")), 'image/png'),
}
response = requests.request('POST', 'https://api.apizt.com/v1/videos', headers=headers, data=data, files=files, timeout=120)
response.raise_for_status()
print(response.text)
POST /v1/videos HTTP/1.1
Host: api.apizt.com
Authorization: Bearer YOUR_tokenba_API_KEY
Content-Type: multipart/form-data; boundary=tokenba-demo
--tokenba-demo
Content-Disposition: form-data; name="model"
veo_3_1
--tokenba-demo
Content-Disposition: form-data; name="prompt"
让参考图中的主体自然运动
--tokenba-demo
Content-Disposition: form-data; name="seconds"
8
--tokenba-demo
Content-Disposition: form-data; name="size"
1280x720
--tokenba-demo
Content-Disposition: form-data; name="input_reference"; filename="reference.png"
Content-Type: image/png
< ./reference.png
--tokenba-demo--
#include <curl/curl.h>
#include <stdlib.h>
#include <stdio.h>
int main(void) {
curl_global_init(CURL_GLOBAL_DEFAULT);
CURL *curl = curl_easy_init();
if (!curl) return 1;
char auth[4096];
snprintf(auth, sizeof(auth), "Authorization: Bearer %s", getenv("tokenba_API_KEY"));
struct curl_slist *headers = curl_slist_append(NULL, auth);
curl_mime *mime = curl_mime_init(curl);
curl_mimepart *part;
part = curl_mime_addpart(mime); curl_mime_name(part, "model"); curl_mime_data(part, "veo_3_1", CURL_ZERO_TERMINATED);
part = curl_mime_addpart(mime); curl_mime_name(part, "prompt"); curl_mime_data(part, "让参考图中的主体自然运动", CURL_ZERO_TERMINATED);
part = curl_mime_addpart(mime); curl_mime_name(part, "seconds"); curl_mime_data(part, "8", CURL_ZERO_TERMINATED);
part = curl_mime_addpart(mime); curl_mime_name(part, "size"); curl_mime_data(part, "1280x720", CURL_ZERO_TERMINATED);
part = curl_mime_addpart(mime); curl_mime_name(part, "input_reference"); curl_mime_filedata(part, "reference.png");
curl_easy_setopt(curl, CURLOPT_MIMEPOST, mime);
curl_easy_setopt(curl, CURLOPT_URL, "https://api.apizt.com/v1/videos");
curl_easy_setopt(curl, CURLOPT_CUSTOMREQUEST, "POST");
curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
CURLcode result = curl_easy_perform(curl);
curl_mime_free(mime);
curl_slist_free_all(headers); curl_easy_cleanup(curl); curl_global_cleanup();
return result == CURLE_OK ? 0 : 1;
}
using System;
using System.IO;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;
using var client = new HttpClient();
using var request = new HttpRequestMessage(new HttpMethod("POST"), "https://api.apizt.com/v1/videos");
request.Headers.Authorization = new AuthenticationHeaderValue("Bearer", Environment.GetEnvironmentVariable("tokenba_API_KEY"));
using var form = new MultipartFormDataContent();
form.Add(new StringContent("veo_3_1"), "model");
form.Add(new StringContent("让参考图中的主体自然运动"), "prompt");
form.Add(new StringContent("8"), "seconds");
form.Add(new StringContent("1280x720"), "size");
form.Add(new StreamContent(File.OpenRead("reference.png")), "input_reference", "reference.png");
request.Content = form;
using var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());
#import <Foundation/Foundation.h>
int main(void) {
@autoreleasepool {
dispatch_semaphore_t done = dispatch_semaphore_create(0);
NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:@"https://api.apizt.com/v1/videos"]];
request.HTTPMethod = @"POST";
NSDictionary *env = [[NSProcessInfo processInfo] environment];
[request setValue:[@"Bearer " stringByAppendingString:env[@"tokenba_API_KEY"]] forHTTPHeaderField:@"Authorization"];
NSString *boundary = [[NSUUID UUID] UUIDString];
NSMutableData *data = [NSMutableData data];
[data appendData:[[NSString stringWithFormat:@"--%@\r\nContent-Disposition: form-data; name=\"model\"\r\n\r\nveo_3_1\r\n", boundary] dataUsingEncoding:NSUTF8StringEncoding]];
[data appendData:[[NSString stringWithFormat:@"--%@\r\nContent-Disposition: form-data; name=\"prompt\"\r\n\r\n让参考图中的主体自然运动\r\n", boundary] dataUsingEncoding:NSUTF8StringEncoding]];
[data appendData:[[NSString stringWithFormat:@"--%@\r\nContent-Disposition: form-data; name=\"seconds\"\r\n\r\n8\r\n", boundary] dataUsingEncoding:NSUTF8StringEncoding]];
[data appendData:[[NSString stringWithFormat:@"--%@\r\nContent-Disposition: form-data; name=\"size\"\r\n\r\n1280x720\r\n", boundary] dataUsingEncoding:NSUTF8StringEncoding]];
[data appendData:[[NSString stringWithFormat:@"--%@\r\nContent-Disposition: form-data; name=\"input_reference\"; filename=\"reference.png\"\r\nContent-Type: image/png\r\n\r\n", boundary] dataUsingEncoding:NSUTF8StringEncoding]];
[data appendData:[NSData dataWithContentsOfFile:@"reference.png"]];
[data appendData:[@"\r\n" dataUsingEncoding:NSUTF8StringEncoding]];
[data appendData:[[NSString stringWithFormat:@"--%@--\r\n", boundary] dataUsingEncoding:NSUTF8StringEncoding]];
[request setValue:[@"multipart/form-data; boundary=" stringByAppendingString:boundary] forHTTPHeaderField:@"Content-Type"];
request.HTTPBody = data;
[[[NSURLSession sharedSession] dataTaskWithRequest:request completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {
if (error) { NSLog(@"%@", error); dispatch_semaphore_signal(done); return; }
NSLog(@"%@", [[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding]);
dispatch_semaphore_signal(done);
}] resume];
dispatch_semaphore_wait(done, DISPATCH_TIME_FOREVER);
}
return 0;
}
require "net/http"
require "json"
uri = URI("https://api.apizt.com/v1/videos")
request = Net::HTTPGenericRequest.new("POST", true, true, uri.request_uri)
request["Authorization"] = "Bearer " + ENV.fetch("tokenba_API_KEY")
files = []
begin
fields = [["model", "veo_3_1"], ["prompt", "让参考图中的主体自然运动"], ["seconds", "8"], ["size", "1280x720"]]
file = File.open("reference.png", "rb"); files << file; fields << ["input_reference", file]
request.set_form(fields, "multipart/form-data")
puts Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |http| http.request(request).body }
ensure
files.each(&:close)
end
open Lwt.Infix
let () =
let headers = Cohttp.Header.init_with "Authorization" ("Bearer " ^ Sys.getenv "tokenba_API_KEY") in
let data = "--tokenba-demo\r\nContent-Disposition: form-data; name=\"model\"\r\n\r\nveo_3_1\r\n" ^
"--tokenba-demo\r\nContent-Disposition: form-data; name=\"prompt\"\r\n\r\n让参考图中的主体自然运动\r\n" ^
"--tokenba-demo\r\nContent-Disposition: form-data; name=\"seconds\"\r\n\r\n8\r\n" ^
"--tokenba-demo\r\nContent-Disposition: form-data; name=\"size\"\r\n\r\n1280x720\r\n" ^
"--tokenba-demo\r\nContent-Disposition: form-data; name=\"input_reference\"; filename=\"reference.png\"\r\nContent-Type: image/png\r\n\r\n" ^
(let f = open_in_bin "reference.png" in let data = really_input_string f (in_channel_length f) in close_in f; data) ^
"\r\n" ^
"--tokenba-demo--\r\n" in
let headers = Cohttp.Header.add headers "Content-Type" "multipart/form-data; boundary=tokenba-demo" in
Lwt_main.run (
Cohttp_lwt_unix.Client.call ~headers ~body:(Cohttp_lwt.Body.of_string data) `POST (Uri.of_string "https://api.apizt.com/v1/videos") >>= fun (_, body) ->
Cohttp_lwt.Body.to_string body >|= print_endline
)
import "dart:io";
import "package:http/http.dart" as http;
Future<void> main() async {
final headers = {"Authorization": "Bearer ${Platform.environment['tokenba_API_KEY']}"};
final request = http.MultipartRequest("POST", Uri.parse("https://api.apizt.com/v1/videos"));
request.headers.addAll(headers);
request.fields["model"] = "veo_3_1";
request.fields["prompt"] = "让参考图中的主体自然运动";
request.fields["seconds"] = "8";
request.fields["size"] = "1280x720";
request.files.add(await http.MultipartFile.fromPath("input_reference", "reference.png"));
final response = await request.send();
print(response.statusCode);
print(await response.stream.bytesToString());
}
library(httr)
headers <- c(Authorization = paste("Bearer", Sys.getenv("tokenba_API_KEY")))
body <- list(
model = "veo_3_1",
prompt = "让参考图中的主体自然运动",
seconds = "8",
size = "1280x720",
input_reference = upload_file("reference.png")
)
response <- VERB("POST", "https://api.apizt.com/v1/videos", add_headers(.headers = headers), body = body, encode = "multipart")
stop_for_status(response)
cat(content(response, "text", encoding = "UTF-8"))
返回响应
以下为返回结构示意,标识符与状态为演示值;以实际网关返回为准。
响应参数 🟢 200 OK · application/json
id
string
必需
{
"id": "YOUR_VIDEO_ID",
"object": "video",
"model": "veo_3_1",
"status": "queued",
"progress": 0,
"seconds": "8",
"size": "1280x720"
}
object
string
必需
model
string
必需
status
string
必需
progress
integer
必需
created_at
integer
必需
seconds
string
必需
size
string
必需
{ "id": "video_55cb73b3-60af-40c8-95fd-eae8fd758ade", "object": "video", "model": "veo_3_1", "status": "queued", "progress": 0, "created_at": 1762336916, "seconds": "8", "size": "16x9" }
常见错误
- 401 认证失败:检查 API Key 是否正确
- 429 请求限流:降低调用频率或升级套餐
- 500 服务器错误:稍后重试
注意事项
- 请确保 API Key 有足够的余额
- 请求频率受 API 限制,请参考价格页面
代码示例先设置 tokenba_API_KEY 为你的令牌;示例中的文件名和资源 ID 请替换为自己的值。JavaScript 使用 Node.js 20+,Python 先安装 requests;Java 使用 OkHttp,C 使用 libcurl,OCaml 使用 cohttp-lwt-unix,Dart 使用 http,R 使用 httr。HTTP 文件行采用支持文件引用的 HTTP 客户端语法。
当前模型与版本
依据 apizt 价格页,同步于 。以下型号按目录声明的协议与本页用途筛选;不代表所有参数和功能通用。切换前请核对型号说明、令牌分组与参数差异。Gemini 原生接口需同时替换 URL 中的模型 ID。
| 模型 ID | 能力标签 | 支持分组 |
|---|---|---|
veo_3_1-fast | 异步,视频,首尾帧 | 分组(1)
|
veo_3_1-components | 异步,视频,参考生视频 | 分组(1)
|
veo_3_1 | 异步,视频,首尾帧 | 分组(1)
|
共列入 3 个候选型号。查看完整模型、版本与接口目录。