오픈 모델용 고속 추론 플랫폼 Fireworks AI에 앱을 연결해 텍스트·이미지 생성과 임베딩을 실행합니다.
Fireworks AI에 앱 연결하기
오픈 모델용 고속 추론 플랫폼 Fireworks AI에 앱을 연결해 Lovable 앱에서 텍스트 생성, 이미지 생성, 임베딩을 실행하세요.
Fireworks AI는 빠른 OpenAI 호환 API로 오픈 모델을 제공하는 추론 플랫폼입니다. Fireworks AI 커넥터를 사용하면 Lovable 앱이 Fireworks에서 호스팅하는 모델로 텍스트 생성, 이미지 생성, 임베딩을 실행할 수 있습니다. Lovable 내장 AI를 넘어 특정 오픈 모델이나 커스텀 엔드포인트가 필요한 앱을 위해 설계되었습니다.
Fireworks AI는 앱 + 채팅 커넥터로 제공됩니다. 하나의 공유 연결이 빌드 중 채팅과 게시된 앱 모두에서 작동합니다.
Fireworks AI를 사용하면 앱에서 다음 작업을 할 수 있습니다:
- Llama 같은 오픈 모델로 채팅 및 텍스트 완성을 생성하며 스트리밍 지원
- FLUX 같은 모델로 이미지 생성
- 의미 검색과 추천을 위한 임베딩 생성
- Fireworks 계정에서 사용할 수 있는 모델을 나열하고 런타임에 선택
Fireworks AI는 앱에 특정 오픈 모델, Fireworks에 직접 호스팅하는 커스텀 엔드포인트, 또는 직접 제어하는 OpenAI 호환 추론이 필요할 때 적합합니다. 제공업체 선호가 없는 일반적인 AI 기능이라면 Lovable 내장 AI가 더 간단한 기본 선택입니다.
주요 활용 사례 및 예시 앱
| 예시 앱 | 프롬프트 예시 | 설명 |
|---|---|---|
| AI 채팅 어시스턴트 | Fireworks AI를 사용해 Llama로 질문에 답하는 지원 채팅을 만들어줘. | 오픈 채팅 모델로 사용자 질문에 답합니다. 앱이 대화를 Fireworks 채팅 모델로 보내고 답변을 사용자에게 스트리밍합니다. |
| 텍스트-이미지 생성기 | Fireworks AI를 사용해 FLUX로 프롬프트를 이미지로 바꾸는 앱을 만들어줘. | 텍스트 프롬프트에서 필요할 때 이미지를 생성합니다. 앱이 프롬프트를 Fireworks 이미지 모델로 보내고 생성된 이미지를 표시합니다. |
| 의미 검색 | Fireworks AI를 사용해 도움말 문서를 의미 기반으로 검색하는 지식 베이스를 만들어줘. | 키워드 대신 의미로 콘텐츠를 찾습니다. 앱이 Fireworks 임베딩 모델로 문서와 질의를 임베딩하고 유사도로 결과를 정렬합니다. |
| 요약 도구 | Fireworks AI를 사용해 긴 보고서를 핵심 요점으로 요약하는 도구를 만들어줘. | 긴 문서를 훑어보기 쉬운 요약으로 압축합니다. 앱이 문서 텍스트를 Fireworks 모델로 보내고 구조화된 요약을 반환합니다. |
| 콘텐츠 파이프라인 | Fireworks AI를 사용해 사양서에서 상품 설명 초안을 작성하는 앱을 만들어줘. | 구조화된 콘텐츠를 대규모로 생성합니다. 앱이 원본 데이터를 Fireworks 모델에 넣고 검토용 초안을 만듭니다. |
| 커스텀 엔드포인트 앱 | Fireworks AI를 사용해 우리가 파인튜닝한 모델을 고객 입력에 실행하는 앱을 만들어줘. | Fireworks에 호스팅한 자체 모델을 제공합니다. 앱이 Fireworks에 배포한 커스텀 엔드포인트를 호출하고 결과를 사용자에게 보여줍니다. |
Fireworks AI 연결하기
Fireworks AI 연결을 만들 수 있는 사용자는 플랜과 워크스페이스 설정에 따라 달라집니다. 연결 및 클라이언트를 만들 수 있는 사용자를 참고하세요.
서로 다른 API 키로 여러 Fireworks AI 연결을 만들 수 있어, 환경을 분리하거나(예를 들어 개발과 프로덕션) 속도 제한을 관리할 때 유용합니다.
연결을 만든 후 사용할 프로젝트에 연결할 수 있습니다. 프로젝트에서 빌드하는 사용자는 누구나 채팅에서 Lovable에 프로젝트와 연결하도록 요청할 수 있습니다.
사전 준비
Fireworks AI를 연결하기 전에 다음을 준비하세요:
- Fireworks AI 계정
- Fireworks AI API 키
- Lovable 워크스페이스에서 연결을 만들 수 있는 권한(연결 및 클라이언트를 만들 수 있는 사용자 참고)
이 커넥터를 통한 모든 추론 요청은 Fireworks AI 사용량에 포함됩니다. 청구와 할당량은 Lovable이 아닌 Fireworks AI에서 직접 처리합니다.
1단계: Fireworks AI API 키 발급하기
API 키가 있으면 Lovable 앱이 Fireworks AI API에 인증할 수 있습니다.
Fireworks AI API 키를 만들려면 다음 단계를 따르세요.
Fireworks AI 계정 열기
Fireworks AI에 로그인합니다.
API 키로 이동
**Settings → Users → API keys**로 이동합니다.
키 만들기
Create API key를 클릭하고 설명이 담긴 이름(예: Lovable integration)을 지정합니다.
키 복사
키(fw_로 시작)를 복사해 안전하게 보관합니다.
API 키는 비밀번호처럼 작동합니다. 안전하게 보관하고 공개적으로 공유하지 마세요. 다음 단계에서 필요합니다.
자세한 내용은 Fireworks AI API 레퍼런스를 참고하세요.
2단계: Fireworks AI를 Lovable에 연결하기
서로 다른 API 키로 여러 연결을 만들 수 있습니다.
Connectors에서 Fireworks AI 열기
Connectors를 열고 Fireworks AI를 선택합니다. 카탈로그를 여는 다른 위치는 커넥터를 찾을 수 있는 위치를 참고하세요.
연결 추가하기
Add connection을 클릭합니다.
연결 구성하기
- Display name: 연결 이름을 지정합니다(예:
Fireworks AI Prod). 이 이름은 Lovable 내부에서 연결을 식별할 때만 사용됩니다. - API key: Fireworks AI API 키(
fw_로 시작)를 붙여넣습니다.
이 연결을 사용할 사용자 선택하기
Who can use this connection에서 워크스페이스 내 연결 사용자를 결정합니다. 처음에는 본인만 접근할 수 있습니다:
- Only you(기본값): 접근 목록을 그대로 두면 본인만 연결과 관련 데이터를 사용할 수 있습니다.
- Invite specific people: 이메일로 워크스페이스 멤버를 추가하면 본인과 추가한 사용자만 연결과 관련 데이터를 사용할 수 있습니다.
- Invite entire workspace: Invite entire workspace를 클릭하면 Lovable 워크스페이스의 모든 사용자가 연결을 사용할 수 있습니다.
자세한 내용은 연결 및 클라이언트를 사용할 수 있는 사용자를 참고하세요.
연결하기
Connect를 클릭합니다.
연결되면 프로젝트에서 빌드하는 사용자는 구성된 연결 수준 접근 권한에 따라 채팅에서 Lovable에 프로젝트와 Fireworks AI의 연결을 요청할 수 있습니다. 이후 Lovable 앱에서 Fireworks AI로 텍스트 생성, 이미지 생성, 임베딩을 실행할 수 있습니다.
제한 사항
Fireworks AI 커넥터는 추론 API를 다루며 다음은 할 수 없습니다:
- Fireworks 계정, 배포, 파인튜닝 작업 관리. 이 기능은 커넥터가 제공하지 않는 별도의 관리 API에 있으므로 대신 Fireworks 대시보드를 사용하세요.
- 클라이언트 측 코드에서 Fireworks 호출. 요청은 서버 측 엔드포인트에서 Lovable을 거쳐 전달됩니다.
- API 키 자동 갱신 또는 교체. 키를 교체하려면 Fireworks에서 새 키를 만들고 Lovable 연결을 업데이트하세요.
- 최종 사용자별 Fireworks AI 로그인. 각 연결은 연결된 모든 프로젝트에서 공유하는 하나의 Fireworks 계정을 나타냅니다.
Fireworks AI 연결 관리하기
Connectors에서 연결을 관리합니다. **Fireworks AI**를 선택한 뒤 연결을 여세요.
- 특정 프로젝트의 Fireworks AI 접근만 제거하고 다른 프로젝트에서는 연결을 계속 사용하려면 Unlink projects를 사용합니다. 단계는 연결에서 프로젝트 연결 해제를 참고하세요.
- 워크스페이스에서 연결을 완전히 제거하려면 Delete the connection을 사용합니다. 삭제는 영구적입니다. 연결된 모든 프로젝트에서 인증 정보가 제거되고, 새 연결을 추가할 때까지 Fireworks AI을 사용하는 앱 기능이 중단됩니다. 단계와 삭제 권한은 연결 삭제를 참고하세요.