Atlas Cloud Media

Visão Geral

Use a API assíncrona de mídia da Atlas Cloud para gerar imagens ou vídeos. Esta skill, que usa apenas o código fonte, descreve a descoberta de modelos, validação de schema, submissão de tarefas, polling limitado e recuperação segura de saídas; ela não inclui um SDK, executável ou runtime hospedado.

Quando Usar Esta Skill

• Use quando o usuário solicitar explicitamente a geração de uma imagem ou vídeo com a Atlas Cloud.
• Use quando um fluxo de trabalho existente precisar de uma solicitação de geração de imagem ou vídeo da Atlas Cloud e puder fazer chamadas HTTPS.
• Use quando parâmetros específicos do modelo precisarem ser descobertos antes da submissão.
• Não use esta skill para chat de texto compatível com OpenAI; essa API tem um URL base e contrato diferentes.

Pré-requisitos

1. Confirme se o usuário está autorizado a enviar o prompt e qualquer mídia de referência para um serviço de terceiros.
2. Explique que a geração é paga e obtenha aprovação antes de submeter uma solicitação faturável.
3. Exija que ATLASCLOUD_API_KEY esteja presente no ambiente. Nunca peça ao usuário para colar isso no chat, arquivos de origem, histórico de comandos ou logs.
4. Confirme o diretório de saída e se o usuário deseja geração de imagem, geração de vídeo ou ambos.

Contrato da API

As solicitações de geração e consulta usam estes cabeçalhos:

Authorization: Bearer $ATLASCLOUD_API_KEY
Content-Type: application/json

O catálogo de modelos é público. Cada entrada do catálogo inclui um URL de schema; obtenha esse schema e valide os parâmetros contra ele antes de enviar uma solicitação faturável. Não adivinhe parâmetros de outro modelo, pois nomes como size, ratio, aspect_ratio, image e image_url são específicos do modelo.

Fluxo de Trabalho

0. Criar um Espaço de Trabalho Privado por Execução

Execute os trechos de shell restantes na mesma sessão de shell. Crie um diretório privado antes de escrever prompts, respostas, IDs de predição ou URLs assinados; a expansão de parâmetros nas etapas posteriores falhará se essa configuração for pulada.

umask 077
atlas_tmp_dir=$(mktemp -d "${TMPDIR:-/tmp}/atlas-cloud-media.XXXXXXXX") || exit 1
chmod 700 -- "$atlas_tmp_dir"
trap 'rm -rf -- "$atlas_tmp_dir"' EXIT

1. Descobrir e Validar um Modelo

Obtenha o catálogo, filtre por type (Image ou Video) e corresponda à capacidade solicitada pelo usuário. Leia o schema da entrada selecionada, verifique se todos os campos necessários estão presentes e mostre o modelo e a ação faturável ao usuário antes da submissão.

Exemplo de solicitação de descoberta:

curl --fail --silent --show-error \
  "https://api.atlascloud.ai/api/v1/models" \
  --output "${atlas_tmp_dir:?run private workspace setup first}/models.json"

jq -r '.data[] | select(.type == "Image") | [.model, .displayName, .schema] | @tsv' \
  "$atlas_tmp_dir/models.json"

2. Submeter Uma Tarefa de Geração

Construa o corpo JSON em um arquivo para que a cotação seja determinística e os detalhes da solicitação possam ser revisados sem expor a chave da API.

Exemplo de imagem usando um modelo confirmado pelo catálogo:

jq -n \
  --arg model "qwen-image-3.0/text-to-image" \
  --arg prompt "A paper-cut city map in blue and white, clean editorial style" \
  '{model: $model, prompt: $prompt, size: "1024*1024", n: 1}' \
  > "${atlas_tmp_dir:?run private workspace setup first}/request.json"

curl --fail --silent --show-error \
  --request POST \
  "https://api.atlascloud.ai/api/v1/model/generateImage" \
  --header "Authorization: Bearer $ATLASCLOUD_API_KEY" \
  --header "Content-Type: application/json" \
  --data @"$atlas_tmp_dir/request.json" \
  --output "$atlas_tmp_dir/submit.json"

Exemplo de vídeo usando um modelo confirmado pelo catálogo:

jq -n \
  --arg model "bytedance/seedance-2.0-fast/text-to-video" \
  --arg prompt "Um pequeno barco de papel cruzando um lago calmo, câmera travada" \
  '{
    model: $model,
    prompt: $prompt,
    duration: 4,
    resolution: "480p",
    ratio: "16:9",
    generate_audio: false,
    watermark: false
  }' > "${atlas_tmp_dir:?configure o espaço de trabalho privado primeiro}/request.json"

curl --fail --silent --show-error \
  --request POST \
  "https://api.atlascloud.ai/api/v1/model/generateVideo" \
  --header "Authorization: Bearer $ATLASCLOUD_API_KEY" \

…