서비스 구성: 범용 AI
이 페이지는 중급 및 고급 사용자와 개발자를 위한 참고 자료입니다. 다른 타사 서비스를 직접 구성할 때 유용할 수 있습니다.
범용 AI가 제공하는 기능
섹션 제목: “범용 AI가 제공하는 기능”범용 AI는 다음 용도로 사용됩니다.
- 텍스트 추출
- 이미지 요약 추출
- 번역
텍스트 블록 감지는 범용 AI에 포함되지 않습니다. 전용 텍스트 블록 감지 서비스가 필요합니다.
알맞은 범용 AI 모델 고르기
섹션 제목: “알맞은 범용 AI 모델 고르기”- 텍스트 추출과 이미지 요약 추출에는 비전 기능이 필요합니다.
- 번역에는 언어 품질이 안정적이고 컨텍스트 길이가 충분한 모델을 우선하세요.
- 모델의 토큰 비용을 확인하세요. 먼저 소량으로 테스트해 볼 수 있습니다.
- 비용을 줄이려면 로컬 모델을 사용하세요.
텍스트 추출과 이미지 요약 추출
섹션 제목: “텍스트 추출과 이미지 요약 추출”두 작업 모두 비전 기능이 있는 모델이 필요합니다. 제품 용어로는 보통 멀티모달 모델 또는 비전-언어 모델(VLM)이라고 부릅니다.
텍스트 추출
섹션 제목: “텍스트 추출”비전을 지원하는 주요 모델은 대체로 성능이 좋으며, 특히 불규칙한 텍스트, 말풍선 밖 텍스트, 효과음 레터링(SFX)에 강합니다. 일본어 후리가나도 어느 정도 걸러 낼 수 있습니다.
따라서 텍스트 블록 감지 모델이 이미 텍스트를 반환했더라도 비전-언어 모델로 한 번 더 실행하면 도움이 될 수 있습니다. 다만 개선 폭은 크지 않을 수 있습니다.
추론은 텍스트 추출에 도움이 되지 않습니다. 토큰과 시간을 아끼려면 추론을 끄는 것이 일반적으로 좋습니다.
이미지 요약 추출
섹션 제목: “이미지 요약 추출”정확한 이미지 요약은 장면과 분위기를 설명해 번역 품질을 높여 줍니다. 하지만 성능이 낮은 모델은 세부 내용을 지어내 번역을 잘못된 방향으로 이끌 수 있습니다. 성능이 좋은 모델을 신중하게 고르세요.
모델 참고:
gpt-6-sol (high)이상 수준의 모델은 매우 좋은 성능을 보입니다.- OpenRouter:
google/gemma-4-31b-it— 평범합니다. 빠른 시작 가이드에서 이 모델을 사용하는 이유는 비용이 낮고 텍스트 추출을 잘하기 때문이지, 이미지 요약에 가장 좋은 선택이어서가 아닙니다. mimo-v2.6-flash— 평범합니다.glm-5.3-flash와deepseek-v4.1-flash— 심각한 환각이 잦아 이 작업에는 권장하지 않습니다.
이 작업에서는 추론의 영향이 큽니다. 가능하면 더 높은 추론 수준을 사용하세요. 범용 AI 모델의 만화 해석 능력은 시간이 지나면서 나아질 수 있습니다.
번역에는 언어 품질이 안정적이고 컨텍스트 길이가 충분한 모델을 우선하세요. 모델 참고:
- DeepSeek 공식:
deepseek-v4-flash, 추론 강도 높음. 빠르고 결과가 좋습니다. - Zhipu:
glm-5.3-flash, 추론 강도 최대. 정확도가 비교적 높습니다. - Xiaomi Mimo:
mimo-v2.6-flash, 추론 강도 최대. 위의 두 모델보다 다소 약하지만 충분히 쓸 만합니다.
범용 AI 구성 항목
섹션 제목: “범용 AI 구성 항목”API URL
섹션 제목: “API URL”요청을 받는 엔드포인트입니다. 보통 프리셋에 들어 있습니다. Ollama나 다른 호환 로컬 서비스를 사용할 때 변경하세요.
API 키
섹션 제목: “API 키”제공업체가 발급한 키입니다. 로컬 서비스에서는 비워 둘 수 있습니다. 키는 기기의 보안 저장소에 저장되며, 해당 서비스 구성을 삭제하면 함께 삭제됩니다.
모델 식별자
섹션 제목: “모델 식별자”제공업체로 보내는 정확한 모델 이름입니다. 해당 제공업체가 지원하는 모델과 일치해야 합니다. 사용자 지정 표시 이름은 요청에 보내는 식별자를 바꾸지 않습니다.
모델 기능
섹션 제목: “모델 기능”기능에 따라 어떤 자동화 동작에서 모델을 사용할 수 있는지가 정해집니다.
이미지 입력을 지원하지 않는 모델에 텍스트 추출이나 이미지 요약 추출 기능을 표시하지 마세요. 기능을 잘못 선언하면 동작이 활성화되더라도 요청이 결국 실패할 수 있습니다.
동시 요청 수
섹션 제목: “동시 요청 수”동시에 실행되는 요청 수입니다. 값이 클수록 보통 더 빠르지만, 속도 제한에 걸리기 쉽고 메모리를 더 많이 사용합니다. 0은 무제한을 뜻합니다. 잘 모르겠다면 프리셋 값을 그대로 두세요.
속도 제한
섹션 제목: “속도 제한”일정 시간 동안 시작할 수 있는 최대 요청 수입니다. 동시 요청 수와는 다릅니다. 동시 요청 수는 동시에 진행되는 작업을 제한하고, 속도 제한은 일정 기간 동안 시작되는 요청 수를 제한합니다. 0이면 제한이 꺼집니다.
요청 간격
섹션 제목: “요청 간격”연속된 요청이 시작되는 사이의 최소 지연 시간(초)입니다. 제공업체가 요청을 제한할 때 늘리세요.
자동 재시도
섹션 제목: “자동 재시도”요청이 실패한 뒤 재시도하는 횟수입니다. 0이면 자동 재시도가 꺼집니다. 재시도하면 제공업체 요금이 발생할 수 있습니다. 오류가 잘못된 API 키나 알 수 없는 모델 때문이라면 재시도 횟수를 늘려도 보통 도움이 되지 않습니다.
고급 매개변수
섹션 제목: “고급 매개변수”Temperature, 토큰 한도, Top P 등의 매개변수는 모델로 보내는 요청에 직접 영향을 줍니다. 비워 두면 제공업체나 모델의 기본값을 사용합니다. 제공업체가 해당 매개변수를 지원한다는 것을 알지 못한다면 입력하지 마세요.
요청 재정의
섹션 제목: “요청 재정의”요청 재정의(requestOverride)는 제공업체와 표준 OpenAI 호환 요청 형식 간의 차이를 처리합니다. 앱의 일반 요청 로직을 바꾸지 않고 요청 헤더, URL 쿼리 매개변수, 요청 본문을 수정할 수 있습니다.
요청 재정의는 JSON 객체여야 합니다.
{ "headers": {}, "query": {}, "body": {}}세 필드를 모두 유지하세요. 재정의가 필요 없는 섹션에는 빈 객체 {}를 사용합니다.
headers와 query는 {{API_KEY}} 자리 표시자를 지원합니다. 요청을 보내기 전에 현재 구성의 API 키로 바뀝니다. 실제 API 키를 요청 재정의에 직접 넣거나 문서나 저장소에 커밋하지 마세요.
headers: 요청 헤더 재정의
섹션 제목: “headers: 요청 헤더 재정의”headers는 평면 JSON 객체입니다. 키는 헤더 이름이며, 값은 문자열이나 null이어야 합니다.
- 문자열은 헤더를 추가하거나 대체합니다.
null은 앱의 기본 헤더에서 해당 필드를 제거합니다.
예를 들어 제공업체가 요구하는 헤더를 추가하려면 다음과 같이 합니다.
{ "headers": { "X-Provider-Version": "2026-01" }, "query": {}, "body": {}}query: URL 쿼리 매개변수 재정의
섹션 제목: “query: URL 쿼리 매개변수 재정의”query도 평면 객체입니다. API URL 뒤의 쿼리 매개변수를 수정합니다.
- 문자열은 쿼리 매개변수를 추가하거나 대체합니다.
null은 쿼리 매개변수를 제거합니다.
예를 들어 일부 제공업체는 API 키를 key 쿼리 매개변수로 요구합니다.
{ "headers": {}, "query": { "key": "{{API_KEY}}" }, "body": {}}요청 재정의로 쿼리 매개변수는 수정할 수 있지만, HTTP 메서드나 API 경로는 수정할 수 없습니다.
body: 요청 본문 재정의
섹션 제목: “body: 요청 본문 재정의”body는 완전한 요청 본문이 아니라 요청 본문에 대한 부분 패치입니다. 앱은 먼저 공통 요청 매개변수를 만든 다음 이 내용을 병합합니다.
- 일반 필드는 같은 이름의 필드를 추가하거나 대체합니다.
- 중첩 객체는 재귀적으로 병합됩니다. 하위 필드 하나를 재정의해도 같은 수준의 다른 필드는 제거되지 않습니다.
- 값이
null인 필드는 최종 요청 본문에서 제거됩니다. - 숫자, 문자열, 불리언, 배열은 같은 이름의 값을 그대로 대체합니다.
예를 들어 제공업체별 매개변수를 추가하려면 다음과 같이 합니다.
{ "headers": {}, "query": {}, "body": { "response_format": { "type": "json_object" }, "vendor_option": "value" }}앱이 기본적으로 보내는 필드를 제거하려면 null을 사용합니다.
{ "headers": {}, "query": {}, "body": { "reasoning": null, "reasoning_effort": null }}본문 재정의는 모델 매개변수와 추론 매개변수가 적용된 뒤에 적용됩니다. 따라서 body의 값이 공통 매개변수와 추론 매핑보다 우선합니다. 재정의가 잘못되면 요청이 제공업체와 호환되지 않을 수 있습니다.
제공업체 수준 재정의와 모델 수준 재정의
섹션 제목: “제공업체 수준 재정의와 모델 수준 재정의”요청 재정의는 두 수준에서 올 수 있습니다.
- 제공업체 수준 재정의: 제공업체의 기본 재정의로, 보통 제공업체 카탈로그에서 제공됩니다.
- 모델 수준 재정의: 하나의 모델에만 적용되는 재정의입니다.
모델 수준 재정의는 다음 값 상태를 따릅니다.
null: 제공업체 수준 재정의를 상속합니다.null이 아닌 객체: 제공업체 수준 객체를 통째로 대체하며, 제공업체 수준 객체와 깊은 병합을 하지 않습니다.{}: 이 역시null이 아닌 객체이며, 이 모델이 제공업체 수준 재정의를 명시적으로 사용하지 않는다는 뜻입니다.
따라서 모델 수준 재정의에서 제공업체 수준 재정의의 필드 하나만 바꾸더라도, 유지해야 할 나머지 제공업체 수준 필드를 모두 포함해야 합니다.
카탈로그 기본값과 수동 편집
섹션 제목: “카탈로그 기본값과 수동 편집”제공업체 카탈로그에서 구성을 만들면 앱이 요청 재정의를 자동으로 채울 수 있습니다. 직접 편집하기 전까지 이 구성은 카탈로그 기본값의 업데이트를 계속 따릅니다.
요청 재정의를 직접 편집하면 앱은 이를 사용자 지정 내용으로 표시하며, 설정 페이지를 열 때 더 이상 입력한 내용을 카탈로그 기본값으로 바꾸지 않습니다. 카탈로그에서 제공하는 재정의를 다시 사용하려면 기본값 복원을 선택하세요.
저장하기 전 확인 사항
섹션 제목: “저장하기 전 확인 사항”headers,query,body의 내용은 유효한 JSON 객체여야 합니다.headers와query에는 평면 문자열 또는null값을 사용하며, 중첩 객체를 쓰지 마세요.- 중첩 객체와 깊은 병합은
body에서만 지원됩니다. - 제공업체 카탈로그가 자동으로 제공하는 값을 우선 사용하세요.
- 제공업체가 특정 필드를 지원하는지 확실하지 않다면 먼저 해당 API 문서를 확인하세요.
- 권 전체에 실행하기 전에 저장한 구성을 이미지 한 장으로 테스트하세요.