Atlas Cloud 작동 방식

Atlas Cloud가 통합 API를 통해 300개 이상의 AI 모델에 연결하는 방식 이해하기

아키텍처 개요

Atlas Cloud는 애플리케이션과 여러 AI 모델 제공업체 사이에 위치하는 AI API 통합 플랫폼입니다. 각 제공업체와 개별적으로 연동하는 대신, 하나의 Atlas Cloud API 키와 일관된 API 엔드포인트를 사용하여 수십 개 제공업체의 300개 이상의 모델에 접근할 수 있습니다.

Your Application
      │
      ▼
  Atlas Cloud API  ──────  통합 인증, 결제 및 모니터링
      │
      ├── OpenAI (GPT, DALL-E)
      ├── Google (Gemini, Veo, Imagen)
      ├── DeepSeek (V3, Coder)
      ├── Alibaba (Qwen, Qwen-Image)
      ├── ByteDance (Seedream, Seedance, Kling)
      ├── Black Forest Labs (FLUX)
      ├── Luma AI (Video)
      ├── MiniMax (Hailuo)
      └── ... 20개 이상의 제공업체

요청 처리 방식

동기 API (LLM / 채팅)

LLM 채팅 완성은 OpenAI API와 마찬가지로 동기적으로 응답을 반환합니다:

/v1/chat/completions에 프롬프트와 함께 POST 요청을 보냅니다
Atlas Cloud가 선택된 모델 제공업체로 요청을 라우팅합니다
직접 응답을 받습니다 (또는 스트리밍 청크로 수신)

Client  →  POST /v1/chat/completions  →  Atlas Cloud  →  Model Provider
Client  ←  Response (text/stream)     ←  Atlas Cloud  ←  Model Provider

비동기 API (이미지 / 동영상 생성)

이미지 및 동영상 생성 작업은 처리 시간이 더 길기 때문에 비동기적으로 실행됩니다:

생성 작업을 제출하는 POST 요청을 보냅니다
Atlas Cloud가 즉시 예측 ID(data.id)를 반환합니다
/api/v1/model/prediction/{id} 엔드포인트를 폴링하여 작업 상태를 확인합니다
완료되면 출력 URL을 수신합니다

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

폴링에 대한 자세한 내용은 예측을 참조하세요.

API 엔드포인트 요약

엔드포인트	메서드	유형	설명
`/v1/chat/completions`	POST	동기	LLM 채팅 (OpenAI 호환)
`/api/v1/model/generateImage`	POST	비동기	이미지 생성
`/api/v1/model/generateVideo`	POST	비동기	동영상 생성
`/api/v1/model/uploadMedia`	POST	동기	생성 작업용 파일 업로드
`/api/v1/model/prediction/{id}`	GET	동기	비동기 작업 결과 조회

인증

모든 API 요청에는 Authorization 헤더에 API 키가 필요합니다:

Authorization: Bearer your-api-key

Atlas Cloud 콘솔에서 API 키를 발급받으세요. 자세한 내용은 API 키 가이드를 참조하세요.

주요 이점

하나의 API, 300개 이상의 모델

여러 제공업체 계정, API 키 또는 결제 관계를 관리할 필요가 없습니다. Atlas Cloud가 모든 제공업체 연동을 처리합니다.

OpenAI SDK 호환

LLM API는 OpenAI SDK와 완전히 호환됩니다. 코드 두 줄만 변경하면 Atlas Cloud로 전환할 수 있습니다 — 기본 URL과 API 키.

최적화된 인프라

Atlas Cloud의 추론 인프라는 속도와 안정성에 최적화되어 있습니다:

이미지 생성 5초 이내
동영상 생성 2분 이내
99.9% API 가동률

통합 결제

사용하는 모델이나 제공업체 수에 관계없이 — 하나의 계정, 하나의 잔액, 하나의 청구서. 콘솔에서 실시간으로 사용량과 비용을 모니터링하세요.

다음 단계

빠른 시작 — 첫 번째 API 호출하기
예측 — 비동기 작업 흐름 이해하기
파일 업로드 — 생성 워크플로우용 미디어 업로드
모델 API — 사용 가능한 모델 탐색

목차