Upload File

Upload file lokal ke Atlas Cloud untuk alur kerja image-to-video, pengeditan gambar, dan lainnya

Ringkasan

Banyak alur kerja pembuatan AI memerlukan file input — misalnya, menganimasikan gambar statis menjadi video, menerapkan transfer gaya, atau mengedit gambar yang ada. Endpoint Upload Media memungkinkan Anda mengupload file lokal ke Atlas Cloud dan menerima URL sementara yang dapat Anda berikan ke endpoint pembuatan.

Endpoint API

POST https://api.atlascloud.ai/api/v1/model/uploadMedia

Autentikasi

Sertakan API key Anda di header Authorization:

Authorization: Bearer your-api-key

Permintaan

Kirim file sebagai permintaan multipart/form-data dengan file di field file.

Respons

Mengembalikan objek JSON dengan URL sementara untuk file yang diupload.

Contoh Kode

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]"

Alur Kerja Umum

Gambar-ke-Video

Upload gambar sumber, lalu berikan URL-nya ke model pembuatan video:

import requests

# Langkah 1: Upload gambar
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")

# Langkah 2: Buat video dari gambar yang diupload
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}")

Gambar-ke-Gambar (Transfer Gaya, Peningkatan)

import requests

# Langkah 1: Upload gambar sumber
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")

# Langkah 2: Terapkan transformasi
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"
    }
)

Catatan Penting

URL Sementara: File yang diupload ditujukan untuk penggunaan sementara dengan tugas pembuatan Atlas Cloud saja. File mungkin dibersihkan secara berkala.
Format yang didukung: Format gambar umum (JPEG, PNG, WebP) dan format video didukung. Periksa dokumentasi model spesifik untuk persyaratan format.
Ukuran file: Mungkin ada batasan ukuran file upload tergantung pada model. Lihat halaman detail model untuk batasan spesifik.
Gunakan segera: Gunakan URL file yang diupload dalam sesi yang sama. Jangan mengandalkannya untuk penyimpanan jangka panjang.

Langkah Selanjutnya

Prediksi — Lacak status dan hasil tugas pembuatan asinkron
Pembuatan Gambar — Jelajahi model pembuatan gambar
Pembuatan Video — Jelajahi model pembuatan video
Referensi API — Spesifikasi API lengkap

On this page