Subir archivos

Sube archivos locales a Atlas Cloud para flujos de trabajo de imagen a video, edición de imágenes y más

Descripción general

Muchos flujos de trabajo de generación de IA requieren archivos de entrada — por ejemplo, animar una imagen estática en un video, aplicar transferencia de estilo o editar una imagen existente. El endpoint Subir archivos multimedia te permite subir archivos locales a Atlas Cloud y recibir una URL temporal que puedes pasar a los endpoints de generación.

Endpoint de la API

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

Autenticación

Incluye tu clave API en el encabezado Authorization:

Authorization: Bearer your-api-key

Solicitud

Envía el archivo como una solicitud multipart/form-data con el archivo en el campo file.

Respuesta

Devuelve un objeto JSON con una URL temporal para el archivo subido.

Ejemplos de código

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

Flujos de trabajo comunes

Imagen a video

Sube una imagen de origen, luego pasa su URL a un modelo de generación de video:

import requests

# Paso 1: Subir imagen
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")

# Paso 2: Generar video a partir de la imagen subida
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}")

Imagen a imagen (transferencia de estilo, mejora)

import requests

# Paso 1: Subir imagen de origen
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")

# Paso 2: Aplicar transformación
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"
    }
)

Notas importantes

URLs temporales: Los archivos subidos son para uso temporal con las tareas de generación de Atlas Cloud únicamente. Los archivos pueden ser eliminados periódicamente.
Formatos compatibles: Se admiten formatos de imagen comunes (JPEG, PNG, WebP) y formatos de video. Consulta la documentación del modelo específico para los requisitos de formato.
Tamaño de archivo: Pueden existir límites en el tamaño del archivo según el modelo. Consulta la página de detalles del modelo para limitaciones específicas.
Usa rápidamente: Usa las URLs de archivos subidos dentro de la misma sesión. No confíes en ellas para almacenamiento a largo plazo.

Próximos pasos

Predicciones — Rastrea el estado y los resultados de las tareas de generación asíncronas
Generación de imágenes — Explora los modelos de generación de imágenes
Generación de videos — Explora los modelos de generación de videos
Referencia API — Especificación completa de la API

En esta página