파일 업로드
이미지-투-비디오, 이미지 편집 등의 워크플로우를 위해 Atlas Cloud에 로컬 파일 업로드
개요
많은 AI 생성 워크플로우에는 입력 파일이 필요합니다 — 예를 들어 정적 이미지를 동영상으로 애니메이션화하거나, 스타일 변환을 적용하거나, 기존 이미지를 편집하는 경우입니다. 미디어 업로드 엔드포인트를 사용하면 로컬 파일을 Atlas Cloud에 업로드하고 생성 엔드포인트에 전달할 수 있는 임시 URL을 받을 수 있습니다.
API 엔드포인트
POST https://api.atlascloud.ai/api/v1/model/uploadMedia인증
Authorization 헤더에 API 키를 포함하세요:
Authorization: Bearer your-api-key요청
파일을 file 필드에 multipart/form-data 요청으로 전송합니다.
응답
업로드된 파일의 임시 URL이 포함된 JSON 객체를 반환합니다.
코드 예제
Python
import requests
response = requests.post(
"https://api.atlascloud.ai/api/v1/model/uploadMedia",
headers={"Authorization": "Bearer your-api-key"},
files={"file": open("photo.jpg", "rb")}
)
data = response.json()
file_url = data.get("url")
print(f"Uploaded file URL: {file_url}")Node.js
import fs from "fs";
const formData = new FormData();
formData.append("file", new Blob([fs.readFileSync("photo.jpg")]));
const response = await fetch(
"https://api.atlascloud.ai/api/v1/model/uploadMedia",
{
method: "POST",
headers: { Authorization: "Bearer your-api-key" },
body: formData,
}
);
const { url } = await response.json();
console.log(`Uploaded file URL: ${url}`);cURL
curl -X POST https://api.atlascloud.ai/api/v1/model/uploadMedia \
-H "Authorization: Bearer your-api-key" \
-F "[email protected]"일반적인 워크플로우
이미지-투-비디오
소스 이미지를 업로드한 다음 해당 URL을 동영상 생성 모델에 전달합니다:
import requests
# 1단계: 이미지 업로드
upload_resp = requests.post(
"https://api.atlascloud.ai/api/v1/model/uploadMedia",
headers={"Authorization": "Bearer your-api-key"},
files={"file": open("my_image.jpg", "rb")}
)
image_url = upload_resp.json().get("url")
# 2단계: 업로드된 이미지로 동영상 생성
video_resp = requests.post(
"https://api.atlascloud.ai/api/v1/model/generateVideo",
headers={
"Authorization": "Bearer your-api-key",
"Content-Type": "application/json"
},
json={
"model": "kling-v2.0",
"prompt": "The person slowly turns and smiles",
"image_url": image_url
}
)
prediction_id = video_resp.json()["data"]["id"]
print(f"Video generation started: {prediction_id}")이미지-투-이미지 (스타일 변환, 향상)
import requests
# 1단계: 소스 이미지 업로드
upload_resp = requests.post(
"https://api.atlascloud.ai/api/v1/model/uploadMedia",
headers={"Authorization": "Bearer your-api-key"},
files={"file": open("source.jpg", "rb")}
)
image_url = upload_resp.json().get("url")
# 2단계: 변환 적용
result = requests.post(
"https://api.atlascloud.ai/api/v1/model/generateImage",
headers={
"Authorization": "Bearer your-api-key",
"Content-Type": "application/json"
},
json={
"model": "your-image-to-image-model",
"image_url": image_url,
"prompt": "Transform into oil painting style"
}
)중요 사항
- 임시 URL: 업로드된 파일은 Atlas Cloud 생성 작업에 임시로 사용하기 위한 것입니다. 파일은 주기적으로 정리될 수 있습니다.
- 지원 형식: 일반적인 이미지 형식(JPEG, PNG, WebP)과 동영상 형식이 지원됩니다. 형식 요구사항은 특정 모델의 문서를 확인하세요.
- 파일 크기: 모델에 따라 업로드 파일 크기 제한이 있을 수 있습니다. 구체적인 제한사항은 모델 상세 페이지를 참조하세요.
- 신속하게 사용하세요: 업로드된 파일 URL은 같은 세션 내에서 사용하세요. 장기 저장 용도로 의존하지 마세요.