Proyecta AI Gateway

챗봇, 콘텐츠 생성, 요약 등 AI 기능을 배포된 앱에 추가하세요. OpenAI 호환. 서드파티 API 키 불필요.

Proyecta AI Gateway를 사용하면 여러분이 만든 앱에서 최신 LLM을 호출할 수 있습니다. 각 제공업체에 계정을 만들거나, API 키를 관리하거나, 비용을 직접 부담할 필요가 없습니다. OpenAI 호환 방식으로 동작하므로 OpenAI SDK의 엔드포인트를 gateway로 변경하면 바로 사용할 수 있습니다. 현재는 Anthropic Claude 모델만 gateway를 통해 제공됩니다. OpenAI, Google, Groq 지원은 로드맵에 포함되어 있습니다.

어떤 것을 만들 수 있나요?

챗봇 — 고객 지원, AI 코칭, FAQ 봇
콘텐츠 생성 — 설명, 이메일, 요약, 초안
분석 — 텍스트에서 인사이트 추출, 데이터 분류, 카테고리화
요약 — 문서, 기사, 스크립트 압축
개인화 — 추천, 적응형 UI

Quickstart

gateway는 OpenAI Chat Completions 프로토콜을 사용합니다. 공식 OpenAI SDK에서 baseURL과 키에 사용할 환경 변수 이름, 이 두 가지만 변경하면 됩니다.

import OpenAI from 'openai';

const openai = new OpenAI({
    baseURL: 'https://cloud.proyecta.dev/v1/ai',
    apiKey: process.env.PROYECTA_API_KEY,
});

const response = await openai.chat.completions.create({
    model: 'claude-haiku-4-5-20251001',
    messages: [{ role: 'user', content: 'Summarize this article in 3 bullet points: …' }],
});

AI builder에게 이 작업을 맡겨 보세요: "Add a chatbot to my app using the Proyecta AI Gateway. The user types a question and gets a streaming response."

Streaming

Streaming은 다른 OpenAI 호환 클라이언트와 동일하게 동작합니다.

const stream = await openai.chat.completions.create({
    model: 'claude-haiku-4-5-20251001',
    messages: [{ role: 'user', content: prompt }],
    stream: true,
});

for await (const chunk of stream) {
    process.stdout.write(chunk.choices[0]?.delta?.content ?? '');
}

모델

다음 모델을 gateway를 통해 사용할 수 있습니다.

제공업체	지원 모델
Anthropic	`claude-sonnet-4-6`, `claude-haiku-4-5-20251001`, `claude-opus-4-8`, `claude-opus-4-7`

모델 ID를 직접 전달하면 됩니다. 예: claude-haiku-4-5-20251001, claude-sonnet-4-6. 추가 제공업체는 로드맵에 포함되어 있습니다.

API 키, 요청 제한, 예산

Proyecta는 런타임에 PROYECTA_API_KEY를 자동으로 프로비저닝합니다. 일반적인 경우에는 수동으로 생성할 필요가 없습니다.

조직 소유자는 AI 크레딧 사용량(현재 기간 지출 및 플랜의 예산 한도)을 확인할 수 있습니다. 이 정보가 builder의 크레딧 표시기를 구동합니다.

요금은 어떻게 청구되나요?

AI Gateway 사용량은 앱을 편집할 때 AI builder가 소비하는 크레딧과 별도로 집계됩니다. 요청당 비용은 기본 제공업체의 요율이 적용되며, 조직의 AI 크레딧 잔액에서 차감됩니다.

자주 묻는 질문

AI Gateway와 AI builder의 차이는 무엇인가요?

AI builder는 채팅 패널에서 코드를 작성하는 에이전트입니다. AI Gateway는 배포된 앱의 사용자가 AI 기능을 원할 때 앱이 호출하는 서비스입니다.

직접 제공업체 키를 사용할 수 있나요?

가능합니다. AI에게 gateway 호출을 제거하고 환경 변수에 본인 소유의 키로 직접 연동을 설정하도록 요청하세요. 단, 통합 청구 및 공유 요청 제한 풀 혜택은 이용할 수 없게 됩니다.

이미지나 음성 생성에도 사용할 수 있나요?

아직은 불가능합니다. 현재 gateway는 텍스트 입력 / 텍스트 출력만 지원합니다. 이미지, 음성, 영상 모달리티는 로드맵에 포함되어 있습니다. 이미지 생성에 대해서는 Image Generation을 참고하세요.

사용량은 어디서 확인할 수 있나요?

크레딧 사용량은 Settings 페이지의 organization 레벨에서 확인할 수 있습니다(현재 기간 지출 및 예산 한도). 앱별 키와 실시간 사용량 차트를 제공하는 전용 AI Gateway 패널은 로드맵에 포함되어 있습니다.

출시 예정

AI Gateway용 Builder 패널 — 앱별 키 생성, 허용 모델 목록 설정, 실시간 지출 확인, builder를 떠나지 않고 키 관리
이미지 및 음성 모달리티 — 텍스트-이미지, 텍스트-음성, 음성-텍스트
런타임별 사용량 귀속 — 조직 내 어느 앱이 얼마나 지출하는지 확인