创建 FLUX 3 Video 视频

通过统一的 POST /v1/videos 创建 FLUX 3 Video 视频任务。模型能力以当前 Tikway 网关实际可调用范围为准。

模型	分辨率	时长	支持模式	音频	参考限制
flux-3-video	HD / FHD（统一字段映射 480p/720p → HD，1080p → FHD）	5–20 秒或 auto	文生、1–10 关键帧、视频续写、草稿增强	支持，默认开启	不支持普通音频/视频风格参考

官网能力与当前网关未开放能力之间的差异见本次审计报告。

POST https://api.tikway.ai/v1/videos

cURL

文生视频

curl --request POST \
  --url https://api.tikway.ai/v1/videos \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "flux-3-video",
  "prompt": "一只金毛寻回犬在日落时分的海滩上奔跑，镜头平稳跟随，画面具有自然细腻的电影质感。",
  "duration": 8,
  "resolution": "1080p",
  "aspect_ratio": "16:9",
  "generate_audio": true
}
'

202

{
  "id": "9552de3d-171f-4cca-b492-7baa56523239",
  "status": "pending",
  "polling_url": "https://api.tikway.ai/v1/videos/9552de3d-171f-4cca-b492-7baa56523239"
}

授权

Authorization · string · header · 必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

请求体

application/json

创建 FLUX 3 Video 视频任务。参数按当前 Tikway 网关能力收窄；模型之间的差异见 operation 描述与 x-model-capabilities。

model · enum<string> · 必填

FLUX 3 Video 模型 ID。

可用选项: flux-3-video

prompt · string

视频生成或编辑提示词。

Minimum string length: 1

duration · integer enum<string>

5–20 秒整数，或 auto 让模型按内容决定时长。

必填范围: 5 <= x <= 20

aspect_ratio · enum<string>

视频宽高比。图生视频时，部分模型会按输入素材自动决定比例。

可用选项: auto, 21:9, 2:1, 16:9, 4:3, 1:1, 3:4, 9:16

resolution · enum<string>

输出分辨率。不同模型或模式的可用值见模型能力表。

可用选项: 480p, 720p, 1080p

frame_images · object[]

首帧/尾帧快捷写法。更多普通关键帧可通过 input_references 传 1–10 张 reference_image；指定时间点时使用 role=keyframe 和 seconds。也可在 extra_body.keyframes 中传原生格式。

Maximum array length: 2

Hide child attributes

frame_images. type · enum<string> · 必填

参考帧位置。

可用选项: first_frame, last_frame

frame_images. image_url · string<uri> · 必填

参考图 URL 字符串。

Minimum string length: 1

input_references · object[]

图生视频可传 1–10 张 reference_image 作为普通关键帧，或传带 seconds 的 keyframe 定时关键帧（转换为 [秒数, 图片 URL]）；两种形式不可混用。视频续写必须且只能传 1 个 source_video 或 first_clip。

Maximum array length: 10

Option 1

Option 2

Hide child attributes

input_references. image_url · string<uri> · 必填

图片 URL 字符串。

Minimum string length: 1

input_references. type · enum<string>

可选。素材类型；若提供，必须与对应 URL 字段一致。

可用选项: image_url, video_url

input_references. role · enum<string>

素材用途。省略时按 URL 字段推断为普通参考素材。

可用选项: reference_image, keyframe, source_video, first_clip

input_references. video_url · string<uri>

视频 URL 字符串。

Minimum string length: 1

input_references. seconds · number · 必填 if role = keyframe

role=keyframe 时必填；关键帧在视频中的时间点，单位秒。

必填范围: x >= 0

generate_audio · boolean

是否生成同步音频，默认 true。

callback_url · string<uri>

用户任务回调地址。由 Tikway 在任务状态变化后调用，不直接传给模型上游。

Pattern: ^https://

extra_body · object

FLUX 3 Video 原生扩展参数。

Hide child attributes

extra_body. mode · enum<string>

可用选项: text_to_video, image_to_video, video_to_video, draft_enhance

extra_body. keyframes · string any[]

1–10 张图片，或按 [秒数, 图片 URL] 排列的定时关键帧。

extra_body. start_video · string<uri>

视频续写输入。

extra_body. draft_cache · string

草稿增强所需的缓存 URL 或 Base64。

extra_body. version · enum<string>

可用选项: latest

extra_body. safety_tolerance · integer · 默认值: 2

必填范围: 0 <= x <= 4

extra_body. draft · boolean · 默认值: false

是否先生成低成本 HD 草稿。

响应

202 - application/json

POST /v1/videos 创建视频任务成功后的响应参数，接口返回 HTTP 202。

id · string · 必填

视频生成任务的唯一标识，用于后续查询任务状态。

Minimum string length: 1

示例:

"9552de3d-171f-4cca-b492-7baa56523239"

status · enum<string> · 必填

任务创建状态。pending 表示任务已创建、等待提交处理；queue 表示任务已进入生成队列。

可用选项: pending, queue

示例:

"queue"

polling_url · string<uri> · 必填

视频任务查询地址，客户端可通过 GET 请求轮询任务状态。

Pattern: ^https://

示例:

"https://api.example.com/v1/videos/9552de3d-171f-4cca-b492-7baa56523239"