블로그/developers·2026년 8월 14일·3분·eroq 팀 작성
사용자가 사진을 보내게 하세요: 롤플레이 채팅의 비전 기능
이미지 입력은 캐릭터 제품에서 크레딧 대비 리텐션이 가장 높은 기능이에요. UX 패턴, 요청 하나로 끝나는 구현, 모더레이션 책임까지.
텍스트 롤플레이에는 친밀감이 한쪽으로만 흐르는 문제가 있어요. 캐릭터는 자기 세계를 묘사하는데, 사용자는 자기 세계를 말로 설명하는 수밖에 없죠. 비전 입력이 이 고리를 닫아 줘요. 사용자가 책상, 강아지, 저녁 식사 사진을 보내면 캐릭터가 그 사람의 실제 하루에 반응해요. 실제 서비스 중인 캐릭터 앱에서 이 반응의 순간은 쓴 크레딧 대비 리텐션 효과가 가장 강한 이벤트 중 하나예요.
기능의 작동 방식
Chat completions API는 사용자 턴에서 이미지 파트를 받아요. content가 텍스트와 image_url 항목을 섞은 배열이 되는 거예요(https URL 또는 data URI, 요청당 이미지 최대 2장). 첨부한 이미지마다 응답 비용에 2 크레딧이 더해져요. RP mini에서 사진에 반응하는 턴은 총 3 크레딧, 약 3센트예요.
{
"model": "eroq-rp-mini",
"context": "Mira: sardonic starship mechanic. Relationship: three weeks in.",
"messages": [{
"role": "user",
"content": [
{ "type": "text", "text": "look what i built today" },
{ "type": "image_url", "image_url": { "url": "data:image/jpeg;base64,…" } }
]
}]
}
엔진은 이미지를 보고, 캐릭터는 이미지 캡션이 아니라 캐릭터 그대로 반응해요. 이 차이가 곧 제품이에요. "정말 멋진 골든 리트리버네요"는 비전 데모이고, "손에 묻은 기름을 닦으며 좋아, 강아지가 너보다 귀엽네. 이름이 뭐야?"는 관계예요.
크레딧 값을 하는 UX 패턴
- 반응의 순간. 채팅 입력창에 카메라 버튼 하나, 그게 다예요. 사용자는 스스로 발견하고, "디테일까지 알아봤네" 싶은 첫 답장이 바로 훅이에요.
- 요청형 공유. 자연스러운 타이밍에 캐릭터가 먼저 요청하게 하세요. "지금 앉아 있는 곳 보여 줘"처럼요. 요청받고 보낸 사진은 수동적인 버튼보다 전환율이 3–4배 높고, 비전 지출의 속도도 조절해 줘요.
- 기억 콜백. 캐릭터가 본 것을 롤링 요약에 넣어 두세요("책상은 창문을 향해 있음, 강아지 이름은 비스킷"). 이틀 뒤 "비스킷은 잘 지내?" 같은 콜백은 이 분야에서 가장 저렴한 감동이고, 그냥 컨텍스트일 뿐이라 추가 크레딧이 전혀 들지 않아요.
- 한도를 눈에 보이게. 요청당 이미지 2장이 API 한도예요. 무료 티어에 하루 허용량을 두면 단위 경제성이 지루할 만큼 안정적으로 유지돼요. 비전은 이벤트당 저렴할 뿐, 규모가 커지면 공짜가 아니에요. 다른 모든 고정 가격처럼 예산을 잡으세요.
여러분에게 남는 책임
사용자가 올린 이미지는 사용자 생성 콘텐츠(UGC)이고, UGC에 따르는 의무는 모델 제공사에게 넘어가지 않아요.
- 업로드는 여러분 쪽에서 검사하세요(최소한 업계 해시 목록 기반의 CSAM 탐지). API를 호출하기 전에 해야 해요. eroq의 이용 정책은 미성년자 콘텐츠와 실존 인물의 비동의 콘텐츠를 절대적으로 금지해요. 정책을 벗어난 요청은
content_blocked를 반환하고 요금이 청구되지 않아요. 하지만 업로드 경로의 탐지 도구는 있으면 좋은 부가 기능이 아니라 여러분의 법적 책임 영역이에요. - 이 기능에도 연령 확인을 적용하세요. 제품의 나머지 부분과 똑같이요. 사진 교환은 롤플레이 자체와 같은 연령 확인과 정책 뒤에 있어야 해요.
- 필요 없는 건 저장하지 마세요. data URI는 그대로 넘기고, 제품에 꼭 필요한 것만 보관하세요(사진이 아니라 요약 한 줄). RP+와 RP mini는 eroq의 자체 모델이라 업스트림에 아무것도 남기지 않아요. 캐릭터가 사진을 보내 준다면 그건 이미지 생성이고, 그런 이미지는
store: true로 오래 호스팅할 수 있어요.
자주 묻는 질문
사용자는 메시지 하나에 이미지를 몇 장 첨부할 수 있나요?
요청당 최대 2장이에요. https URL이나 data URI로, 사용자 턴에서만 가능해요. 한 장마다 응답 비용에 2 크레딧이 더해지므로, RP mini의 사진 턴은 모두 합쳐 3 크레딧이고, 같은 턴을 RP+에서 하면 5 크레딧이에요.
두 롤플레이 모델 모두 비전을 지원하나요?
네. RP+와 RP mini 모두 이미지 파트를 받고, 이미지당 똑같이 +2 크레딧이에요. 추가 요금이 같으니, 사진이 답장의 주제가 아니라면 사진 턴은 mini로 보내고, 플래그십 모델은 무게가 실리는 순간을 위해 아껴 두세요.
캐릭터가 사진을 실제로 보나요, 아니면 추측하나요?
엔진이 이미지를 보고 캐릭터 그대로 답해요. 그게 제품의 차이 전부예요. 비전 데모는 사진에 캡션을 달고, 컴패니언은 사진에 반응해요. 책상 위 물건을 나열하는 대신 책상이 어질러진 걸 알아채는 식이죠. 캐릭터가 본 것을 롤링 요약에 넣어 두면, 이틀 뒤의 콜백에는 추가 크레딧이 들지 않아요.
사용자가 올리는 콘텐츠의 모더레이션은 누가 책임지나요?
여러분이에요. API를 호출하기 전에 여러분 쪽에서 업로드를 검사하고(최소한 업계 해시 목록 기반의 CSAM 탐지), 제품의 나머지 부분과 함께 이 기능에도 연령 확인을 적용하세요. eroq의 이용 정책은 미성년자 콘텐츠와 실존 인물의 비동의 콘텐츠를 절대적으로 금지하고, 정책을 벗어난 요청은 요금 없이 content_blocked를 반환해요. 하지만 업로드 경로의 탐지는 저희가 아니라 여러분의 법적 책임 영역이에요.
오후 한나절이면 출시할 수 있어요
비전 입력은 보기 드물게 간단한 기능이에요. 입력창 버튼 하나, 기존 호출의 배열 하나만 바꾸면 되고, 새 인프라도 필요 없어요. 키와 무료 50 크레딧이면 테스트 전체를 해 볼 수 있어요. 내 책상 사진을 API에 보내고, 캐릭터가 커피 컵을 알아채는지 지켜보세요. 그 반응이 곧 기능이에요. 나머지는 제품을 운영하는 규율의 몫이에요.
이 글에 나온 모델로 직접 만들어 보세요 — 무료 크레딧 50개로 시작하거나, 모든 엔진과 가격도 살펴보세요.