上傳檔案
上傳本機檔案到 Atlas Cloud，用於圖片轉影片、圖片編輯等工作流程
概覽
許多 AI 生成工作流程需要輸入檔案——例如將靜態圖片轉為影片、套用風格轉換或編輯現有圖片。上傳媒體端點讓您可以將本機檔案上傳到 Atlas Cloud，並取得臨時 URL 傳遞給生成端點。
API 端點
POST https://api.atlascloud.ai/api/v1/model/uploadMedia身份驗證
在 Authorization 標頭中包含您的 API 金鑰：
Authorization: Bearer your-api-key請求
以 multipart/form-data 格式發送請求，將檔案放在 file 欄位中。
回應
回傳包含上傳檔案臨時 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
# 第一步：上傳圖片
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")
# 第二步：從上傳的圖片生成影片
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
# 第一步：上傳來源圖片
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")
# 第二步：套用轉換
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。請勿依賴它們作為長期儲存。