Saltar para o conteúdo principal
Envie arquivos locais para a CDN da plataforma AceDataCloud e obtenha uma URL publicamente acessível (no estilo https://cdn.acedata.cloud/uploads/<uuid>.png), que pode ser imediatamente referenciada em parâmetros como image_url, reference_url e outros de interfaces de negócio (como Midjourney, Suno, Flux). Cenários aplicáveis:
  • Envie primeiro a imagem de referência para a CDN e obtenha uma URL antes de chamar o Midjourney /midjourney/imagine.
  • Armazene em cache o vídeo gerado na etapa anterior para usá-lo como entrada da próxima etapa.
  • Hospede temporariamente os materiais enviados pelos usuários, evitando construir seu próprio S3.
ℹ️ Esta interface pertence à API de gerenciamento da plataforma AceDataCloud, com o prefixo unificado https://platform.acedata.cloud/api/v1/.

Visão geral da interface

Explicação sobre autenticação (como obter o token de conta)

Cabeçalho da solicitação:
Método de obtenção: faça login na plataforma AceDataCloud → Console do Account Token → clique no botão «Criar». Consulte os detalhes em Gerenciar tokens de conta da plataforma AceDataCloud.

Corpo da solicitação (multipart/form-data)

A plataforma gera automaticamente um caminho de arquivo exclusivo e mantém extensões seguras presentes no nome do arquivo enviado; por exemplo, photo.jpg corresponde a uploads/<uuid>.jpg. O tipo MIME fornecido pela parte enviada será gravado nos metadados do arquivo; quando não for fornecido ou for application/octet-stream, a plataforma infere o tipo usando o nome do arquivo e o mapeamento MIME padrão. A inferência da extensão e do MIME não converte o conteúdo do arquivo; certifique-se de que o nome do arquivo corresponda ao formato real.

Exemplos de solicitação

cURL

Python

Node.js

Exemplo de resposta (HTTP 200, trecho)

Basta usar diretamente o campo file_url em outras interfaces de negócio — a URL da CDN é atualmente publicamente acessível e não requer autenticação; não a trate como uma promessa de arquivamento permanente.

Explicação dos campos de resposta

Tratamento de erros

Dicas práticas

  • Enviar imagens como referência: image_urls do Midjourney, image_url do Flux e reference_url do Veo aceitam URLs da CDN e não aceitam base64. Primeiro obter uma URL por meio desta interface é uma operação comum.
  • Não envie dados confidenciais: a URL retornada é publicamente acessível; o período de retenção está sujeito à política de armazenamento atual da plataforma. Para arquivamento de longo prazo, use seu próprio armazenamento de objetos.
  • Envios em grande volume: controle a concorrência e defina um tempo limite para cada envio; a taxa de transferência depende do tamanho do arquivo e do ambiente de rede.

Interfaces relacionadas