FAQ

가장 많이 받는 질문에 대한 답변 — 가격, 프로토콜 오류, 멈춘 작업, 콘텐츠 검수, 계정, 한도.

일반

Atlas Cloud는 무엇인가요?

Atlas Cloud는 AI API 어그리게이션 플랫폼입니다. API 키 하나와 잔액 하나로 여러 제공자의 400개 이상 모델 — 언어 모델, 이미지, 동영상, 오디오, 3D — 을 각각 따로 가입하지 않고 사용할 수 있습니다.

어떻게 시작하나요?

계정을 만드세요
API 키를 생성하세요
빠른 시작을 따라 첫 요청을 보내세요

어떤 모델을 사용할 수 있나요?

모델 라이브러리를 살펴보세요. 카탈로그는 자주 바뀌므로 이 목록이 기준입니다 — 문서에서는 금방 낡아버리는 모델 이름을 일부러 고정해 두지 않습니다.

API가 OpenAI와 호환되나요?

호환되며, 그 이상입니다. Atlas Cloud는 여섯 가지 요청 형식을 받습니다: OpenAI Chat Completions, Completions, Responses, Images에 더해 Anthropic Messages와 Google Gemini입니다. LLM API 프로토콜을 참조하세요.

API 및 기술

모델을 호출하면 400이 반환됩니다. 왜 그런가요?

가장 흔한 원인은 해당 모델에 잘못된 프로토콜을 사용한 것입니다. 모든 모델이 모든 형식을 받아들이지는 않습니다:

Anthropic 계열 모델은 /v1/chat/completions가 아니라 POST /v1/messages를 기대합니다
일부 OpenAI 추론 계열 및 codex 계열 모델은 /v1/chat/completions가 아니라 POST /v1/responses를 기대합니다

모델마다 지원하는 프로토콜이 공개되어 있습니다. 형식을 바꾸기 전에 해당 모델의 API 레퍼런스를 확인하고, 프로토콜 간 차이는 LLM API 프로토콜에서 확인하세요.

API 엔드포인트는 무엇인가요?

용도	엔드포인트
LLM 채팅	`POST /v1/chat/completions`
LLM(Anthropic 형식)	`POST /v1/messages`
LLM(Responses 형식)	`POST /v1/responses`
이미지 및 3D 생성	`POST /api/v1/model/generateImage`
동영상 생성	`POST /api/v1/model/generateVideo`
오디오: 음성, 음악, 전사	`POST /api/v1/model/generateAudio`
작업 상태 확인	`GET /api/v1/model/prediction/{id}`
파일 업로드	`POST /api/v1/model/uploadMedia`
잔액 및 사용량	`GET /public/v1/balance`

기본 URL: https://api.atlascloud.ai

작업이 오랫동안 `processing` 상태입니다. 취소할 수 있나요?

이미지, 동영상, 오디오, 3D 생성은 모두 비동기입니다. 작업을 제출한 뒤 종료 상태에 도달할 때까지 GET /api/v1/model/prediction/{id}를 폴링하세요. 특히 동영상 작업은 몇 분이 걸릴 수 있습니다.

취소 엔드포인트는 없습니다. 플랫폼 타임아웃을 넘긴 작업은 종료되고 자동으로 환불됩니다.

자주 폴링하고 있다면 웹훅으로 바꾸는 편이 좋습니다 — 폴링 루프를 계속 열어 두는 대신, 작업이 마무리되면 콜백을 받게 됩니다.

웹훅을 지원하나요?

네, 이미지·동영상·오디오 작업에서 지원합니다. 페이로드 형식과 서명 검증은 웹훅을 참조하세요.

파일은 어떻게 업로드하나요?

POST /api/v1/model/uploadMedia를 사용한 뒤 반환된 URL을 생성 요청에 전달하세요. 공개 URL을 직접 넘길 수도 있고, 대부분의 이미지·오디오 필드는 인라인 Base64도 받습니다. 파일 업로드를 참조하세요.

요청 제한이 있나요?

있습니다. 계정별, 모델별로 각각 적용되며 초과하면 429가 반환됩니다.

LLM과 미디어 엔드포인트는 요청 제한 관련 헤더를 전혀 반환하지 않습니다. 따라서 응답에서 남은 할당량을 읽을 수 없으므로 지수 백오프를 직접 구현하세요. 오류와 요청 제한을 참조하세요.

더 높은 한도가 필요하신가요? 예상 요청량과 함께 문의해 주세요.

401 오류가 발생합니다. 어떻게 확인하나요?

다음 순서로 점검하세요:

키가 올바르고 아직 유효한가요? API 키를 확인하세요
키의 범위가 적절한가요? Coding Plan 키로는 이를 허용하지 않는 모델을 호출할 수 없습니다
팀 환경이라면, 올바른 계정에서 만든 키를 쓰고 있나요?
URL 경로가 정확한가요? 게이트웨이는 라우팅보다 먼저 인증하므로, 경로에 오타가 있어도 404가 아닌 401이 반환됩니다

MCP 서버는 무엇인가요?

Atlas Cloud를 AI 지원 IDE 안에서 도구로 노출하는 공식 MCP 서버입니다. 에디터를 떠나지 않고 미디어를 생성하고, 모델과 대화하고, 잔액을 확인할 수 있습니다.

가격 및 결제

모델 카드에 표시된 가격이 총 비용인가요?

아닙니다 — 이미지와 동영상 모델의 경우 단위 가격입니다. 최종 비용은 길이, 해상도, 출력 개수 같은 파라미터에 따라 달라집니다. 초 단위로 과금되는 동영상 모델이라면, 그 단가에 클립 길이를 곱한 금액이 듭니다.

지출하기 전에 정확한 금액을 알고 싶다면 제출 전에 가격 견적을 이용하세요. 계산 예시는 모델 과금 방식에 있습니다.

제가 본 가격과 청구액이 다른 이유는 무엇인가요?

세 가지가 서로 다를 수 있습니다:

모델 카드는 정가 기준 단위 가격을 보여줍니다
플레이그라운드는 파라미터를 바꿀 때마다 다시 계산합니다
청구서에는 계정 할인과 프로모션도 반영됩니다

이미지와 동영상은 비동기 과금을 사용합니다. 제출 시 금액이 보류되고, 작업이 끝나면 실제 사용량으로 정산됩니다. 보류 중인 금액은 최종 청구가 아닙니다.

실패한 요청도 비용이 발생하나요?

아닙니다. 실패하거나 타임아웃되거나 콘텐츠 검수에서 거부된 작업은 과금되지 않습니다. 설명되지 않는 청구가 보이면 예측 ID와 함께 지원팀에 문의해 주세요.

잔액이 마이너스가 될 수 있나요?

동시 요청이 많은 LLM 사용에서는 잔액이 소폭 마이너스로 내려갈 수 있습니다. 언어 모델 호출은 사전 승인을 거치지 않기 때문입니다. 잔액이 마이너스가 되면 이후 요청이 차단됩니다. 중단을 피하려면 자동 충전을 켜 두세요.

Coding Plan 크레딧을 이미지나 동영상에 쓸 수 있나요?

쓸 수 없습니다. Coding Plan은 언어 모델 사용을 위한 별도의 구독 한도이며, 이미지·동영상·오디오 생성에는 사용할 수 없습니다. 이들은 일반 잔액에서 차감됩니다. 또한 Coding Plan 크레딧은 계정 잔액으로 전환할 수도 없습니다.

인보이스는 어떻게 받나요?

콘솔의 결제 내역에서 발행 또는 재발행을 요청하세요. 다운로드 링크는 유효 기간이 있으므로 생성했을 때 PDF를 저장해 두세요.

어떤 결제 수단을 지원하나요?

신용카드와 체크카드(Stripe 경유), WeChat Pay, Alipay, 암호화폐를 지원합니다. 결제는 USD로 처리됩니다.

가입 보너스나 추천 프로그램이 있나요?

Atlas Cloud는 수시로 충전 프로모션을 진행합니다 — 현재 진행 중인 내용은 결제 페이지에서 확인하세요. 추천 프로그램도 있습니다. 링크를 공유하고 추천받은 분이 첫 충전을 완료하면 크레딧을 받습니다. 잔액 및 크레딧을 참조하세요.

크레딧에 유효 기간이 있나요?

선불 크레딧은 구매일로부터 정해진 기간 동안 유효하며, 프로모션 크레딧에는 별도의 조건이 붙을 수 있습니다. 잔액 및 크레딧과 이용 약관을 참조하세요.

콘텐츠 및 검수

대개 영상이 아니라 오디오 트랙이 원인입니다. 선택지는 다음과 같습니다:

소리가 필요 없다면 오디오 생성을 끄세요 — 많은 동영상 모델이 generate_audio: false 같은 플래그를 받습니다
대신 로열티 프리 오디오를 직접 제공해 사운드트랙으로 쓰세요
기존 곡이나 아티스트를 지목하는 대신 창작 음악을 요청하도록 프롬프트를 바꿔 쓰세요

검수에서 차단된 요청은 과금되지 않습니다.

생성이 콘텐츠 검수에서 차단되었습니다. 왜 그런가요?

실존 인물, 미성년자 또는 그 밖의 제한 대상을 묘사하는 프롬프트는 거부됩니다. 일부 모델은 직접 업로드한 소재를 참조해 생성하는 기능을 지원하며, 인물 이미지 작업은 이 경로를 통해 진행하시면 됩니다. 이용 약관을 참조하세요.

사용하던 모델이 사라졌습니다. 무슨 일이 있었나요?

제공자가 서비스를 중단하거나 안정성이 떨어지면 모델이 종료되기도 합니다. 현재 사용 가능한 모델은 항상 모델 라이브러리에 반영됩니다. 의존하던 모델이 사라졌다면 지원팀에 문의해 주세요. 대체 모델을 제안해 드릴 수 있습니다.

계정 및 팀

GitHub으로 로그인했는데 충전이 되지 않습니다.

GitHub이 항상 이메일 주소를 반환하지는 않는데, 결제에는 이메일이 필요합니다. 계정 설정에서 이메일을 추가한 뒤 평소대로 충전하세요.

로그인했는데 잔액이 보이지 않습니다.

두 번째 계정을 만들었을 수 있습니다. Google, GitHub, 이메일 로그인은 주소가 같더라도 연결되어 있지 않으면 서로 다른 계정이 됩니다. 처음 가입한 방식으로 로그인해 보세요. 중복 계정이 있다면 지원팀에 문의해 주세요.

팀에서는 무엇을 할 수 있나요?

팀 계정은 잔액을 공유하고, 역할을 가진 여러 구성원을 지원하며, 팀 범위의 API 키를 만들 수 있습니다. 지출은 키별·구성원별로 나누어 볼 수 있고, 잔액은 개인 계정과 팀 사이에서 이체할 수 있습니다. 팀 계정과 역할 기반 액세스 제어를 참조하세요.

계정을 삭제하려면 어떻게 하나요?

등록된 이메일 주소로 계정 UUID와 함께 지원팀에 문의해 주세요. 다음 사항에 유의하세요:

남은 잔액은 환불되지 않습니다 — 먼저 사용해 주세요
요청을 취소할 수 있는 유예 기간이 있습니다
계정을 닫은 뒤에는 같은 이메일로 다시 가입할 수 없습니다

계정을 닫는 대신 생성된 콘텐츠만 지우고 싶다면 기록을 직접 삭제할 수 있습니다. 데이터 삭제 정책을 참조하세요.

문서 — 사이드바를 둘러보거나 빠른 시작부터 시작하세요
이메일 지원 — [email protected]
커뮤니티 — Discord
영업 및 대량 가격 문의 — [email protected]
개인정보 관련 요청 — [email protected]

API 문제를 알려 주실 때는 실패한 응답의 X-Request-ID 헤더를, 생성 작업이라면 예측 ID를 함께 보내 주세요. 오류와 요청 제한을 참조하세요.

On this page