Reflection Beam: 오픈웨이트 모델, API와 코딩 에이전트

Beam을 API, Mirror CLI 또는 자체 인프라에서 활용하세요.

reflection.ai
Reflection screenshot

Reflection은 무엇을 하는 사이트인가요? 쉽게 설명하기

Reflection은 AI 모델과 이를 활용하는 개발 도구를 만드는 회사입니다. 사이트에서 Beam 모델, API 플랫폼, 개발 문서와 모델 가중치에 접근할 수 있습니다. Beam은 텍스트 지시를 받아 추론하고 답변이나 코드를 생성합니다.

개발자는 앱에서 API를 호출하거나 코딩 에이전트에 연결할 수 있고, 인프라를 갖춘 팀은 가중치를 직접 운영할 수도 있습니다. 예를 들어 프로젝트를 읽고 실패한 테스트의 원인을 찾아 수정하는 작업을 요청할 수 있습니다. Beam이 모델 역할을 하고 Mirror CLI가 파일과 명령을 다루며, 개발자가 결과를 검토합니다.

API로 첫 응답 확인하기

공식 빠른 시작에 따라 플랫폼의 API Keys에서 키를 만드세요. 전체 키는 한 번만 표시되므로 안전하게 보관하고 REFLECTION_API_KEY로 설정합니다.

  1. 기본 URL을 https://api.reflection.ai/openai/v1 로 지정합니다.
  2. Beam-1.0-501B-A23B 모델을 선택하고 Chat Completions로 텍스트를 보냅니다.
  3. choices[0].message.content의 응답을 확인합니다.
  4. 간단한 요청이 성공한 다음 대화 기록, 도구, 구조화 출력을 추가합니다. Playground에서는 코드 작성 전에 프롬프트를 시험할 수 있습니다.

API는 스트리밍, 함수 호출, JSON Schema를 지원합니다. 요청된 함수는 애플리케이션이 실행하고 결과를 모델에 전달합니다. 추론 강도는 조절할 수 있지만 추론을 완전히 끄는 모드는 아닙니다. 입력, 추론, 최종 출력 토큰을 함께 고려해야 합니다.

호환성 문서의 범위는 Chat Completions와 Models입니다. Responses, Embeddings, 이미지·오디오 등 다른 OpenAI 엔드포인트까지 지원한다는 뜻은 아닙니다.

Mirror로 작은 코드 수정부터 시작하기

uv를 준비한 뒤 uv tool install reflection-mirror 로 설치합니다. Reflection 키를 설정하고 프로젝트 폴더에서 mirror 를 실행하세요. 테스트를 실행하고 한 가지 오류를 수정한 뒤 다시 테스트하는 식으로 범위를 정하면 결과를 확인하기 쉽습니다.

요청된 도구 동작을 검토하고 작업 후 git diff 를 확인한 다음 직접 테스트를 다시 실행하세요. Mirror는 파일을 읽고 수정하며 로컬 명령을 실행할 수 있습니다.

설정 안내는 Apple Silicon의 macOS 15 이상, glibc 2.28 이상의 Linux x86-64 또는 ARM64를 명시합니다. 네이티브 Windows는 지원하지 않습니다. Pi, OpenCode, Hermes를 Beam에 연결하는 방법도 있습니다.

모델 성격과 자체 배포 요건

Beam은 전체 약 5,010억 개, 토큰당 활성 약 230억 개 파라미터의 희소 MoE 모델입니다. 코딩, 추론, 여러 단계의 에이전트 작업을 대상으로 하며 모델 문맥은 약 100만 토큰입니다. 입력과 출력은 텍스트이고 주로 영어를 중심으로 개발됐으므로 한국어와 전문 분야는 자체 사례로 평가하세요.

가중치는 2026년 10월 16일 Apache 2.0으로 공개됐으며 BF16, FP8, NVFP4 형식이 있습니다. 공식 참고 구성은 NVLink로 연결한 NVIDIA B300 SXM GPU 네 개, Linux amd64, Docker, NVIDIA Container Toolkit을 사용합니다.

모델과 DFlash2를 내려받고 SGLang, vLLM 또는 TokenSpeed 안내에 따라 실행한 후 Beam Verifier로 점검할 수 있습니다. 이는 모든 양자화 방식의 공통 최소 사양이 아닙니다. 미세 조정과 강화학습 스택도 소개되어 있지만 스택별 상세 레시피는 추후 제공 예정입니다.

무료 범위, 사용 제한과 데이터

2026년 10월 20일 확인 기준 공식 API 공개 베타는 무료로 시작할 수 있습니다. 통일된 공식 공개 토큰 단가표는 확인하지 못했습니다. 계정의 청구와 할당량을 확인하고 외부 제공업체의 가격과 구분하세요. 자체 운영에는 GPU, 저장 공간과 관리 비용이 듭니다.

요청, 토큰, 동시 실행 제한은 조직의 프로젝트와 키가 공유합니다. 추론 토큰도 계산되며 일일 할당량은 00:00 UTC에 갱신됩니다. 429 오류는 제한 안내를 따르세요.

개인정보 정책은 호스팅 입력과 출력 수집 및 사용자 선택에 따른 모델 개선 활용 가능성을 설명합니다. 기업 콘텐츠는 고객 계약이 적용됩니다. 비공개 코드나 개인정보를 보내기 전에 조건을 검토하세요.

자주 묻는 질문

Beam은 무료인가요?

공개 가중치와 무료로 시작하는 공식 베타가 있습니다. 영구 무제한 API 사용이나 무료 하드웨어를 보장하지는 않습니다.

상업적으로 사용할 수 있나요?

Apache 2.0 조건을 지키면 가능합니다. 호스팅 API에는 해당 서비스의 약관도 적용됩니다.

이미지와 오디오도 입력할 수 있나요?

현재 모델은 텍스트를 처리합니다. 다른 자료는 적절한 별도 도구로 텍스트로 변환해야 합니다.

일반 PC에서 실행할 수 있나요?

지원되는 PC에서 Mirror를 실행해 원격 API에 연결할 수 있습니다. 전체 Beam 가중치를 실행하는 하드웨어 요건은 별도로 검토해야 합니다.

공식 자료와 개발자 커뮤니티

StepFun유료
AI Studio에서 모델을 시험하고 API로 코딩, 분석, 음성 기능을 앱에 연결하세요.
AI 모델 API 및 인프라Ai 음성 생성기 · AI 연구 보조원 · Ai 코딩 도우미 +1열기 ↗