콘텐츠로 이동
이 페이지는 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, 추론 강도 최대. 위의 두 모델보다 다소 약하지만 충분히 쓸 만합니다.

요청을 받는 엔드포인트입니다. 보통 프리셋에 들어 있습니다. Ollama나 다른 호환 로컬 서비스를 사용할 때 변경하세요.

제공업체가 발급한 키입니다. 로컬 서비스에서는 비워 둘 수 있습니다. 키는 기기의 보안 저장소에 저장되며, 해당 서비스 구성을 삭제하면 함께 삭제됩니다.

제공업체로 보내는 정확한 모델 이름입니다. 해당 제공업체가 지원하는 모델과 일치해야 합니다. 사용자 지정 표시 이름은 요청에 보내는 식별자를 바꾸지 않습니다.

기능에 따라 어떤 자동화 동작에서 모델을 사용할 수 있는지가 정해집니다.

이미지 입력을 지원하지 않는 모델에 텍스트 추출이나 이미지 요약 추출 기능을 표시하지 마세요. 기능을 잘못 선언하면 동작이 활성화되더라도 요청이 결국 실패할 수 있습니다.

동시에 실행되는 요청 수입니다. 값이 클수록 보통 더 빠르지만, 속도 제한에 걸리기 쉽고 메모리를 더 많이 사용합니다. 0은 무제한을 뜻합니다. 잘 모르겠다면 프리셋 값을 그대로 두세요.

일정 시간 동안 시작할 수 있는 최대 요청 수입니다. 동시 요청 수와는 다릅니다. 동시 요청 수는 동시에 진행되는 작업을 제한하고, 속도 제한은 일정 기간 동안 시작되는 요청 수를 제한합니다. 0이면 제한이 꺼집니다.

연속된 요청이 시작되는 사이의 최소 지연 시간(초)입니다. 제공업체가 요청을 제한할 때 늘리세요.

요청이 실패한 뒤 재시도하는 횟수입니다. 0이면 자동 재시도가 꺼집니다. 재시도하면 제공업체 요금이 발생할 수 있습니다. 오류가 잘못된 API 키나 알 수 없는 모델 때문이라면 재시도 횟수를 늘려도 보통 도움이 되지 않습니다.

Temperature, 토큰 한도, Top P 등의 매개변수는 모델로 보내는 요청에 직접 영향을 줍니다. 비워 두면 제공업체나 모델의 기본값을 사용합니다. 제공업체가 해당 매개변수를 지원한다는 것을 알지 못한다면 입력하지 마세요.

요청 재정의(requestOverride)는 제공업체와 표준 OpenAI 호환 요청 형식 간의 차이를 처리합니다. 앱의 일반 요청 로직을 바꾸지 않고 요청 헤더, URL 쿼리 매개변수, 요청 본문을 수정할 수 있습니다.

요청 재정의는 JSON 객체여야 합니다.

{
"headers": {},
"query": {},
"body": {}
}

세 필드를 모두 유지하세요. 재정의가 필요 없는 섹션에는 빈 객체 {}를 사용합니다.

headers와 query는 {{API_KEY}} 자리 표시자를 지원합니다. 요청을 보내기 전에 현재 구성의 API 키로 바뀝니다. 실제 API 키를 요청 재정의에 직접 넣거나 문서나 저장소에 커밋하지 마세요.

headers는 평면 JSON 객체입니다. 키는 헤더 이름이며, 값은 문자열이나 null이어야 합니다.

  • 문자열은 헤더를 추가하거나 대체합니다.
  • null은 앱의 기본 헤더에서 해당 필드를 제거합니다.

예를 들어 제공업체가 요구하는 헤더를 추가하려면 다음과 같이 합니다.

{
"headers": {
"X-Provider-Version": "2026-01"
},
"query": {},
"body": {}
}

query도 평면 객체입니다. API URL 뒤의 쿼리 매개변수를 수정합니다.

  • 문자열은 쿼리 매개변수를 추가하거나 대체합니다.
  • null은 쿼리 매개변수를 제거합니다.

예를 들어 일부 제공업체는 API 키를 key 쿼리 매개변수로 요구합니다.

{
"headers": {},
"query": {
"key": "{{API_KEY}}"
},
"body": {}
}

요청 재정의로 쿼리 매개변수는 수정할 수 있지만, HTTP 메서드나 API 경로는 수정할 수 없습니다.

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 문서를 확인하세요.
  • 권 전체에 실행하기 전에 저장한 구성을 이미지 한 장으로 테스트하세요.