Atlas 도구·API 공개: 장면 생성과 좌표·비용 관리의 조건

World Labs가 Atlas 도구와 개발자 API를 공개했다. 공식 소식 목록에는 2026년 11월 12일 공개 항목이 올라와 있다. 현재 제품 페이지는 Viewfinder, Chisel과 Splats to Mesh를 안내한다. 기존 Atlas 모델 소개는 9월 1일 글이다. 이번 소식은 도구와 API를 작업에 연결하는 경로를 다룬다. 공식 소식 목록과 Atlas 제품 페이지에서 날짜와 제공 기능을 확인할 수 있다.

사진에서 장면을 만들고 작업 도구로 옮기기

Viewfinder는 사진이나 생성 이미지에서 장면을 재구성하고 새로운 시점을 탐색하는 도구다. Chisel에서는 단순한 형태로 공간을 배치해 장면 구조를 조절한다. Splats to Mesh는 splat을 실제 기하 구조가 있는 mesh로 변환한다. World Labs는 Blender를 포함한 기존 제작 도구에 Atlas 기능을 연결하는 API도 안내한다. 이는 회사가 공개한 기능 설명이며 이 글에서 출력 품질을 독립적으로 시험하지는 않았다. Atlas 제품 안내

개발자에게는 생성된 시점과 관측한 시점을 구분하는 일이 필요하다. World Labs의 모델 설명에 따르면 Atlas는 입력에 없는 부분을 그럴듯하게 채운다. 사진을 더 주면 장면을 설명하는 정보가 늘어나지만 가려진 공간의 정확성을 자동으로 보장하지는 않는다. 실제 공간의 기록으로 쓸 때는 원본 사진과 생성 영역을 대조하는 검토가 필요하다. 이는 공식 설명에서 도출한 활용상 판단이다.

이미지·카메라·깊이를 함께 관리하기

개발자는 먼저 이미지에 카메라와 깊이 정보를 붙여 장면을 구성한다. 이어서 새 카메라 위치의 시점을 생성한다. 생성 결과는 다음 요청의 문맥으로 재사용한다. 공식 사용 개념 문서는 같은 실제 장소의 사진을 함께 제출해 상대 위치를 추정하도록 설명한다. 서로 다른 이미지를 각각 배치해 창작할 때는 카메라 시야가 겹치지 않도록 요구한다.

atlasGenerate에는 contextFrames와 targetCameras를 전달한다. returnDepth: true를 설정하면 새 시점의 깊이도 받을 수 있다. 반환된 이미지·카메라·깊이는 한 묶음으로 보관해야 한다. 문서는 공통 좌표계와 거리 단위를 쓰고 실제 미터 단위 측정에는 장면의 척도를 보정하도록 안내한다. 픽셀 크기를 바꾸면 카메라 내부 파라미터와 정렬된 맵도 함께 맞춰야 한다. API 입력·좌표 조건

장면을 만드는 순서도 비용에 영향을 준다. 공식 장면 구성 가이드는 긴 영상이나 splat 생성 전에 소수의 시점을 만들어 확인하라고 권한다. 새 시점마다 물체의 위치·모양·외관이 맞는지 살피고 서로 어긋나는 결과를 제거한다. 가이드는 카메라를 벽 뒤나 물체 안에 놓으면 렌즈 앞에 큰 가상 형상이 생길 수 있다고 설명한다. 구현자는 이런 시점 검토를 후속 작업의 입력 검사로 둘 수 있다.

프로젝트별 키와 비용 한도

Atlas Developer API에서 프로젝트는 키·자산·작업·사용량을 나누는 경계다. 공식 프로젝트·API 키 문서는 환경이나 서비스별로 프로젝트를 나누고 필요한 최소 scope만 선택하도록 안내한다. 키를 바꿔도 기존 자산과 작업이 다른 프로젝트로 이동하지는 않는다. 통합을 옮길 때는 대상 프로젝트에 필요한 자산을 다시 올리거나 만들어야 한다.

Atlas는 API 키가 속한 프로젝트의 계정에 사용료를 청구한다. 계정 전체와 프로젝트별 월 한도를 둘 수 있다. 한도가 100%에 도달하면 새 Developer API 작업은 멈춘다. 이미 실행 중인 작업은 끝까지 진행한다. World Labs는 진행 중인 작업과 사용량 반영 지연 때문에 한도를 정확한 실시간 비용 경계로 볼 수 없다고 명시한다. 요금표도 바뀔 수 있으므로 비용 산정에는 플랫폼의 현재 표를 확인해야 한다. 공식 과금·한도 문서

Atlas를 제작 파이프라인에 연결할 때는 짧은 시점 생성과 검토부터 시작할 수 있다. 새 영역의 타당성을 확인한 결과만 다음 문맥에 넣고 영상이나 3D 출력으로 넘기는 순서다. 실제 공간을 재현하려는 작업이라면 원본에서 확인한 부분과 모델이 채운 부분을 구분해 두는 편이 검토에 도움이 된다.