Como o Atlas Cloud funciona

Visão geral da arquitetura

Atlas Cloud é uma plataforma de agregação de APIs de IA que fica entre sua aplicação e múltiplos provedores de modelos de IA. Em vez de integrar com cada provedor separadamente, você usa uma única chave API do Atlas Cloud e endpoints de API consistentes para acessar mais de 400 modelos de dezenas de provedores.

Your Application
      |
      v
  Atlas Cloud API  ------  Unified authentication, billing, and monitoring
      |
      |-- DeepSeek (V3, Coder)
      |-- Alibaba (Qwen, Qwen-Image)
      |-- ByteDance (Seedream, Seedance, Seed Audio)
      |-- Black Forest Labs (FLUX)
      |-- Google (Veo, Gemini)
      |-- MiniMax (Hailuo)
      +-- ... 20+ more providers

Como as solicitações funcionam

APIs síncronas (LLM / Chat)

As completações de chat LLM retornam respostas de forma síncrona, assim como a API da OpenAI:

1. Você envia uma solicitação POST para /v1/chat/completions com seu prompt
2. Atlas Cloud roteia a solicitação para o provedor do modelo selecionado
3. Você recebe a resposta diretamente (ou via chunks de streaming)

Client  ->  POST /v1/chat/completions  ->  Atlas Cloud  ->  Model Provider
Client  <-  Response (text/stream)     <-  Atlas Cloud  <-  Model Provider

APIs assíncronas (geração de imagens / vídeos)

As tarefas de geração de imagens e vídeos são executadas de forma assíncrona porque levam mais tempo para processar:

1. Você envia uma solicitação POST para iniciar uma tarefa de geração
2. Atlas Cloud retorna um ID de predição imediatamente
3. Você consulta o endpoint /api/v1/model/prediction/{id} para verificar o status da tarefa
4. Uma vez concluída, você recebe a(s) URL(s) de saída

Client  ->  POST /api/v1/model/generateImage  ->  Atlas Cloud
Client  <-  { data: { id: "abc123" } }              <-  Atlas Cloud

Client  ->  GET /api/v1/model/prediction/abc123       ->  Atlas Cloud
Client  <-  { data: { status: "processing" } }        <-  Atlas Cloud

Client  ->  GET /api/v1/model/prediction/abc123       ->  Atlas Cloud
Client  <-  { data: { status: "completed", outputs: ["https://..."] } }  <-  Atlas Cloud

Para mais detalhes sobre polling, consulte Predições.

Resumo dos endpoints da API

Autenticação

Todas as solicitações API requerem uma chave API no cabeçalho Authorization:

Authorization: Bearer your-api-key

Obtenha sua chave API no Console do Atlas Cloud. Consulte o guia de Chaves API para mais detalhes.

Benefícios principais

Uma API, mais de 400 modelos

Não é necessário gerenciar múltiplas contas de provedores, chaves API ou relações de faturamento. Atlas Cloud cuida de todas as integrações com provedores para você.

Compatível com o SDK OpenAI

A API LLM é totalmente compatível com o SDK OpenAI. Mude para Atlas Cloud alterando apenas duas linhas de código — a URL base e a chave API.

Infraestrutura otimizada

A infraestrutura de inferência do Atlas Cloud é otimizada para velocidade e confiabilidade:

• Geração de imagens em menos de 5 segundos
• Geração de vídeos em menos de 2 minutos
• 99,9% de tempo de atividade da API

Faturamento unificado

Uma conta, um saldo, uma fatura — independentemente de quantos modelos ou provedores você use. Monitore o uso e os custos em tempo real no Console.

Próximos passos

• Início rápido — Faça sua primeira chamada API
• Predições — Entenda o fluxo de tarefas assíncronas
• Enviar arquivos — Envie mídia para fluxos de trabalho de geração
• APIs de modelos — Explore os modelos disponíveis