Raw schema
{
"type": "object",
"properties": {
"request": {
"$ref": "#/$defs/RenderRequestPayload",
"description": "Required render request object. Include name. project_mode must be one of scene, music, or custom. Use assets[].purpose for asset intent. Usually include screenplay, instructions, shot_count, duration, and resolution."
},
"upload_urls": {
"anyOf": [
{
"items": {
"anyOf": [
{
"type": "string"
},
{
"$ref": "#/$defs/UploadUrlPayload"
}
]
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional public HTTPS reference asset URLs. Each object can include url and filename; filename should match request.assets[].filename.",
"title": "Upload Urls"
},
"poll_until_complete": {
"default": false,
"title": "Poll Until Complete",
"type": "boolean"
}
},
"required": [
"request"
],
"$defs": {
"RenderAssetPayload": {
"additionalProperties": true,
"properties": {
"filename": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Basename of an uploaded or referenced asset. When upload_urls is used, this must match an upload_urls filename or URL basename.",
"title": "Filename"
},
"label": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Short label for the asset, such as Character, Logo, or Reference.",
"title": "Label"
},
"purpose": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional guidance for how this asset should be used, such as character_reference, location_reference, logo_reference, style_reference, music_reference, or document_reference. Use this field for asset intent.",
"title": "Purpose"
}
},
"title": "RenderAssetPayload",
"type": "object"
},
"RenderRequestPayload": {
"additionalProperties": true,
"properties": {
"name": {
"description": "Required project name for the Future Video Studio render.",
"title": "Name",
"type": "string"
},
"project_mode": {
"default": "scene",
"description": "Render mode: scene for cinematic scenes, music for music-first videos, or custom for advanced requests.",
"enum": [
"scene",
"music",
"custom"
],
"title": "Project Mode",
"type": "string"
},
"screenplay": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Shot-by-shot creative brief or script describing what should happen in the video.",
"title": "Screenplay"
},
"instructions": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Additional direction for continuity, style, camera movement, subtitles, audio, or constraints.",
"title": "Instructions"
},
"shot_count": {
"anyOf": [
{
"maximum": 64,
"minimum": 1,
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Target number of shots or clips to plan for the render.",
"title": "Shot Count"
},
"scene_target_duration_seconds": {
"anyOf": [
{
"maximum": 600,
"minimum": 4,
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"description": "Target total scene duration in seconds.",
"title": "Scene Target Duration Seconds"
},
"video_resolution": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Requested output resolution, such as 720p or 1080p.",
"title": "Video Resolution"
},
"visual_style_preset": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional FVS visual style preset, such as realistic_cinematic.",
"title": "Visual Style Preset"
},
"assets": {
"anyOf": [
{
"items": {
"$ref": "#/$defs/RenderAssetPayload"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional reference assets that correspond to uploaded or public upload_urls.",
"title": "Assets"
}
},
"required": [
"name"
],
"title": "RenderRequestPayload",
"type": "object"
},
"UploadUrlPayload": {
"additionalProperties": true,
"properties": {
"url": {
"description": "Public HTTPS URL for a reference asset.",
"title": "Url",
"type": "string"
},
"filename": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional basename used to match request.assets[].filename.",
"title": "Filename"
}
},
"required": [
"url"
],
"title": "UploadUrlPayload",
"type": "object"
}
},
"title": "fvs_submit_renderArguments"
}