파일 생성

MCP 도구

generate_fileGenerate File

요청 제한

Tier 2

API 권한

ai:generate

프로젝트 역할

소유자관리자멤버

AI로 파일을 생성합니다.

정보

생성 결과는 파일 조회에서 확인할 수 있습니다.

예시

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"
  }
}

요청

경로

idstringrequired

프로젝트 ID

본문

outputTypestringrequired

출력 파일 형식

Possible values: DOCUMENTIMAGEVIDEO3D

Example: VIDEO

outputModelstringrequired

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

생성 프롬프트

folderobject?required

대상 폴더. null이면 프로젝트 루트

folder.idstringrequired

폴더 ID

Example: DX1234567890ABCD

attachmentsarrayrequired

0-5 items

참고 파일

attachments[].idstringrequired

프로젝트 파일 ID(FX) 또는 AI 생성 첨부 ID(GA)

Example: FX1234567890ABCD

configsobject

동영상 고급 설정

configs.generateAudioboolean

오디오 생성 여부

configs.resolutionstring

출력 해상도

configs.durationSecondsnumber

출력 길이(초)

Example: 10

configs.aspectRatiostring

출력 화면 비율

Example: 9:16

응답

202 Accepted를 반환합니다.

dataobject

생성 중인 파일

data.idstring

생성된 파일 ID

Example: FXABCDEFGHIJKLMN

모델

모델 목록은 이 모델들을 이름, 고급 설정과 함께 반환합니다.

파일 유형	모델
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

고급 설정

configs는 동영상 모델만 받습니다.

모델	해상도	길이(초)	화면 비율	오디오
seedance-2.5	480p, 720p, 1080p	4-30	21:9, 16:9, 4:3, 1:1, 3:4, 9:16	예
seedance-2.0	480p, 720p, 1080p, 4k	4-15	21:9, 16:9, 4:3, 1:1, 3:4, 9:16	예
seedance-2.0-fast	480p, 720p	4-15	21:9, 16:9, 4:3, 1:1, 3:4, 9:16	예
seedance-2.0-mini	480p, 720p	4-15	21:9, 16:9, 4:3, 1:1, 3:4, 9:16	예
kling-3.0-omni	720p, 1080p	3-15	16:9, 9:16, 1:1	예
kling-3.0	720p, 1080p	3-15	16:9, 9:16, 1:1	예
kling-3.0-turbo	720p, 1080p	3-15	16:9, 9:16, 1:1	예
minimax-h3-max	480p, 768p, 1080p	5-15	21:9, 16:9, 4:3, 1:1, 3:4, 9:16	아니요
minimax-h3	768p, 2k	5-15	21:9, 16:9, 4:3, 1:1, 3:4, 9:16	아니요
veo-3.1-generate-preview	720p, 1080p, 4k	8	16:9, 9:16	예
veo-3.1-lite-generate-preview	720p, 1080p	8	16:9, 9:16	예