GET
/v1/schemas/lovable/video/videos
Accept:
Request body
0 properties · 0 required · 0 $defsThis schema isn’t a plain object with properties — showing the raw JSON instead.
application/json
{
"provider": "lovable",
"activity": "video",
"endpointId": "videos",
"kind": "input",
"contentHash": "5e87b4e927bd194c6b9b0775b5452a8b6e5890c3c916b1c9ac79d734d88c5a28",
"specRevision": null,
"provenance": {
"sourceUrl": "https://raw.githubusercontent.com/openai/openai-node/main/api_reference/openapi.transformed.yml",
"sourceHash": "296683cbf5bc5f58b9dd641e06b5fb26b665cd7a828c7e07f5d1a37099770874",
"fetchedAt": 1794979272,
"extractorVersion": "2",
"derivation": "docs-derived",
"verifiedAt": "2026-11-16"
},
"createdAt": 1794979272,
"supersededAt": null,
"schema": {
"description": "Multipart parameters for a video job on the Lovable AI Gateway. Seconds and size depend on the model.",
"discriminator": {
"propertyName": "model",
"mapping": {
"google/gemini-omni-1.1-flash": "#/components/schemas/LovableVideoGoogleGeminiOmni11Flash",
"google/veo-3.1": "#/components/schemas/LovableVideoGoogleVeo31",
"google/veo-3.1-fast": "#/components/schemas/LovableVideoGoogleVeo31Fast",
"google/veo-3.1-lite": "#/components/schemas/LovableVideoGoogleVeo31Lite"
}
},
"oneOf": [
{
"$ref": "#/$defs/LovableVideoGoogleGeminiOmni11Flash"
},
{
"$ref": "#/$defs/LovableVideoGoogleVeo31"
},
{
"$ref": "#/$defs/LovableVideoGoogleVeo31Fast"
},
{
"$ref": "#/$defs/LovableVideoGoogleVeo31Lite"
}
],
"$defs": {
"ImageRefParam-2": {
"properties": {
"image_url": {
"type": "string",
"maxLength": 20971520,
"format": "uri",
"description": "A fully qualified URL or base64-encoded data URL."
},
"file_id": {
"type": "string",
"example": "file-123"
}
},
"type": "object",
"required": []
},
"LovableVideoGoogleGeminiOmni11Flash": {
"type": "object",
"title": "Gemini Omni 1.1 Flash video request",
"description": "Gemini Omni 1.1 Flash (google/gemini-omni-1.1-flash) on the Lovable AI Gateway. 3 to 10 seconds at any of these resolutions.",
"properties": {
"model": {
"type": "string",
"enum": [
"google/gemini-omni-1.1-flash"
],
"description": "Video model id. Fixed to google/gemini-omni-1.1-flash on this request."
},
"prompt": {
"type": "string",
"maxLength": 32000,
"minLength": 1,
"description": "Text prompt that describes the video to generate."
},
"input_reference": {
"anyOf": [
{
"type": "string",
"format": "binary",
"description": "Optional reference asset upload or reference object that guides generation."
},
{
"$ref": "#/$defs/ImageRefParam-2",
"description": "Optional reference asset upload or reference object that guides generation. Provide exactly one of `image_url` or `file_id` when using an object."
}
]
},
"seconds": {
"type": "string",
"enum": [
"3",
"4",
"5",
"6",
"7",
"8",
"9",
"10"
],
"description": "Clip length in seconds. Allowed values: 3, 4, 5, 6, 7, 8, 9, 10. 3 to 10 seconds at any of these resolutions."
},
"size": {
"type": "string",
"enum": [
"640x360",
"360x640",
"1280x720",
"720x1280",
"1920x1080",
"1080x1920",
"3840x2160",
"2160x3840"
],
"description": "Output resolution as width x height. Allowed values: 640x360, 360x640, 1280x720, 720x1280, 1920x1080, 1080x1920, 3840x2160, 2160x3840."
}
},
"required": [
"prompt"
]
},
"LovableVideoGoogleVeo31": {
"type": "object",
"title": "Veo 3.1 video request",
"description": "Veo 3.1 (google/veo-3.1) on the Lovable AI Gateway. 1080p and 4K clips are 8 seconds.",
"properties": {
"model": {
"type": "string",
"enum": [
"google/veo-3.1"
],
"description": "Video model id. Fixed to google/veo-3.1 on this request."
},
"prompt": {
"type": "string",
"maxLength": 32000,
"minLength": 1,
"description": "Text prompt that describes the video to generate."
},
"input_reference": {
"anyOf": [
{
"type": "string",
"format": "binary",
"description": "Optional reference asset upload or reference object that guides generation."
},
{
"$ref": "#/$defs/ImageRefParam-2",
"description": "Optional reference asset upload or reference object that guides generation. Provide exactly one of `image_url` or `file_id` when using an object."
}
]
},
"seconds": {
"type": "string",
"enum": [
"4",
"6",
"8"
],
"description": "Clip length in seconds. Allowed values: 4, 6, 8. 1080p and 4K clips are 8 seconds."
},
"size": {
"type": "string",
"enum": [
"1280x720",
"720x1280",
"1920x1080",
"1080x1920",
"3840x2160",
"2160x3840"
],
"description": "Output resolution as width x height. Allowed values: 1280x720, 720x1280, 1920x1080, 1080x1920, 3840x2160, 2160x3840."
}
},
"required": [
"prompt"
],
"allOf": [
{
"if": {
"properties": {
"size": {
"enum": [
"1920x1080",
"1080x1920",
"3840x2160",
"2160x3840"
]
}
},
"required": [
"size"
]
},
"then": {
"properties": {
"seconds": {
"type": "string",
"enum": [
"8"
],
"description": "1080p and 4K clips are 8 seconds."
}
}
}
}
]
},
"LovableVideoGoogleVeo31Fast": {
"type": "object",
"title": "Veo 3.1 Fast video request",
"description": "Veo 3.1 Fast (google/veo-3.1-fast) on the Lovable AI Gateway. 1080p and 4K clips are 8 seconds.",
"properties": {
"model": {
"type": "string",
"enum": [
"google/veo-3.1-fast"
],
"description": "Video model id. Fixed to google/veo-3.1-fast on this request."
},
"prompt": {
"type": "string",
"maxLength": 32000,
"minLength": 1,
"description": "Text prompt that describes the video to generate."
},
"input_reference": {
"anyOf": [
{
"type": "string",
"format": "binary",
"description": "Optional reference asset upload or reference object that guides generation."
},
{
"$ref": "#/$defs/ImageRefParam-2",
"description": "Optional reference asset upload or reference object that guides generation. Provide exactly one of `image_url` or `file_id` when using an object."
}
]
},
"seconds": {
"type": "string",
"enum": [
"4",
"6",
"8"
],
"description": "Clip length in seconds. Allowed values: 4, 6, 8. 1080p and 4K clips are 8 seconds."
},
"size": {
"type": "string",
"enum": [
"1280x720",
"720x1280",
"1920x1080",
"1080x1920",
"3840x2160",
"2160x3840"
],
"description": "Output resolution as width x height. Allowed values: 1280x720, 720x1280, 1920x1080, 1080x1920, 3840x2160, 2160x3840."
}
},
"required": [
"prompt"
],
"allOf": [
{
"if": {
"properties": {
"size": {
"enum": [
"1920x1080",
"1080x1920",
"3840x2160",
"2160x3840"
]
}
},
"required": [
"size"
]
},
"then": {
"properties": {
"seconds": {
"type": "string",
"enum": [
"8"
],
"description": "1080p and 4K clips are 8 seconds."
}
}
}
}
]
},
"LovableVideoGoogleVeo31Lite": {
"type": "object",
"title": "Veo 3.1 Lite video request",
"description": "Veo 3.1 Lite (google/veo-3.1-lite) on the Lovable AI Gateway. 1080p clips are 8 seconds. 4K is not supported.",
"properties": {
"model": {
"type": "string",
"enum": [
"google/veo-3.1-lite"
],
"description": "Video model id. Fixed to google/veo-3.1-lite on this request."
},
"prompt": {
"type": "string",
"maxLength": 32000,
"minLength": 1,
"description": "Text prompt that describes the video to generate."
},
"input_reference": {
"anyOf": [
{
"type": "string",
"format": "binary",
"description": "Optional reference asset upload or reference object that guides generation."
},
{
"$ref": "#/$defs/ImageRefParam-2",
"description": "Optional reference asset upload or reference object that guides generation. Provide exactly one of `image_url` or `file_id` when using an object."
}
]
},
"seconds": {
"type": "string",
"enum": [
"4",
"6",
"8"
],
"description": "Clip length in seconds. Allowed values: 4, 6, 8. 1080p clips are 8 seconds. 4K is not supported."
},
"size": {
"type": "string",
"enum": [
"1280x720",
"720x1280",
"1920x1080",
"1080x1920"
],
"description": "Output resolution as width x height. Allowed values: 1280x720, 720x1280, 1920x1080, 1080x1920."
}
},
"required": [
"prompt"
],
"allOf": [
{
"if": {
"properties": {
"size": {
"enum": [
"1920x1080",
"1080x1920"
]
}
},
"required": [
"size"
]
},
"then": {
"properties": {
"seconds": {
"type": "string",
"enum": [
"8"
],
"description": "1080p clips are 8 seconds. 4K is not supported."
}
}
}
}
]
}
}
}
}Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"lovable","endpointId":"videos","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}