FAQ

Geral

O que é o Atlas Cloud?

O Atlas Cloud é uma plataforma de agregação de APIs de IA. Uma única chave de API e um único saldo dão acesso a mais de 400 modelos — modelos de linguagem, imagem, vídeo, áudio e 3D — de vários provedores, sem precisar se cadastrar em cada um separadamente.

Como começo?

1. Crie uma conta
2. Crie uma chave de API
3. Siga o Início rápido para fazer sua primeira requisição

Quais modelos estão disponíveis?

Explore a Biblioteca de modelos. O catálogo muda com frequência, então é ele que vale como lista oficial — a documentação evita deliberadamente fixar nomes de modelos que ficariam desatualizados.

A API é compatível com a OpenAI?

Sim, e vai além disso. O Atlas Cloud aceita seis formatos de requisição: OpenAI Chat Completions, Completions, Responses e Images, além de Anthropic Messages e Google Gemini. Veja Protocolos de API para LLM.

API e questões técnicas

Estou chamando um modelo e recebendo 400. Por quê?

A causa mais comum é usar o protocolo errado para aquele modelo. Nem todo modelo aceita todos os formatos:

• Modelos da família Anthropic esperam POST /v1/messages, e não /v1/chat/completions
• Alguns modelos de raciocínio da OpenAI e da família codex esperam POST /v1/responses, e não /v1/chat/completions

Cada modelo publica os protocolos que suporta. Confira a referência de API do modelo antes de trocar de formato e veja Protocolos de API para LLM para entender as diferenças entre eles.

Quais são os endpoints da API?

Base URL: https://api.atlascloud.ai

Minha tarefa está em processing há muito tempo. Posso cancelá-la?

A geração de imagem, vídeo, áudio e 3D é assíncrona. Envie a tarefa e depois consulte GET /api/v1/model/prediction/{id} até que ela alcance um estado final. Tarefas de vídeo, em particular, podem levar minutos.

Não existe endpoint de cancelamento. Tarefas que excedem o tempo limite da plataforma são encerradas e reembolsadas automaticamente.

Se você estiver fazendo polling com frequência, mude para webhooks — você recebe um callback quando a tarefa é concluída, em vez de manter um laço de polling aberto.

Vocês suportam webhooks?

Sim, para tarefas de imagem, vídeo e áudio. Veja Webhooks para o formato do payload e a verificação de assinatura.

Como faço para enviar arquivos?

Use POST /api/v1/model/uploadMedia e passe a URL retornada na sua requisição de geração. Você também pode fornecer uma URL pública diretamente, ou Base64 embutido na maioria dos campos de imagem e áudio. Veja Enviar arquivos.

Existem limites de taxa?

Sim, aplicados por conta e por modelo. Ultrapassar um deles retorna 429.

Observe que os endpoints de LLM e de mídia não retornam cabeçalhos de limite de taxa, então você não consegue ler sua cota restante em uma resposta — implemente backoff exponencial no lugar disso. Veja Erros e limites de taxa.

Precisa de limites maiores? Entre em contato informando o volume esperado.

Estou recebendo erros 401. Como faço para depurar?

Verifique nesta ordem:

1. A chave está correta e ainda ativa? Confira em Chaves de API
2. A chave tem o escopo certo? Uma chave do Coding Plan não pode chamar modelos que não a aceitam
3. Em um contexto de equipe, você está usando uma chave criada na conta certa?
4. O caminho da URL está correto? O gateway autentica antes de rotear, então um erro de digitação no caminho também retorna 401 em vez de 404

O que é o MCP Server?

Um MCP Server oficial que expõe o Atlas Cloud como ferramentas dentro de IDEs assistidas por IA — gere mídia, converse com modelos e consulte seu saldo sem sair do editor.

Preços e cobrança

O preço no card do modelo é o custo total?

Não — para modelos de imagem e vídeo, é um preço unitário. O custo final depende de parâmetros como duração, resolução e número de saídas. Um modelo de vídeo cobrado por segundo custará essa tarifa multiplicada pela duração do clipe.

Para obter um valor exato antes de gastar qualquer coisa, use a estimativa de preço antes de enviar. Veja Como os modelos são cobrados para exemplos resolvidos.

Por que o preço que vi não bate com a minha fatura?

Três coisas podem divergir:

• O card do modelo mostra um preço unitário de tabela
• O playground recalcula conforme você altera os parâmetros
• Sua fatura também reflete descontos e promoções da conta

Imagem e vídeo usam cobrança assíncrona: um valor é reservado no envio e acertado com base no uso real quando a tarefa termina. Uma reserva pendente não é uma cobrança definitiva.

Requisições que falham são cobradas?

Não. Tarefas que falham, expiram ou são rejeitadas pela moderação de conteúdo não são cobradas. Se você vir uma cobrança que não consegue explicar, entre em contato com o suporte informando o ID da predição.

Meu saldo pode ficar negativo?

Ele pode ficar levemente negativo em uso de LLM com alta concorrência, já que as chamadas a modelos de linguagem não são pré-autorizadas. Um saldo negativo bloqueia novas requisições. Ative a recarga automática para evitar interrupções.

Os créditos do Coding Plan podem ser usados em imagem ou vídeo?

Não. O Coding Plan é uma cota de assinatura separada, destinada ao uso de modelos de linguagem, e não pode ser gasta em geração de imagem, vídeo ou áudio. Essas geram consumo do seu saldo comum. Os créditos do Coding Plan também não podem ser convertidos em saldo da conta.

Como consigo uma nota fiscal?

Solicite ou reemita a partir do histórico de cobrança no seu painel. Os links de download têm validade limitada, então salve o PDF assim que gerá-lo.

Quais formas de pagamento são aceitas?

Cartões de crédito e débito (via Stripe), WeChat Pay, Alipay e criptomoedas. Os pagamentos são processados em USD.

Existem bônus de cadastro ou programa de indicação?

O Atlas Cloud realiza promoções de recarga de tempos em tempos — confira a página de cobrança para ver o que está ativo no momento. Há também um programa de indicação: compartilhe seu link e ganhe créditos quando alguém que você indicou concluir a primeira recarga. Veja Saldo e créditos.

Os créditos expiram?

Créditos pré-pagos são válidos por um período definido a partir da data da compra, e créditos promocionais podem ter condições próprias. Veja Saldo e créditos e a Política de uso aceitável.

Conteúdo e moderação

Minha geração de vídeo falhou com erro de direitos autorais ou de áudio sensível. O que faço?

Isso geralmente vem da trilha de áudio, não do vídeo. Opções:

• Desligue a geração de áudio se você não precisar dela — muitos modelos de vídeo aceitam um sinalizador como generate_audio: false
• Forneça seu próprio áudio livre de royalties como trilha sonora
• Reescreva o prompt para pedir música original em vez de citar uma faixa ou um artista existente

Requisições bloqueadas pela moderação não são cobradas.

Minha geração foi bloqueada pela moderação de conteúdo. Por quê?

Prompts que descrevem pessoas reais, menores de idade ou outro conteúdo restrito são rejeitados. Alguns modelos suportam geração guiada por referência com material que você envia, que é o caminho suportado para trabalhos com semelhança de pessoas. Veja a Política de uso aceitável.

Um modelo que eu usava desapareceu. O que aconteceu?

Modelos são ocasionalmente descontinuados quando um provedor os encerra ou quando a confiabilidade cai. A Biblioteca de modelos sempre reflete o que está disponível no momento. Se um modelo do qual você depende sumiu, entre em contato com o suporte e podemos sugerir um substituto.

Contas e equipes

Entrei com o GitHub, mas não consigo adicionar crédito.

O GitHub nem sempre retorna um endereço de e-mail, e a cobrança exige um. Adicione um e-mail nas configurações da conta e depois faça a recarga normalmente.

Fiz login e meu saldo sumiu.

Você pode ter criado uma segunda conta. Entrar com Google, GitHub ou e-mail cria contas separadas mesmo com o mesmo endereço, a menos que elas tenham sido vinculadas. Entre da mesma forma que você se registrou originalmente. Se houver contas duplicadas, entre em contato com o suporte.

O que as equipes podem fazer?

Contas de equipe compartilham um saldo, suportam vários membros com funções e permitem criar chaves de API com escopo de equipe. O gasto pode ser detalhado por chave e por membro, e o saldo pode ser transferido entre uma conta pessoal e uma equipe. Veja Conta de Equipe e Controle de Acesso Baseado em Funções.

Como excluo minha conta?

Entre em contato com o suporte pelo e-mail cadastrado, informando o UUID da sua conta. Observe que:

• O saldo restante não é reembolsável — gaste-o antes
• Há um período de reflexão durante o qual você pode cancelar a solicitação
• Após o encerramento, o mesmo e-mail não pode ser usado para se cadastrar novamente

Se você quer apenas remover o conteúdo gerado, sem encerrar a conta, é possível excluir os registros do histórico diretamente. Veja a Política de exclusão de dados.

Dados e segurança

Como meus dados são tratados?

As requisições são transmitidas por TLS. O Atlas Cloud retém o conteúdo das requisições apenas brevemente, para a entrega do serviço e a cobrança, e cada provedor upstream tem sua própria política de retenção. Veja Retenção de dados e a Política de privacidade.

Meu conteúdo é usado para treinar modelos?

Não. O Atlas Cloud não usa o conteúdo enviado pela plataforma para treinar, ajustar, avaliar ou fazer benchmark dos modelos que hospeda, a menos que você autorize por escrito.

Posso controlar por quanto tempo meus dados são mantidos?

Sim. Requisições de geração de mídia aceitam cabeçalhos de retenção por requisição que encurtam o tempo de armazenamento dos arquivos gerados e dos registros da requisição. Veja Retenção de dados.

E quanto aos direitos de proteção de dados?

Você pode solicitar acesso, exclusão ou exportação dos seus dados pessoais a qualquer momento. Escreva para [email protected]. Veja a Política de exclusão de dados para saber o que é removido e o que precisa ser mantido por razões legais e contábeis.

Como obter ajuda

• Documentação — navegue pela barra lateral ou comece pelo Início rápido
• Suporte por e-mail — [email protected]
• Comunidade — Discord
• Vendas e preços por volume — [email protected]
• Solicitações de privacidade — [email protected]

Ao relatar um problema de API, inclua o cabeçalho X-Request-ID da resposta que falhou, ou o ID da predição no caso de uma tarefa de geração. Veja Erros e limites de taxa.