Proyecta AI Gateway

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

Proyecta AI Gateway를 사용하면 각 제공업체에 계정을 만들거나 API 키를 관리하거나 비용을 선불로 부담하지 않아도 빌드한 앱에서 최신 LLM을 호출할 수 있습니다. OpenAI 호환 방식이므로 OpenAI SDK가 gateway를 가리키도록 설정하면 끝입니다. 현재 gateway를 통해 사용할 수 있는 모델은 Anthropic Claude 모델뿐입니다. OpenAI, Google, Groq 지원은 로드맵에 포함되어 있습니다.

무엇을 만들 수 있나요?

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

빠른 시작

Proyecta로 빌드한 앱에서는 useAI() 훅을 사용해 키 처리나 backend 없이 페이지에서 gateway를 직접 호출할 수 있습니다.

import { useAI } from '@/hooks/useAI.ts';

function Summarizer({ article }) {
    const { ask, isPending, error } = useAI({ system: 'You summarize articles.' });
    const [summary, setSummary] = useState('');

    return (
        <button
            disabled={isPending}
            onClick={async () => setSummary(await ask(`Summarize in 3 bullets: ${article}`))}
        >
            Summarize
        </button>
    );
}

주고받는 대화형 기능이 필요하다면 useChat()을 사용하세요. 메시지 히스토리를 자동으로 관리해 줍니다.

익명 방문자도 여러분의 크레딧을 소비하므로 두 가지를 유의하세요. 프롬프트 범위를 제한하고(system에 전체 컬렉션을 스트리밍하지 말 것), 키 입력마다 completion을 호출하지 마세요.

AI 빌더에게 연결을 요청해 보세요: "Add a chatbot to my app. The user types a question and gets a streaming response."

자체 backend에서 사용하기

gateway는 OpenAI Chat Completions 프로토콜을 지원하므로, 직접 관리하는 서버에서 공식 OpenAI SDK가 gateway를 가리키도록 설정할 수 있습니다. 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: …' }],
});

스트리밍

스트리밍은 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-5` (플래그십), `claude-sonnet-4-6`, `claude-haiku-4-5-20251001`, `claude-opus-5`, `claude-opus-4-8`, `claude-opus-4-7`

모델 ID를 직접 전달하세요. 예: claude-sonnet-5, claude-haiku-4-5-20251001. 이 목록에 없는 모델 요청은 거부됩니다. 추가 제공업체 지원은 로드맵에 포함되어 있습니다.

API 키, 요청 제한, 예산

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

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

요금 청구 방식

AI Gateway 사용량은 앱 편집 시 AI 빌더가 소비하는 크레딧과 별도로 추적됩니다. 요청당 비용은 해당 제공업체의 요율이 조직의 AI 크레딧 잔액에 적용됩니다.

자주 묻는 질문

AI Gateway와 AI 빌더의 차이점은 무엇인가요?

AI 빌더는 채팅 패널에서 코드를 작성하는 에이전트입니다. AI Gateway는 게시된 앱의 사용자가 AI 기능을 사용할 때 앱이 호출하는 대상입니다.

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

가능합니다. AI에게 gateway 호출을 제거하고 환경 변수에서 자체 키로 직접 통합을 설정하도록 요청하세요. 단, 통합 청구와 공유 요청 제한 풀은 사용할 수 없게 됩니다.

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

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

사용량은 어디서 확인하나요?

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

출시 예정

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