업로드 시작
POST
https://api.youvico.com/api/projects/:id/generation-attachments/upload.multipart- MCP 도구
- 미지원
- 요청 제한
- Tier 3
- API 권한
- ai:generate
파일 생성에 사용할 참고 파일의 업로드를 시작합니다. API 키나 연결이 속한 워크스페이스의 프로젝트에서만 사용할 수 있습니다. 다른 워크스페이스가 연결한 프로젝트에서는 사용할 수 없습니다.
- 업로드는 시작 후 24시간 안에 완료해야 합니다.
- 첨부는 업로드를 시작한 뒤 23시간 안에 파일 생성에 사용해야 합니다.
- 최근 24시간 동안 업로드를 시작한 첨부는 합계 10 GB까지입니다.
참고
- 파일을 앞에서부터 100,000,000바이트씩 나눕니다. 마지막 파트는 남은 크기만큼입니다.
- 30분 안에 각 파트를 같은
partNumber의url로 PUT 요청해 업로드하고, 응답의ETag헤더 값을 보관합니다. - 모든
partNumber와eTag로 업로드 완료를 호출합니다.
예시
curl -X POST 'https://api.youvico.com/api/projects/bdbff5de-96d7-468f-9db0-85fe28bd6b62/generation-attachments/upload.multipart' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{ "name": "reference.png", "size": 2400000 }'
{
"data": {
"id": "GA1234567890ABCD",
"parts": [
{
"partNumber": 1,
"url": "https://files.youvico.com/upload/eyJhbGciOiJFZERTQSIsImtpZCI6..."
}
]
}
}
요청
curl -X POST 'https://api.youvico.com/api/projects/bdbff5de-96d7-468f-9db0-85fe28bd6b62/generation-attachments/upload.multipart' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"name": "reference.png",
"size": 2400000
}'
응답201 Created
{
"data": {
"id": "GA1234567890ABCD",
"parts": [
{
"partNumber": 1,
"url": "https://files.youvico.com/upload/eyJhbGciOiJFZERTQSIsImtpZCI6..."
}
]
}
}
요청
경로
idstringrequired프로젝트 ID
본문
namestringrequired1-255 characters
첨부 파일 이름
예시: reference.png
sizenumberrequiredInteger, 1-1000000000
첨부 파일 크기(바이트)
예시: 2400000
응답
201 Created를 반환합니다.
dataobject업로드 세션
data.idstring생성된 AI 생성 첨부 ID
예시: GA1234567890ABCD
data.partsarray업로드 파트 목록