Enviar arquivos

Envie arquivos locais ao Atlas Cloud para fluxos de trabalho de imagem para vídeo, edição de imagens e mais

Visão geral

Muitos fluxos de trabalho de geração de IA requerem arquivos de entrada — por exemplo, animar uma imagem estática em vídeo, aplicar transferência de estilo ou editar uma imagem existente. O endpoint Enviar mídia permite enviar arquivos locais ao Atlas Cloud e receber uma URL temporária que você pode passar aos endpoints de geração.

Endpoint da API

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

Autenticação

Inclua sua chave API no cabeçalho Authorization:

Authorization: Bearer your-api-key

Solicitação

Envie o arquivo como uma solicitação multipart/form-data com o arquivo no campo file.

Resposta

Retorna um objeto JSON com uma URL temporária para o arquivo enviado.

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

Fluxos de trabalho comuns

Imagem para vídeo

Envie uma imagem de origem, depois passe sua URL para um modelo de geração de vídeo:

import requests

# Passo 1: Enviar imagem
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: Gerar video a partir da imagem enviada
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}")

Imagem para imagem (transferência de estilo, melhoria)

import requests

# Passo 1: Enviar imagem de origem
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: Aplicar transformacao
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 temporárias: Os arquivos enviados são para uso temporário com as tarefas de geração do Atlas Cloud apenas. Os arquivos podem ser limpos periodicamente.
Formatos suportados: Formatos de imagem comuns (JPEG, PNG, WebP) e formatos de vídeo são suportados. Verifique a documentação do modelo específico para requisitos de formato.
Tamanho do arquivo: Podem existir limites no tamanho do arquivo dependendo do modelo. Consulte a página de detalhes do modelo para limitações específicas.
Use rapidamente: Use as URLs dos arquivos enviados dentro da mesma sessão. Não confie nelas para armazenamento de longo prazo.

Próximos passos

Predições — Acompanhe o status e os resultados das tarefas de geração assíncronas
Geração de imagens — Explore os modelos de geração de imagens
Geração de vídeos — Explore os modelos de geração de vídeos
Referência da API — Especificação completa da API

On this page