- 계약 필요: 별도 계약으로 권한을 받은 조직에만 제공됩니다. 권한이 없으면 지원 모델 목록에 나타나지 않고, 실행 요청은
403(MODEL_NOT_GRANTED)으로 거부됩니다. - 위치 지정: 지역보다 좁은 도시 단위 수집(
location)을 지원하는지 여부입니다. 지원 위치 참고.
지원 지역
실행 요청의region은 ISO 3166-1 alpha-2 코드이며, 생략하면 KR입니다.
네이버 계열을 제외한 6개 모델은 다음 10개 지역을 지원합니다.
위 목록에 없는 지역 코드는
400(REGION_NOT_SUPPORTED)으로 거부됩니다. 두 오류 모두 오류 처리에 정리돼 있습니다.
지원 위치
지역(국가)보다 좁은 범위로 수집하려면 실행 요청에location을 지정합니다. 값은 국가 하위 도시 코드(예: US-NEW_YORK)이며, 생략하면 region 단위로 수집합니다.
- 현재 ChatGPT와 Perplexity만 위치 지정을 지원합니다. 다른 모델을
models에 함께 넣으면 요청 전체가400(LOCATION_NOT_SUPPORTED_FOR_MODEL)으로 거부됩니다. region을 함께 지정하면 위치가 그 지역에 속해야 합니다. 어긋나면400(LOCATION_REGION_MISMATCH)입니다.region을 생략하면 위치가 속한 지역으로 실행합니다.- 목록에 없는 위치 코드는
400(LOCATION_NOT_SUPPORTED)으로 거부됩니다.
팬아웃 (fan-out)이란
AI가 답변을 생성할 때 사용자 질문 하나에 대해 내부적으로 여러 개의 검색 쿼리를 던져 웹을 탐색한 뒤 결과를 종합하는 경우가 있습니다. 이렇게 실제로 던져진 검색 쿼리 목록을 팬아웃이라고 부릅니다. 사람이 검색창에 입력하는 말이 아니라 AI가 스스로 만들어낸 검색어이기 때문에, 우리 브랜드가 놓치고 있는 검색 의도와 만들어야 할 콘텐츠 주제를 보여주는 신호로 유용합니다. 아래는 프롬프트 하나가 팬아웃을 거쳐 답변이 되는 과정의 예시입니다.
팬아웃을 제공하는 모델은 답변의 fanouts 필드에 이 쿼리 목록을 채워 반환합니다. 제공하지 않는 모델은 답변 자체는 생성하지만 팬아웃 쿼리를 노출하지 않으므로 fanouts가 항상 빈 배열입니다. 모델별 제공 여부는 위 표를 참고하세요.