> ## Documentation Index
> Fetch the complete documentation index at: https://docs.noimosai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# API 작동 방식 이해하기

> NoimosAI API의 용도, 실행 흐름, Developer Platform과의 관계를 설명합니다.

## 개요

API는 NoimosAI의 검색, 분석, 생성 기능을 자체 서비스나 업무 시스템에 통합하는 방법입니다. 이 페이지에서는 적합한 용도와 실행 흐름, Developer Platform과의 관계를 설명합니다.

> [!NOTE]
>
> API는 Developer Platform에서 API 사용이 활성화된 프로젝트를 대상으로 합니다. 일반 워크스페이스와 API 키, 권한, 사용 기록, 결제 잔액이 분리되어 있습니다.

## API를 사용하는 경우

정해진 조건으로 작업을 반복하거나 자체 화면에서 NoimosAI 기능을 호출할 때 적합합니다. 예시는 다음과 같습니다.

* 자체 서비스에 검색이나 콘텐츠 생성 통합
* 내부 시스템에서 정기적인 분석 실행
* 여러 입력을 자체 순서로 처리
* 실행 결과와 비용을 자체 시스템에 기록

터미널에서는 [CLI](https://docs.noimosai.com/ko/developers/cli/overview.md), AI 클라이언트와의 대화에서는 [MCP 서버](https://docs.noimosai.com/ko/developers/mcp/overview.md)가 적합합니다. 인증과 결제의 차이는 [개발자 기능](https://docs.noimosai.com/ko/developers/overview.md)에서 볼 수 있습니다.

## 실행 흐름 이해하기

일부 작업은 입력이나 모델에 따라 비용이 달라집니다. 유료 작업 전에 무료 견적을 받고 최대 비용을 검토한 뒤 실행합니다. 연결을 계속 유지할 필요 없이 접수 시 발급된 실행 ID로 진행 상태를 조회할 수 있습니다.

기본 흐름은 다음 다섯 단계입니다.

1. 도구와 필수 입력 항목을 살펴봅니다.
2. 처리 전에 입력에 따른 최대 비용을 무료로 견적 받습니다.
3. 견적과 같은 내용을 검토한 비용 한도 내에서 실행합니다.
4. 접수 시 발급된 실행 ID로 완료될 때까지 상태를 조회합니다.
5. 결과와 확정 비용을 가져옵니다. 생성 파일은 만료되는 URL에서 다운로드합니다.

엔드포인트와 요청 예시는 [시작하기](https://docs.noimosai.com/ko/developers/api/getting-started.md)에서 설명합니다. Developer Platform의 [문서](https://platform.noimosai.com/docs)에서도 현재 견적 및 실행 절차를 볼 수 있습니다.

## Developer Platform 이해하기

API 키는 Developer Platform의 단일 프로젝트에 고정됩니다. 해당 키로 만든 실행, 사용 기록, 선불 USD 잔액에는 프로젝트 권한이 적용됩니다.

API는 상태를 유지하지 않는 도구를 실행합니다. 일반 워크스페이스의 브랜드 정보나 연결된 계정을 자동으로 사용하지 않습니다. 필요한 텍스트, 공개 URL, 공개 계정 식별자를 요청에 지정합니다.

## 도구와 요금 조회하기

도구, 입력 항목, 모델, 제공 상태, 요금은 변경될 수 있습니다. 목록이나 금액을 코드에 고정하지 말고 실행 시 `GET /tools`와 `POST /tools/quote` 결과를 사용하세요.

## 관련 페이지

도입 방법과 사양은 다음 페이지에서 볼 수 있습니다.

* [시작하기](https://docs.noimosai.com/ko/developers/api/getting-started.md)
* [요청 인증하기](https://docs.noimosai.com/ko/developers/api/authentication.md)
* [실행과 비용 관리하기](https://docs.noimosai.com/ko/developers/api/execution-and-billing.md)
* [API 참조](https://docs.noimosai.com/ko/developers/api/reference.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.