파일 생성
https://api.youvico.com/api/projects/:id/files/upload.generate- MCP 도구
- 미지원
- 요청 제한
- Tier 2
- API 권한
- ai:generate
선택한 생성 모드로 AI 파일을 생성합니다.
AUTO는 프롬프트와 첨부를 분석해 생성 방식을 자동으로 정합니다.configs에 지정한 출력 설정은 그대로 사용합니다.ADVANCED는 보낸 프롬프트와configs대로 생성합니다. 첨부는 모두configs의 첨부 칸에 지정합니다.
ADVANCED에서 모델 규칙상 사용할 수 없는 첨부가 있으면, 에러 응답의 error.details.attachment.id에 그 첨부의 ID를, error.details.reason에 사유를 담아 반환합니다.
API 키나 연결이 속한 워크스페이스의 프로젝트에서만 사용할 수 있습니다. 다른 워크스페이스가 연결한 프로젝트에서는 사용할 수 없습니다.
참고
예시
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 '{ "mode": "ADVANCED", "output": { "type": "VIDEO", "model": "kling-3.0" }, "prompt": "The camera slowly pushes in as the sneaker turns on a turntable.", "folder": { "id": "DX1234567890ABCD" }, "attachments": [{ "id": "GA1234567890ABCD" }], "configs": { "start": "GA1234567890ABCD", "durationSeconds": 10 } }'
{
"data": {
"id": "FXABCDEFGHIJKLMN"
}
}
{
"data": {
"id": "FXABCDEFGHIJKLMN"
}
}
요청
경로
idstringrequired본문
modestringrequired가능한 값: AUTOADVANCED
예시: ADVANCED
outputobjectrequiredoutput.typestringrequired가능한 값: PDFMARKDOWNIMAGEVIDEO3DMUSICTTSSTT
예시: VIDEO
output.modelstringrequired예시: kling-3.0
promptstringrequired0-20000 characters
예시: The camera slowly pushes in as the sneaker turns on a turntable.
folderobject?requiredfolder.idstringrequired예시: DX1234567890ABCD
attachmentsarrayrequired0-50 items, unique IDs
attachments[].idstringrequired예시: GA1234567890ABCD
configsobject참고
ADVANCED는 attachments의 ID를 모두 configs의 첨부 칸에 지정해야 하며, 첨부 칸에 다른 ID를 지정할 수 없습니다.
응답
202 Accepted를 반환합니다.
dataobjectdata.idstring예시: FXABCDEFGHIJKLMN
모델
모델 목록이 모델별 설정 스키마를 반환합니다. 문서 모델(PDF, MARKDOWN)과 음성 모델(TTS, STT)은 ADVANCED만 지원합니다.
| 출력 형식 | 모델 |
|---|---|
PDF | claude-fable-5-2, claude-opus-5-5, claude-sonnet-5-5, claude-haiku-5-5, gpt-6.2-astra, gpt-6-astra, gpt-6.2-sol, gpt-6.1-sol, gpt-6.1-terra, gpt-6-luna, gemini-4-carbon, gemini-4-argon, gemini-4-neon, gemini-4-hydrogen, gemini-3.8-flash |
MARKDOWN | claude-fable-5-2, claude-opus-5-5, claude-sonnet-5-5, claude-haiku-5-5, gpt-6.2-astra, gpt-6-astra, gpt-6.2-sol, gpt-6.1-sol, gpt-6.1-terra, gpt-6-luna, gemini-4-carbon, gemini-4-argon, gemini-4-neon, gemini-4-hydrogen, gemini-3.8-flash |
IMAGE | gpt-image-2.6-flare, gpt-image-2.6-sunburst, gpt-image-2.5-flare, gpt-image-2.5-sunburst, gemini-nano-banana-2.1, gemini-3-pro-image, gemini-3.1-flash-image, gemini-3.1-flash-lite-image, seedream-5.5 |
VIDEO | kling-4.0, kling-4.0-omni, seedance-2.5, seedance-2.0, seedance-2.0-fast, seedance-2.0-mini, kling-3.0, kling-3.0-omni, kling-3.0-turbo, minimax-h3-max, minimax-h3, wan-3.0, wan-3.0-prime, gemini-omni-flash, veo-3.1-generate-preview, veo-3.1-lite-generate-preview |
3D | meshy-7.1, hunyuan3d-3.1 |
MUSIC | lyria-3.5 |
TTS | eleven-v4, eleven-v4-turbo |
STT | mai-transcribe-2, nemotron-3.5-transcribe |
설정
받는 값과 기본값은 모델별 스키마에 있습니다. AUTO에서 보내지 않은 설정은 YouViCo가 정하고, ADVANCED에서는 기본값을 사용합니다.
| 설정 | 설명 |
|---|---|
effort | 생각 수준. 높을수록 오래 생각함 |
aspectRatio | 화면 비율. adaptive는 입력 이미지·동영상의 비율을 따름 |
resolution | 출력 해상도 |
quality | 이미지 품질 |
complexity | 이미지 구상 연산량. 품질과 별개 |
outputFormat | 이미지·오디오·텍스트 파일 형식 |
transparent | 투명 배경 여부. outputFormat이 jpeg이면 false만 가능 |
durationSeconds | 출력 길이(초) |
generateAudio | 소리 생성 여부 |
shouldTexture | 텍스처 적용 여부 |
voice | TTS 목소리 ID. 추천 목록은 스키마의 x-voices |
diarize | STT 화자 구분 여부 |
MUSIC 모델의 설정은 outputFormat뿐입니다. ADVANCED에서는 가사, 길이, 템포, 조성을 프롬프트에 작성합니다.
TTS는 프롬프트를 읽은 음성을 생성합니다. STT는 audio 칸의 오디오를 받아 적으며, 프롬프트는 빈 문자열로 보냅니다.
첨부 칸
첨부 칸은 ADVANCED 스키마에만 있습니다. 모델별 칸과 칸 사이의 규칙은 각 모델의 스키마에서 확인할 수 있습니다.
| 칸 | 설명 |
|---|---|
references | 참조 이미지·동영상·오디오·문서 |
start, end | 시작·끝 프레임 이미지 |
middle | 시작·끝 프레임 사이에 시간 순서대로 넣는 중간 프레임 이미지. start 필수 |
edit | 편집할 동영상. 출력 길이와 비율은 이 동영상을 따름 |
extend | durationSeconds만큼 연장할 동영상 |
motion | 모션 컨트롤. image와 video 필수 |
audio | STT로 받아 적을 오디오 |
images | 3D 입력 이미지. hunyuan3d-3.1은 시점을 키로 한 객체이며 front 필수 |
일부 동영상 모델은 결과에서 피할 내용인 negativePrompt와, 합계가 출력 길이와 같은 prompt·seconds 목록인 멀티 샷 shots도 받습니다.