API 레퍼런스미디어
URL로 미디어 가져오기
링크의 이미지나 동영상을 내려받아 워크스페이스 미디어 라이브러리에 넣습니다.
curl -X POST "https://example.com/api/v1/media/imports" \ -H "Content-Type: application/json" \ -d '{ "url": "https://cdn.example.com/photos/launch.png" }'{ "mediaId": "22222222-2222-4222-8222-222222222222", "fileName": "launch.jpg", "mediaType": "IMAGE", "mimeType": "image/jpeg", "fileSize": 412345, "url": "https://media.example.com/launch.jpg", "duration": null, "width": 2160, "height": 1440, "createdAt": "2026-11-08T12:00:00Z"}공개 URL의 이미지나 동영상을 내려받아 API 키의 워크스페이스 미디어 라이브러리에 넣습니다. 소셜 미디어 게시물 같은 웹 페이지가 아니라 파일을 바로 내려받는 링크를 쓰세요. 이미지는 JPEG·PNG·WebP 최대 20 MiB입니다. 8 MiB 이하 JPEG는 그대로 저장하고, 그 밖의 이미지는 긴 변을 2,160픽셀 이하로 줄여 JPEG로 바꿉니다. 동영상은 MP4·QuickTime 최대 200 MiB이며, 더 큰 동영상은 POST /api/v1/media/uploads로 올리세요. Posteady는 공개 주소로 가는 리다이렉트만 따라가고 API 키를 그 URL에 보내지 않습니다. 파일은 업로드 확인과 같은 검사를 거치며 크기는 조직 미디어 저장 공간 한도에 포함됩니다. 응답은 확인된 미디어이므로 바로 발행·예약 요청에 쓸 수 있습니다. 요청할 때마다 새 사본을 저장합니다. 요청 시간이 초과되면 다시 보내기 전에 GET /api/v1/media로 확인하세요.
인증
apiKey 인증Bearer <token>
위치: header
요청 본문
application/json
TypeScript 타입
TypeScript에서 request body 타입을 사용하세요.
응답 본문
application/json
application/json
application/json
application/json