4. 从 v1 迁移

GET

/docs/v2/migration

本条目只用于在 Apifox 中展示说明，不对应线上接口，无需请求。

v1 接口继续可用，行为不变，可以按自己的节奏迁移。下表是常见写法的对照。

视频

v1 写法	v2 写法
POST /v1/videos	POST /v2/videos
size="16:9"（比例）	aspect_ratio="16:9"
first_frame_image（文件）	input_reference
last_frame_image（文件）	last_frame
input_reference 传多张参考图	reference_images
metadata.content 里的 video_url / audio_url	reference_videos / reference_audios
metadata.resolution / metadata.ratio	resolution / aspect_ratio
查询结果 status=processing	status=in_progress
查询结果 output.url、metadata.url	video_url

图像

v1 写法	v2 写法
POST /v1/images/generations 里用 image 带参考图	POST /v2/images/edits，参考图放 image
POST /v1/images/edits	POST /v2/images/edits（字段相同，另外支持 JSON 里直接传 URL）
Gemini 原生 POST /v1beta/models/{model}:generateContent	POST /v2/images/generations 或 /v2/images/edits；imageConfig.aspectRatio → aspect_ratio，imageConfig.imageSize → resolution，inlineData 参考图 → image

请求参数

无

请求示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

返回响应

🟢200

application/json

文档说明，无需请求

Bodyapplication/json

示例

{}

修改于 2026-09-30 13:54:50

1. 创建视频任务