From a0807fcb948c3fe5f33e9b8510b80acc9c580630 Mon Sep 17 00:00:00 2001 From: Stan Date: Thu, 13 Aug 2026 00:17:26 +0500 Subject: [PATCH] docs: add blackforestlabs/flux-3-video-v2v --- docs/SUMMARY.md | 1 + docs/api-references/model-database.md | 2 +- .../Black-Forest-Labs/flux-3-video-v2v.json | 237 ++++++++++++++++++ .../Black-Forest-Labs/flux-3-video-v2v.md | 158 ++++++++++++ 4 files changed, 397 insertions(+), 1 deletion(-) create mode 100644 docs/api-references/video-models/Black-Forest-Labs/flux-3-video-v2v.json create mode 100644 docs/api-references/video-models/Black-Forest-Labs/flux-3-video-v2v.md diff --git a/docs/SUMMARY.md b/docs/SUMMARY.md index b059f383..159d4724 100644 --- a/docs/SUMMARY.md +++ b/docs/SUMMARY.md @@ -481,6 +481,7 @@ * [FLUX 3 Video Draft Video to Video](api-references/video-models/Black-Forest-Labs/flux-3-video-draft-v2v.md) * [FLUX 3 Video Image to Video](api-references/video-models/Black-Forest-Labs/flux-3-video-i2v.md) * [FLUX 3 Video Text to Video](api-references/video-models/Black-Forest-Labs/flux-3-video-t2v.md) + * [FLUX 3 Video Video to Video](api-references/video-models/Black-Forest-Labs/flux-3-video-v2v.md) * [ByteDance](api-references/video-models/bytedance/README.md) * [Seedance 1.0 Lite (Image-to-Video)](api-references/video-models/bytedance/seedance-1.0-lite-image-to-video.md) * [Seedance 1.0 Pro (Text-to-Video)](api-references/video-models/bytedance/seedance-1.0-pro-text-to-video.md) diff --git a/docs/api-references/model-database.md b/docs/api-references/model-database.md index c67cb706..b3f1a83b 100644 --- a/docs/api-references/model-database.md +++ b/docs/api-references/model-database.md @@ -55,7 +55,7 @@ Can't find the model you need? Join our [Discord community](https://discord.gg/8 ### Video Models -
Model ID + API Reference linkDeveloperContextModel Card
alibaba/wan2.1-t2v-plusAlibaba CloudWan2.1 Plus
alibaba/wan2.1-t2v-turboAlibaba CloudWan2.1 Turbo
alibaba/wan2.2-t2v-plusAlibaba CloudWan 2.2 T2V
alibaba/wan2.5-t2v-previewAlibaba CloudWan 2.5 Text-to-Video
alibaba/wan2.5-i2v-previewAlibaba CloudWan 2.5 Image-to-Video
alibaba/wan2.2-14b-animate-replaceAlibaba CloudWan 2.2 14b animate replace
alibaba/wan2.2-14b-animate-moveAlibaba CloudWan 2.2 14b animate move
alibaba/wan2.2-vace-fun-a14b-reframeAlibaba CloudWan 2.2 vace fun 14b reframe
alibaba/wan2.2-vace-fun-a14b-outpaintingAlibaba CloudWan 2.2 vace fun 14b outpainting
alibaba/wan2.2-vace-fun-a14b-inpaintingAlibaba CloudWan 2.2 vace fun 14b inpainting
alibaba/wan2.2-vace-fun-a14b-poseAlibaba CloudWan 2.2 vace fun 14b pose
alibaba/wan2.2-vace-fun-14b-depthAlibaba CloudWan 2.2 vace fun 14b depth
alibaba/wan2.5-t2v-previewAlibaba CloudWan 2.5 Preview
alibaba/wan2.5-i2v-previewAlibaba Cloud-
alibaba/wan-2-6-t2vAlibaba CloudWan 2.6 Text-to-Video
alibaba/wan-2-6-i2vAlibaba CloudWan 2.6 Image-to-Video
alibaba/wan-2-6-r2vAlibaba CloudWan 2.6 Reference-to-Video
alibaba/wan-2-6-image-to-video-flashAlibaba CloudWan 2.6 Image-to-Video Flash
alibaba/happyhorse-1-0Alibaba CloudHappy Horse 1.0
alibaba/happyhorse-1.1Alibaba CloudHappy Horse 1.1
alibaba/wan-2-7-t2vAlibaba CloudWan 2.7
alibaba/wan-2-7-i2vAlibaba CloudWan 2.7
alibaba/wan-2-7-r2vAlibaba CloudWan 2.7
bytedance/seedance-1-0-pro-t2vByteDanceSeedance 1.0 Pro
bytedance/seedance-1-0-pro-i2vByteDanceSeedance 1.0 Pro
bytedance/seedance-1-0-pro-fastByteDanceSeedance 1.0 Pro Fast
bytedance/omnihumanByteDanceOmniHuman
bytedance/omnihuman/v1.5ByteDanceOmniHuman v1.5
bytedance/seedance-1-5-proByteDanceSeedance 1.5 Pro
bytedance/seedance-2-0ByteDanceSeedance 2.0
bytedance/seedance-2-5ByteDance-
bytedance/dreamina-seedance-2-5ByteDance-
google/gemini-omni-flash-previewGoogle-
bytedance/dreamina-seedance-2-0-miniByteDanceSeedance 2.0 Mini
bytedance/seedance-2-0-fastByteDanceSeedance 2.0 Fast
veo2GoogleVeo2 Text-to-Video
veo2/image-to-videoGoogleVeo2 Image-to-Video
google/veo3GoogleVeo 3
google/veo-3.0-i2vGoogleVeo 3 I2V
google/veo-3.0-fastGoogleVeo 3 Fast
google/veo-3.0-i2v-fastGoogleVeo 3 I2V Fast
google/veo-3.1-t2vGoogleVeo 3.1 Text-to-Video
google/veo-3.1-t2v-fastGoogleVeo 3.1 Fast Text-to-Video
google/veo-3.1-i2vGoogleVeo 3.1 Image-to-Video
google/veo-3.1-i2v-fastGoogleVeo 3.1 Fast Image-to-Video
google/veo-3.1-reference-to-videoGoogleVeo 3.1 Reference-to-Video
google/veo-3.1-first-last-image-to-videoGoogleVeo 3.1 First-Last Frame-to-Video
google/veo-3.1-first-last-image-to-video-fastGoogleVeo 3.1 Fast First-Last Frame-to-Video
google/veo3-1-extend-videoGoogleVeo 3.1 Extend Video
google/veo3-1-fast-extend-videoGoogleVeo 3.1 Fast Extend Video
google/veo-3-1-lite-generate-previewGoogleVeo 3.1 Lite
google/veo-3.1-lite-generate-001GoogleVeo 3.1 Lite
kling-video/v1/standard/image-to-videoKling AIKling AI (image-to-video)
kling-video/v1/standard/text-to-videoKling AIKling AI (text-to-video)
kling-video/v1/pro/image-to-videoKling AIKling AI (image-to-video)
kling-video/v1/pro/text-to-videoKling AIKling AI (text-to-video)
kling-video/v1.6/standard/text-to-videoKling AIKling 1.6 Standard
kling-video/v1.6/standard/image-to-videoKling AIKling 1.6 Standard
kling-video/v1.6/pro/image-to-videoKling AIKling 1.6 Pro
kling-video/v1.6/pro/text-to-videoKling AIKling 1.6 Pro
klingai/kling-video-v1.6-pro-effectsKling AIKling 1.6 Pro Effects
klingai/kling-video-v1.6-standard-effectsKling AIKling 1.6 Standard Effects
kling-video/v1.6/standard/multi-image-to-videoKling AIKling V1.6 Multi-Image-to-Video
klingai/v2-master-image-to-videoKling AIKling 2.0 Master
klingai/v2-master-text-to-videoKling AIKling 2.0 Master
kling-video/v2.1/standard/image-to-videoKling AIKling V2.1 Standard I2V
kling-video/v2.1/pro/image-to-videoKling AIKling V2.1 Pro I2V
klingai/v2.1-master-image-to-videoKling AIling 2.1 Master
klingai/v2.1-master-text-to-videoKling AIKling 2.1 Master
klingai/v2.5-turbo/pro/image-to-videoKling AIKling Video v2.5 Turbo Pro Image-to-Video
klingai/v2.5-turbo/pro/text-to-videoKling AIKling Video v2.5 Turbo Pro Text-to-Video
klingai/avatar-standardKling AIKling AI Avatar Standard
klingai/avatar-proKling AIKling AI Avatar Pro
klingai/video-v2-6-pro-text-to-videoKling AIKling 2.6 Pro Text-to-Video
klingai/video-v2-6-pro-image-to-videoKling AIKling 2.6 Pro Image-to-Video
klingai/video-o1-image-to-videoKling AIKling Video O1 Image to Video
klingai/video-o1-reference-to-videoKling AIKling Video O1 Reference-to-Video
klingai/video-o1-video-to-video-editKling AIKling Video O1 Video to Video Edit
klingai/video-o1-video-to-video-referenceKling AIKling Video O1 Video-to-Video Reference
klingai/video-v2-6-pro-motion-controlKling AIKling 2.6 Pro Motion Control
klingai/video-v3-standard-text-to-videoKling AIKling Video v3 Standard
klingai/video-v3-standard-image-to-videoKling AIKling Video v3 Standard
klingai/video-v3-pro-text-to-videoKling AIKling Video v3 Pro
klingai/video-v3-pro-image-to-videoKling AIKling Video v3 Pro
klingai/video-v3-turbo-pro-image-to-videoKling AIKling Video V3 Standard Turbo Image to Video
klingai/video-v3-turbo-pro-text-to-videoKling AIKling Video V3 Turbo Pro Text to Video
klingai/video-v3-standard-turbo-text-to-videoKling AIKling Video V3 Standard Turbo Text to Video
klingai/video-v3-turbo-pro-image-to-videoKling AIKling Video V3 Turbo Pro Image to Video
krea/krea-wan-14b/text-to-videoKreaKrea WAN 14B Text-to-Video
krea/krea-wan-14b/video-to-videoKreaKrea WAN 14B Video-to-Video
beeble/switchx-video-to-videoBeeble-
ltxv/ltxv-2LTXVLTXV 2
ltxv/ltxv-2-fastLTXVLTXV 2 Fast
luma/ray-2Luma AIRay 2
luma/ray-flash-2Luma AIRay Flash 2
luma/ray-3.2Luma AI-
magic/text-to-videoMagicMagic Video
magic/image-to-videoMagicMagic Video
magic/video-to-videoMagicMagic Video
video-01MiniMaxMiniMax Video-01
video-01-live2dMiniMax-
minimax/hailuo-02MiniMaxHailuo 02
minimax/h3Minimax AI-
minimax/hailuo-2.3MiniMaxHailuo 2.3
minimax/hailuo-2.3-fastMiniMaxHailuo 2.3 Fast
sora-2-t2vOpenAI-
sora-2-i2vOpenAI-
sora-2-pro-t2vOpenAI-
sora-2-pro-i2vOpenAI-
pixverse/v5/text-to-videoPixVersePixverse v5 Text-to-Video
pixverse/v5/image-to-videoPixVersePixverse v5 Image-to-Video
pixverse/v5/transitionPixVersePixverse v5 Transition
pixverse/v5-5-text-to-videoPixVersePixVerse V5.5 Text-to-Video
pixverse/v5-5-image-to-videoPixVersePixverse v5.5 Image-to-Video
pixverse/lip-syncPixVerse-
gen3a_turboRunwayRunway Gen-3 turbo
runway/gen4_turboRunwayRunway Gen-4 Turbo
runway/gen4_alephRunwayAleph
runway/act_twoRunwayRunway Act Two
sber-ai/kandinsky5-t2vSber AIKandinsky 5 Standard
sber-ai/kandinsky5-distill-t2vSber AIKandinsky 5 Distill
tencent/hunyuan-video-foleyTencentHunyuanVideo Foley
veed/fabric-1.0Veedfabric-1.0
veed/fabric-1.0-fastVeedfabric-1.0-fast
x-ai/grok-imagine-videoxAIGrok Imagine Video
x-ai/grok-imagine-video-1.5-previewxAIGrok Imagine Video 1.5
blackforestlabs/flux-3-video-draft-i2vBlack Forest Labs-
blackforestlabs/flux-3-video-i2vBlack Forest Labs-
blackforestlabs/flux-3-video-draft-t2vBlack Forest Labs-
blackforestlabs/flux-3-video-t2vBlack Forest Labs-
blackforestlabs/flux-3-video-draft-v2vBlack Forest Labs-
+
Model ID + API Reference linkDeveloperContextModel Card
alibaba/wan2.1-t2v-plusAlibaba CloudWan2.1 Plus
alibaba/wan2.1-t2v-turboAlibaba CloudWan2.1 Turbo
alibaba/wan2.2-t2v-plusAlibaba CloudWan 2.2 T2V
alibaba/wan2.5-t2v-previewAlibaba CloudWan 2.5 Text-to-Video
alibaba/wan2.5-i2v-previewAlibaba CloudWan 2.5 Image-to-Video
alibaba/wan2.2-14b-animate-replaceAlibaba CloudWan 2.2 14b animate replace
alibaba/wan2.2-14b-animate-moveAlibaba CloudWan 2.2 14b animate move
alibaba/wan2.2-vace-fun-a14b-reframeAlibaba CloudWan 2.2 vace fun 14b reframe
alibaba/wan2.2-vace-fun-a14b-outpaintingAlibaba CloudWan 2.2 vace fun 14b outpainting
alibaba/wan2.2-vace-fun-a14b-inpaintingAlibaba CloudWan 2.2 vace fun 14b inpainting
alibaba/wan2.2-vace-fun-a14b-poseAlibaba CloudWan 2.2 vace fun 14b pose
alibaba/wan2.2-vace-fun-14b-depthAlibaba CloudWan 2.2 vace fun 14b depth
alibaba/wan2.5-t2v-previewAlibaba CloudWan 2.5 Preview
alibaba/wan2.5-i2v-previewAlibaba Cloud-
alibaba/wan-2-6-t2vAlibaba CloudWan 2.6 Text-to-Video
alibaba/wan-2-6-i2vAlibaba CloudWan 2.6 Image-to-Video
alibaba/wan-2-6-r2vAlibaba CloudWan 2.6 Reference-to-Video
alibaba/wan-2-6-image-to-video-flashAlibaba CloudWan 2.6 Image-to-Video Flash
alibaba/happyhorse-1-0Alibaba CloudHappy Horse 1.0
alibaba/happyhorse-1.1Alibaba CloudHappy Horse 1.1
alibaba/wan-2-7-t2vAlibaba CloudWan 2.7
alibaba/wan-2-7-i2vAlibaba CloudWan 2.7
alibaba/wan-2-7-r2vAlibaba CloudWan 2.7
bytedance/seedance-1-0-pro-t2vByteDanceSeedance 1.0 Pro
bytedance/seedance-1-0-pro-i2vByteDanceSeedance 1.0 Pro
bytedance/seedance-1-0-pro-fastByteDanceSeedance 1.0 Pro Fast
bytedance/omnihumanByteDanceOmniHuman
bytedance/omnihuman/v1.5ByteDanceOmniHuman v1.5
bytedance/seedance-1-5-proByteDanceSeedance 1.5 Pro
bytedance/seedance-2-0ByteDanceSeedance 2.0
bytedance/seedance-2-5ByteDance-
bytedance/dreamina-seedance-2-5ByteDance-
google/gemini-omni-flash-previewGoogle-
bytedance/dreamina-seedance-2-0-miniByteDanceSeedance 2.0 Mini
bytedance/seedance-2-0-fastByteDanceSeedance 2.0 Fast
veo2GoogleVeo2 Text-to-Video
veo2/image-to-videoGoogleVeo2 Image-to-Video
google/veo3GoogleVeo 3
google/veo-3.0-i2vGoogleVeo 3 I2V
google/veo-3.0-fastGoogleVeo 3 Fast
google/veo-3.0-i2v-fastGoogleVeo 3 I2V Fast
google/veo-3.1-t2vGoogleVeo 3.1 Text-to-Video
google/veo-3.1-t2v-fastGoogleVeo 3.1 Fast Text-to-Video
google/veo-3.1-i2vGoogleVeo 3.1 Image-to-Video
google/veo-3.1-i2v-fastGoogleVeo 3.1 Fast Image-to-Video
google/veo-3.1-reference-to-videoGoogleVeo 3.1 Reference-to-Video
google/veo-3.1-first-last-image-to-videoGoogleVeo 3.1 First-Last Frame-to-Video
google/veo-3.1-first-last-image-to-video-fastGoogleVeo 3.1 Fast First-Last Frame-to-Video
google/veo3-1-extend-videoGoogleVeo 3.1 Extend Video
google/veo3-1-fast-extend-videoGoogleVeo 3.1 Fast Extend Video
google/veo-3-1-lite-generate-previewGoogleVeo 3.1 Lite
google/veo-3.1-lite-generate-001GoogleVeo 3.1 Lite
kling-video/v1/standard/image-to-videoKling AIKling AI (image-to-video)
kling-video/v1/standard/text-to-videoKling AIKling AI (text-to-video)
kling-video/v1/pro/image-to-videoKling AIKling AI (image-to-video)
kling-video/v1/pro/text-to-videoKling AIKling AI (text-to-video)
kling-video/v1.6/standard/text-to-videoKling AIKling 1.6 Standard
kling-video/v1.6/standard/image-to-videoKling AIKling 1.6 Standard
kling-video/v1.6/pro/image-to-videoKling AIKling 1.6 Pro
kling-video/v1.6/pro/text-to-videoKling AIKling 1.6 Pro
klingai/kling-video-v1.6-pro-effectsKling AIKling 1.6 Pro Effects
klingai/kling-video-v1.6-standard-effectsKling AIKling 1.6 Standard Effects
kling-video/v1.6/standard/multi-image-to-videoKling AIKling V1.6 Multi-Image-to-Video
klingai/v2-master-image-to-videoKling AIKling 2.0 Master
klingai/v2-master-text-to-videoKling AIKling 2.0 Master
kling-video/v2.1/standard/image-to-videoKling AIKling V2.1 Standard I2V
kling-video/v2.1/pro/image-to-videoKling AIKling V2.1 Pro I2V
klingai/v2.1-master-image-to-videoKling AIling 2.1 Master
klingai/v2.1-master-text-to-videoKling AIKling 2.1 Master
klingai/v2.5-turbo/pro/image-to-videoKling AIKling Video v2.5 Turbo Pro Image-to-Video
klingai/v2.5-turbo/pro/text-to-videoKling AIKling Video v2.5 Turbo Pro Text-to-Video
klingai/avatar-standardKling AIKling AI Avatar Standard
klingai/avatar-proKling AIKling AI Avatar Pro
klingai/video-v2-6-pro-text-to-videoKling AIKling 2.6 Pro Text-to-Video
klingai/video-v2-6-pro-image-to-videoKling AIKling 2.6 Pro Image-to-Video
klingai/video-o1-image-to-videoKling AIKling Video O1 Image to Video
klingai/video-o1-reference-to-videoKling AIKling Video O1 Reference-to-Video
klingai/video-o1-video-to-video-editKling AIKling Video O1 Video to Video Edit
klingai/video-o1-video-to-video-referenceKling AIKling Video O1 Video-to-Video Reference
klingai/video-v2-6-pro-motion-controlKling AIKling 2.6 Pro Motion Control
klingai/video-v3-standard-text-to-videoKling AIKling Video v3 Standard
klingai/video-v3-standard-image-to-videoKling AIKling Video v3 Standard
klingai/video-v3-pro-text-to-videoKling AIKling Video v3 Pro
klingai/video-v3-pro-image-to-videoKling AIKling Video v3 Pro
klingai/video-v3-turbo-pro-image-to-videoKling AIKling Video V3 Standard Turbo Image to Video
klingai/video-v3-turbo-pro-text-to-videoKling AIKling Video V3 Turbo Pro Text to Video
klingai/video-v3-standard-turbo-text-to-videoKling AIKling Video V3 Standard Turbo Text to Video
klingai/video-v3-turbo-pro-image-to-videoKling AIKling Video V3 Turbo Pro Image to Video
krea/krea-wan-14b/text-to-videoKreaKrea WAN 14B Text-to-Video
krea/krea-wan-14b/video-to-videoKreaKrea WAN 14B Video-to-Video
beeble/switchx-video-to-videoBeeble-
ltxv/ltxv-2LTXVLTXV 2
ltxv/ltxv-2-fastLTXVLTXV 2 Fast
luma/ray-2Luma AIRay 2
luma/ray-flash-2Luma AIRay Flash 2
luma/ray-3.2Luma AI-
magic/text-to-videoMagicMagic Video
magic/image-to-videoMagicMagic Video
magic/video-to-videoMagicMagic Video
video-01MiniMaxMiniMax Video-01
video-01-live2dMiniMax-
minimax/hailuo-02MiniMaxHailuo 02
minimax/h3Minimax AI-
minimax/hailuo-2.3MiniMaxHailuo 2.3
minimax/hailuo-2.3-fastMiniMaxHailuo 2.3 Fast
sora-2-t2vOpenAI-
sora-2-i2vOpenAI-
sora-2-pro-t2vOpenAI-
sora-2-pro-i2vOpenAI-
pixverse/v5/text-to-videoPixVersePixverse v5 Text-to-Video
pixverse/v5/image-to-videoPixVersePixverse v5 Image-to-Video
pixverse/v5/transitionPixVersePixverse v5 Transition
pixverse/v5-5-text-to-videoPixVersePixVerse V5.5 Text-to-Video
pixverse/v5-5-image-to-videoPixVersePixverse v5.5 Image-to-Video
pixverse/lip-syncPixVerse-
gen3a_turboRunwayRunway Gen-3 turbo
runway/gen4_turboRunwayRunway Gen-4 Turbo
runway/gen4_alephRunwayAleph
runway/act_twoRunwayRunway Act Two
sber-ai/kandinsky5-t2vSber AIKandinsky 5 Standard
sber-ai/kandinsky5-distill-t2vSber AIKandinsky 5 Distill
tencent/hunyuan-video-foleyTencentHunyuanVideo Foley
veed/fabric-1.0Veedfabric-1.0
veed/fabric-1.0-fastVeedfabric-1.0-fast
x-ai/grok-imagine-videoxAIGrok Imagine Video
x-ai/grok-imagine-video-1.5-previewxAIGrok Imagine Video 1.5
blackforestlabs/flux-3-video-draft-i2vBlack Forest Labs-
blackforestlabs/flux-3-video-i2vBlack Forest Labs-
blackforestlabs/flux-3-video-draft-t2vBlack Forest Labs-
blackforestlabs/flux-3-video-t2vBlack Forest Labs-
blackforestlabs/flux-3-video-draft-v2vBlack Forest Labs-
blackforestlabs/flux-3-video-v2vBlack Forest Labs-
### Voice/Speech Models diff --git a/docs/api-references/video-models/Black-Forest-Labs/flux-3-video-v2v.json b/docs/api-references/video-models/Black-Forest-Labs/flux-3-video-v2v.json new file mode 100644 index 00000000..381ce513 --- /dev/null +++ b/docs/api-references/video-models/Black-Forest-Labs/flux-3-video-v2v.json @@ -0,0 +1,237 @@ +{ + "openapi": "3.0.0", + "info": { + "title": "AIML API", + "version": "1.0.0" + }, + "servers": [ + { + "url": "https://api.aimlapi.com" + } + ], + "paths": { + "/v2/video/generations": { + "post": { + "operationId": "_v2_video_generations", + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "model": { + "type": "string", + "enum": [ + "blackforestlabs/flux-3-video-v2v" + ] + }, + "prompt": { + "type": "string", + "minLength": 1, + "description": "The text prompt describing the video to generate." + }, + "aspect_ratio": { + "type": "string", + "enum": [ + "auto", + "21:9", + "2:1", + "16:9", + "4:3", + "1:1", + "3:4", + "9:16" + ], + "default": "auto", + "description": "The aspect ratio of the generated video. `auto` lets the model pick, and image-to-video follows the first keyframe." + }, + "duration": { + "type": "integer", + "minimum": 5, + "maximum": 20, + "default": 5, + "description": "The video length in whole seconds, from 5 to 20." + }, + "generate_audio": { + "type": "boolean", + "default": true, + "description": "Whether to generate a synchronized audio track. Set to `false` for a silent clip." + }, + "safety_tolerance": { + "type": "integer", + "minimum": 0, + "maximum": 4, + "default": 2, + "description": "The moderation strictness, from 0 (strictest) to 4 (most permissive)." + }, + "video_url": { + "type": "string", + "format": "uri", + "description": "The URL of the video to continue. The generated clip carries on from its final frames." + }, + "resolution": { + "type": "string", + "enum": [ + "hd", + "fhd" + ], + "default": "hd", + "description": "The output resolution of the generated video." + } + }, + "required": [ + "model", + "prompt", + "video_url" + ], + "title": "blackforestlabs/flux-3-video-v2v" + } + } + } + }, + "responses": { + "200": { + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "id": { + "type": "string", + "description": "The ID of the generated video.", + "example": "60ac7c34-3224-4b14-8e7d-0aa0db708325" + }, + "status": { + "type": "string", + "enum": [ + "queued", + "generating", + "completed", + "error" + ], + "description": "The current status of the generation task.", + "example": "completed" + }, + "video": { + "anyOf": [ + { + "type": "object", + "properties": { + "url": { + "type": "string", + "format": "uri", + "description": "The URL where the file can be downloaded from.", + "example": "https://cdn.aimlapi.com/generations/hedgehog/1759866285599-0cdfb138-c03a-49d4-a601-4f6413e27b15.mp4" + } + }, + "required": [ + "url" + ] + }, + { + "type": "array", + "items": { + "type": "object", + "properties": { + "url": { + "type": "string", + "format": "uri", + "description": "The URL where the file can be downloaded from.", + "example": "https://cdn.aimlapi.com/generations/hedgehog/1759866285599-0cdfb138-c03a-49d4-a601-4f6413e27b15.mp4" + } + }, + "required": [ + "url" + ] + } + }, + { + "nullable": true + } + ] + }, + "error": { + "type": "object", + "nullable": true, + "properties": { + "name": { + "type": "string" + }, + "message": { + "type": "string" + } + }, + "required": [ + "name", + "message" + ], + "description": "Description of the error, if any." + }, + "meta": { + "type": "object", + "nullable": true, + "properties": { + "usage": { + "type": "object", + "nullable": true, + "properties": { + "credits_used": { + "type": "number", + "description": "The number of tokens consumed during generation.", + "example": 120000 + }, + "usd_spent": { + "type": "number", + "description": "The total amount of money spent by the user in USD.", + "example": 0.06 + } + }, + "required": [ + "credits_used", + "usd_spent" + ] + } + }, + "description": "Additional details about the generation." + } + }, + "required": [ + "id", + "status" + ] + } + } + }, + "description": "Successful response." + } + }, + "x-hideTryItPanel": true, + "x-codeSamples": [ + { + "lang": "cURL", + "source": "curl --request POST \\\n --url 'https://api.aimlapi.com/v2/video/generations' \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\"model\": \"blackforestlabs/flux-3-video-v2v\", \"prompt\": \"Describe what you want the model to generate.\", \"duration\": 5, \"video_url\": \"https://example.com/input.jpg\"}'" + }, + { + "lang": "JavaScript", + "source": "const response = await fetch('https://api.aimlapi.com/v2/video/generations', {\n method: 'POST',\n headers: {\n 'Authorization': 'Bearer ',\n 'Content-Type': 'application/json',\n },\n body: JSON.stringify({\n \"model\": \"blackforestlabs/flux-3-video-v2v\",\n \"prompt\": \"Describe what you want the model to generate.\",\n \"duration\": 5,\n \"video_url\": \"https://example.com/input.jpg\"\n}),\n});\n\nconsole.log(await response.json());" + }, + { + "lang": "Python", + "source": "import requests\n\nresponse = requests.post(\n \"https://api.aimlapi.com/v2/video/generations\",\n headers={\n \"Authorization\": \"Bearer \",\n \"Content-Type\": \"application/json\",\n },\n json={'model': 'blackforestlabs/flux-3-video-v2v', 'prompt': 'Describe what you want the model to generate.', 'duration': 5, 'video_url': 'https://example.com/input.jpg'},\n)\n\nprint(response.json())" + } + ] + } + } + }, + "components": { + "securitySchemes": { + "access-token": { + "scheme": "bearer", + "bearerFormat": "", + "type": "http", + "description": "Bearer key" + } + } + } +} diff --git a/docs/api-references/video-models/Black-Forest-Labs/flux-3-video-v2v.md b/docs/api-references/video-models/Black-Forest-Labs/flux-3-video-v2v.md new file mode 100644 index 00000000..a43678ae --- /dev/null +++ b/docs/api-references/video-models/Black-Forest-Labs/flux-3-video-v2v.md @@ -0,0 +1,158 @@ +# FLUX 3 Video Video to Video + +{% columns %} +{% column width="66.66666666666666%" %} +{% hint style="info" %} +This documentation is valid for the following list of our models: + +* `blackforestlabs/flux-3-video-v2v` +{% endhint %} +{% endcolumn %} + +{% column width="33.33333333333334%" %} +Try in Playground +{% endcolumn %} +{% endcolumns %} + +## Model Overview + +FLUX 3 Video — a video-to-video model by Black Forest Labs that continues an existing clip from its final frames in hd or fhd, with a synchronized audio track. + +## Setup your API Key + +If you don't have an API key yet, use our [Quickstart guide](https://docs.aimlapi.com/quickstart/setting-up). + +## How to Make a Call + +
+ +Step-by-Step Instructions + +Generating a video involves sequentially calling two endpoints: + +* Create and submit a video generation task. The response contains a generation ID. +* Poll the retrieval endpoint with that generation ID until the status is `completed`. + +
+ +## API Schemas + +### Create a video generation task and send it to the server + +{% openapi-operation spec="flux-3-video-v2v" path="/v2/video/generations" method="post" %} +[OpenAPI flux-3-video-v2v](https://raw.githubusercontent.com/aimlapi/api-docs/refs/heads/main/docs/api-references/video-models/Black-Forest-Labs/flux-3-video-v2v.json) +{% endopenapi-operation %} + +### Retrieve the generated video from the server + +Poll this endpoint with the `generation_id` returned by the submit request. When the status is `completed`, the response includes the generated video URL. + +{% openapi-operation spec="universal-video-endpoint-fetch" path="/v2/video/generations" method="get" %} +[OpenAPI universal-video-endpoint-fetch](https://raw.githubusercontent.com/aimlapi/api-docs/refs/heads/main/docs/api-references/video-models/universal-video-fetch.json) +{% endopenapi-operation %} + +## Code Example + +The examples submit a generation task and poll every **15 seconds** until the final result is available. + +{% tabs %} +{% tab title="Python" %} +{% code overflow="wrap" %} +```python +import requests +import time + +api_key = "" +url = "https://api.aimlapi.com/v2/video/generations" +headers = { + "Authorization": f"Bearer {api_key}", + "Content-Type": "application/json", +} + +generation = requests.post(url, headers=headers, json={'model': 'blackforestlabs/flux-3-video-v2v', 'prompt': 'Describe what you want the model to generate.', 'duration': 5, 'image_url': 'https://example.com/input.jpg'}) +generation.raise_for_status() +generation_id = generation.json()["id"] + +while True: + result = requests.get( + url, + headers=headers, + params={"generation_id": generation_id}, + ) + result.raise_for_status() + data = result.json() + if data.get("status") not in ("queued", "generating"): + print(data) + break + time.sleep(15) +``` +{% endcode %} +{% endtab %} + +{% tab title="JavaScript" %} +{% code overflow="wrap" %} +```javascript +const apiKey = ""; +const url = "https://api.aimlapi.com/v2/video/generations"; +const headers = { + "Authorization": `Bearer ${apiKey}`, + "Content-Type": "application/json", +}; + +const generation = await fetch(url, { + method: "POST", + headers, + body: JSON.stringify({ + "model": "blackforestlabs/flux-3-video-v2v", + "prompt": "Describe what you want the model to generate.", + "duration": 5, + "image_url": "https://example.com/input.jpg" +}), +}); +const { id: generationId } = await generation.json(); + +while (true) { + const response = await fetch( + `${url}?generation_id=${encodeURIComponent(generationId)}`, + { headers }, + ); + const data = await response.json(); + if (!["queued", "generating"].includes(data.status)) { + console.log(data); + break; + } + await new Promise((resolve) => setTimeout(resolve, 15000)); +} +``` +{% endcode %} +{% endtab %} +{% endtabs %} + +
+ +Response + +{% code overflow="wrap" %} +```json +{ + "id": "60ac7c34-3224-4b14-8e7d-0aa0db708325", + "status": "completed", + "video": { + "url": "https://cdn.aimlapi.com/generations/hedgehog/1759866285599-0cdfb138-c03a-49d4-a601-4f6413e27b15.mp4" + }, + "error": { + "name": "", + "message": "" + }, + "meta": { + "usage": { + "credits_used": 120000, + "usd_spent": 0.06 + } + }, + "model": "blackforestlabs/flux-3-video-v2v" +} +``` +{% endcode %} + +