Generate File

MCP tool

generate_fileGenerate File

Rate limit

Tier 2

Scope

ai:generate

Project role

OwnerManagerMember

Generates a file with AI.

Info

Check the generated result with Get File.

Example

curl -X POST 'https://api.youvico.com/api/projects/bdbff5de-96d7-468f-9db0-85fe28bd6b62/files/upload.generate' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{ "outputType": "VIDEO", "outputModel": "seedance-2.0", "prompt": "Turn <#FX1234567890ABCD> into a 10-second teaser.", "folder": { "id": "DX1234567890ABCD" }, "attachments": [{ "id": "FX1234567890ABCD" }], "configs": { "durationSeconds": 10, "aspectRatio": "9:16" } }'

{
  "data": {
    "id": "FXABCDEFGHIJKLMN"
  }
}

Request

Path

idstringrequired

Project ID

Body

outputTypestringrequired

Output file type

Possible values: DOCUMENTIMAGEVIDEO3D

Example: VIDEO

outputModelstringrequired

Generation model for outputType

Possible values: pdfmarkdowngpt-image-2.5-flaregpt-image-2gemini-3-pro-imagegemini-3.1-flash-imagegemini-3.1-flash-lite-imageseedance-2.5seedance-2.0seedance-2.0-fastseedance-2.0-minikling-3.0-omnikling-3.0kling-3.0-turbominimax-h3-maxminimax-h3veo-3.1-generate-previewveo-3.1-lite-generate-previewmeshy-7hunyuan3d-3.1

Example: seedance-2.0

promptstringrequired

1-5000 characters

Generation prompt

folderobject?required

Target folder. null for the project root

folder.idstringrequired

Folder ID

Example: DX1234567890ABCD

attachmentsarrayrequired

0-5 items

Reference files

attachments[].idstringrequired

Project file ID (FX) or generation attachment ID (GA)

Example: FX1234567890ABCD

configsobject

Advanced video settings

configs.generateAudioboolean

Whether to generate audio

configs.resolutionstring

Output resolution

configs.durationSecondsnumber

Output length in seconds

Example: 10

configs.aspectRatiostring

Output aspect ratio

Example: 9:16

Response

Returns 202 Accepted.

dataobject

File being generated

data.idstring

ID of the created file

Example: FXABCDEFGHIJKLMN

Models

List Models returns these models with their names and advanced settings.

File type	Model
DOCUMENT	pdf, markdown
IMAGE	gpt-image-2.5-flare, gpt-image-2, gemini-3-pro-image, gemini-3.1-flash-image, gemini-3.1-flash-lite-image
VIDEO	seedance-2.5, seedance-2.0, seedance-2.0-fast, seedance-2.0-mini, kling-3.0-omni, kling-3.0, kling-3.0-turbo, minimax-h3-max, minimax-h3, veo-3.1-generate-preview, veo-3.1-lite-generate-preview
3D	meshy-7, hunyuan3d-3.1

Advanced Settings

Only video models accept configs.

Model	Resolution	Duration (s)	Aspect ratio	Audio
seedance-2.5	480p, 720p, 1080p	4-30	21:9, 16:9, 4:3, 1:1, 3:4, 9:16	Yes
seedance-2.0	480p, 720p, 1080p, 4k	4-15	21:9, 16:9, 4:3, 1:1, 3:4, 9:16	Yes
seedance-2.0-fast	480p, 720p	4-15	21:9, 16:9, 4:3, 1:1, 3:4, 9:16	Yes
seedance-2.0-mini	480p, 720p	4-15	21:9, 16:9, 4:3, 1:1, 3:4, 9:16	Yes
kling-3.0-omni	720p, 1080p	3-15	16:9, 9:16, 1:1	Yes
kling-3.0	720p, 1080p	3-15	16:9, 9:16, 1:1	Yes
kling-3.0-turbo	720p, 1080p	3-15	16:9, 9:16, 1:1	Yes
minimax-h3-max	480p, 768p, 1080p	5-15	21:9, 16:9, 4:3, 1:1, 3:4, 9:16	No
minimax-h3	768p, 2k	5-15	21:9, 16:9, 4:3, 1:1, 3:4, 9:16	No
veo-3.1-generate-preview	720p, 1080p, 4k	8	16:9, 9:16	Yes
veo-3.1-lite-generate-preview	720p, 1080p	8	16:9, 9:16	Yes