Dateien hochladen

Laden Sie lokale Dateien zu Atlas Cloud hoch für Bild-zu-Video, Bildbearbeitung und andere Workflows

Überblick

Viele KI-Generierungs-Workflows erfordern Eingabedateien — zum Beispiel das Animieren eines statischen Bildes zu Video, das Anwenden von Stiltransfer oder das Bearbeiten eines vorhandenen Bildes. Der Upload Media-Endpunkt ermöglicht es Ihnen, lokale Dateien zu Atlas Cloud hochzuladen und eine temporäre URL zu erhalten, die Sie an Generierungsendpunkte übergeben können.

API-Endpunkt

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

Authentifizierung

Fügen Sie Ihren API-Schlüssel in den Authorization-Header ein:

Authorization: Bearer your-api-key

Anfrage

Senden Sie die Datei als multipart/form-data-Anfrage mit der Datei im Feld file.

Antwort

Gibt ein JSON-Objekt mit einer temporären URL für die hochgeladene Datei zurück.

Code-Beispiele

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

Häufige Workflows

Bild-zu-Video

Laden Sie ein Quellbild hoch und übergeben Sie dann dessen URL an ein Videogenerierungsmodell:

import requests

# Schritt 1: Bild hochladen
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")

# Schritt 2: Video aus hochgeladenem Bild generieren
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().get("predictionId")
print(f"Video generation started: {prediction_id}")

Bild-zu-Bild (Stiltransfer, Verbesserung)

import requests

# Schritt 1: Quellbild hochladen
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")

# Schritt 2: Transformation anwenden
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"
    }
)

Wichtige Hinweise

Temporäre URLs: Hochgeladene Dateien sind nur für die temporäre Verwendung mit Atlas Cloud-Generierungsaufgaben bestimmt. Dateien können regelmäßig bereinigt werden.
Unterstützte Formate: Gängige Bildformate (JPEG, PNG, WebP) und Videoformate werden unterstützt. Prüfen Sie die Dokumentation des jeweiligen Modells für Formatanforderungen.
Dateigröße: Je nach Modell können Einschränkungen für die Upload-Dateigröße gelten. Auf der Detailseite des Modells finden Sie spezifische Einschränkungen.
Zeitnah verwenden: Verwenden Sie die URLs hochgeladener Dateien innerhalb derselben Sitzung. Verlassen Sie sich nicht auf sie für die Langzeitspeicherung.

Nächste Schritte

Vorhersagen — Status und Ergebnisse asynchroner Generierungsaufgaben verfolgen
Bildgenerierung — Bildgenerierungsmodelle erkunden
Videogenerierung — Videogenerierungsmodelle erkunden
API-Referenz — Vollständige API-Spezifikation

Auf dieser Seite