Carica file

Carica file locali su Atlas Cloud per flussi di lavoro da immagine a video, modifica di immagini e altro

Panoramica

Molti flussi di lavoro di generazione IA richiedono file di input — ad esempio, animare un'immagine statica in video, applicare il trasferimento di stile o modificare un'immagine esistente. L'endpoint Carica media ti permette di caricare file locali su Atlas Cloud e ricevere un URL temporaneo che puoi passare agli endpoint di generazione.

Endpoint API

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

Autenticazione

Includi la tua chiave API nell'header Authorization:

Authorization: Bearer your-api-key

Richiesta

Invia il file come richiesta multipart/form-data con il file nel campo file.

Risposta

Restituisce un oggetto JSON con un URL temporaneo per il file caricato.

Esempi di codice

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

Flussi di lavoro comuni

Immagine a video

Carica un'immagine sorgente, poi passa il suo URL a un modello di generazione video:

import requests

# Passo 1: Carica immagine
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")

# Passo 2: Genera video dall'immagine caricata
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}")

Immagine a immagine (trasferimento di stile, miglioramento)

import requests

# Passo 1: Carica immagine sorgente
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")

# Passo 2: Applica trasformazione
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"
    }
)

Note importanti

URL temporanei: I file caricati sono per uso temporaneo con le attivita di generazione di Atlas Cloud. I file possono essere eliminati periodicamente.
Formati supportati: Sono supportati i formati immagine comuni (JPEG, PNG, WebP) e i formati video. Consulta la documentazione del modello specifico per i requisiti di formato.
Dimensione del file: Potrebbero esistere limiti sulla dimensione del file a seconda del modello. Consulta la pagina dei dettagli del modello per limitazioni specifiche.
Usa rapidamente: Usa gli URL dei file caricati nella stessa sessione. Non fare affidamento su di essi per l'archiviazione a lungo termine.

Prossimi passi

Predizioni — Traccia lo stato e i risultati delle attivita di generazione asincrone
Generazione di immagini — Esplora i modelli di generazione di immagini
Generazione di video — Esplora i modelli di generazione di video
Riferimento API — Specifica completa dell'API

In questa pagina