메인 콘텐츠로 건너뛰기
payload.country에는 엔진별 국가 규칙과 기본값이 적용됩니다. Doubao는 항상 중국 본토에서 질문합니다. payload.state는 지원하는 엔진에서 질문할 미국 주를 정합니다. 제출 전에 아래 엔진별 규칙을 확인합니다.

국가

payload.country에 ISO 3166-1 alpha-2 코드를 보냅니다.
ISO 3166-1 alpha-2 코드가 아닌 값은 400 VALIDATION_ERROR를 반환합니다. 기본값과 country의 의미는 엔진마다 다릅니다.

지원하지 않는 국가

서빙할 수 없는 taskType과 country 조합은 제출 시점에 422 REGION_UNSUPPORTED를 반환합니다. 다시 시도해도 소용없습니다. GET /v1/capabilities의 엔진별 countries.policy를 확인합니다. only는 지원 국가, all_except는 제외 국가를 나열합니다. Commerce 목록은 전체 쇼핑몰의 국가를 모은 것이며, 각 요청의 국가는 선택한 쇼핑몰이나 상품 URL과 같아야 합니다. 허용 국가와 실행 위치는 위 엔진별 규칙을 따릅니다. 다음 오류는 details에 원인을 포함합니다.

미국 주

payload.state에 미국 주의 두 글자 코드를 넣으면 그 주에서 질문합니다. 엔진은 그 주에 있는 사용자에게 답하듯 답하므로, “근처” 질문에는 그 주의 장소가 나옵니다. state는 country가 US일 때 쓰며, US는 기본값이기도 합니다. 아래 요청은 텍사스주에서 ChatGPT에 묻습니다.
결과의 state에 같은 코드를 돌려줍니다. state를 보낸 태스크는 엔진 가격에 1크레딧이 더해집니다. 미국 주가 아닌 코드, US가 아닌 country, uule과 함께 보낸 state는 400 VALIDATION_ERROR를 반환합니다. GET /v1/states?country=US는 50개 주와 DC를 돌려줍니다.

Google uule

GOOGLE_AIO, GOOGLE_AIMODE, GOOGLE_SERP은 Google의 위치 파라미터인 payload.uule도 받습니다. 장소마다 UULE를 저장해 두는 시스템에서 쓸 수 있습니다. Google 검색 URL에 넣는 w+ 값을 그대로 보내세요. Google에 그 값이 그대로 전달되므로 검색 결과 페이지, AI 개요, AI 모드가 그 장소 기준으로 답하고, 시장은 그대로 country가 정합니다. 아래 요청은 텍사스주 오스틴에서 묻습니다.
결과의 uule에 같은 값을 돌려줍니다. uule과 state 중 하나만 보내세요. 둘 다 보내면 400 VALIDATION_ERROR를 반환하고, 퍼센트 인코딩한 w%2B…처럼 w+ 형식의 UULE가 아닌 값도 같습니다. 그 밖의 엔진은 이 필드를 422 LOCATION_UNSUPPORTED로 거절합니다. GOOGLE_PLACES도 uule을 같은 방식으로 받고, 그 대신 "Reno, Nevada, United States" 같은 장소 이름을 city로 받습니다. 목록의 모든 페이지를 그 장소에서 검색합니다.

엔진별 지원 범위 확인

GET /v1/capabilities는 공개된 모든 taskType을 별칭, 입력 필드, 가격, 위치 지원, 국가 정책과 함께 반환합니다. API 키가 필요 없고, 제출을 검사하는 규칙과 같은 규칙에서 읽으며, 5분 동안 캐시해도 됩니다. 엔진 하나만 받으려면 ?taskType=을 붙이세요. 별칭도 받습니다.
알 수 없는 taskType은 400 VALIDATION_ERROR를 반환합니다. capabilities 레퍼런스도 참고하세요.

처리량

속도 제한, 역압(backpressure), 동시 실행, 배치는 크레딧과 한도에서 다룹니다. 요청 하나로 여러 태스크를 제출하려면 배치와 그리드를 참고하세요.