Beta

업로드 시작

POSThttps://api.youvico.com/api/projects/:id/generation-attachments/upload.multipart
MCP 도구
미지원
요청 제한
Tier 3
API 권한
ai:generate
프로젝트 역할
소유자관리자멤버

파일 생성에 사용할 참고 파일의 업로드를 시작합니다. API 키나 연결이 속한 워크스페이스의 프로젝트에서만 사용할 수 있습니다. 다른 워크스페이스가 연결한 프로젝트에서는 사용할 수 없습니다.

  • 업로드는 시작 후 24시간 안에 완료해야 합니다.
  • 첨부는 업로드를 시작한 뒤 23시간 안에 파일 생성에 사용해야 합니다.
  • 최근 24시간 동안 업로드를 시작한 첨부는 합계 10 GB까지입니다.

참고

  1. 파일을 앞에서부터 100,000,000바이트씩 나눕니다. 마지막 파트는 남은 크기만큼입니다.
  2. 30분 안에 각 파트를 같은 partNumber의 url로 PUT 요청해 업로드하고, 응답의 ETag 헤더 값을 보관합니다.
  3. 모든 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

본문

namestringrequired

1-255 characters

첨부 파일 이름

예시: reference.png

sizenumberrequired

Integer, 1-1000000000

첨부 파일 크기(바이트)

예시: 2400000

응답

201 Created를 반환합니다.

dataobject
업로드 세션
data.idstring
생성된 AI 생성 첨부 ID

예시: GA1234567890ABCD

data.partsarray
업로드 파트 목록