Cohere: Rerank v3.5
Cohere Rerank 3.5는 질의에 대한 관련성에 따라 후보 텍스트와 반구조화된 레코드의 순서를 재정렬합니다. 100개가 넘는 언어와 4096토큰 컨텍스트를 지원하며, 답변이나 검색 화면에 사용하기 전에 키워드 또는 의미 검색 결과를 다듬습니다.
모델 소개
이 설명은 모델의 기능을 다룹니다. Ailoot에서 사용할 수 있는 입력, 출력 및 옵션은 아래에 선택한 메서드별로 표시됩니다.
Cohere Rerank 3.5는 후보 문서와 반구조화된 텍스트의 관련성 순위를 매기는 다국어 모델입니다. 각 후보를 질의와의 관계에 따라 평가하고 관련성 점수를 포함한 재정렬된 결과 목록을 반환합니다. 키워드 또는 의미 검색에서 얻은 후보를 다듬고 검색 증강 답변에 사용할 구절을 선택할 수 있습니다. 작업은 자유 형식 답변을 생성하거나 새 말뭉치 색인을 만드는 대신 근거의 순서를 개선하는 것입니다.
정확한 제작사 식별자는 rerank-v3.5입니다. 4096토큰 컨텍스트를 사용하며, Rerank 4 Pro 및 Fast의 32K 컨텍스트와 구분됩니다. 질의와 문서 토큰은 후보당 이 창을 함께 사용합니다. 모델별 준비 가이드는 질의를 처음 2048토큰 이후에서 잘라내며, 질의를 고려하기 전 문서 청크를 4093토큰으로 설명합니다. 질의에 초점을 맞추고 요청한 관계를 판단하는 데 필요한 정보를 담은 후보 구절을 준비하세요.
질의와 후보 텍스트 문자열 목록을 제공하세요. 각 결과에는 원래 문서 위치를 가리키는 인덱스와 관련성 점수가 포함됩니다. top_n은 유지할 순위 결과 수를 선택합니다. 이를 생략하면 문서화된 제작사 워크플로는 모든 결과를 반환합니다. 최상위 구절을 원래 정책, 제품 레코드, 메시지까지 추적할 수 있도록 문서 식별자를 점수와 독립적으로 보존하세요.
Rerank 3.5는 영어 및 비영어 자료를 포함한 100개가 넘는 언어를 지원합니다. 질의에는 제품, 사용자 상황, 원하는 절차 등 필요의 여러 측면을 포함할 수 있습니다. 구조화된 레코드에 대해 V2 릴리스는 원시 문서 객체를 제거하고 YAML 문자열을 권장합니다. 긴 문자열은 잘릴 수 있으므로 유용한 필드를 의도한 순서로 배치하고, 덜 중요한 메타데이터보다 결정적인 내용을 앞에 두세요. 제목과 내용, 제품 속성, 메시지 제목과 본문 등에 적용할 수 있습니다.
V2 제작사 레퍼런스는 문서 잘라내기에 max_tokens_per_doc를 사용하며 기본값은 4096입니다. Cohere 준비 가이드는 긴 문서의 청크 분할도 설명합니다. 실제 유효 입력은 선택한 워크플로와 문서 설정에 따라 달라집니다. 더 세밀하게 제어하려면 긴 원본의 모든 섹션이 계속 보인다고 가정하지 말고 식별 가능한 구절을 직접 준비하세요. 단지 어휘만 겹치는 구절과 답을 담은 구절을 구분할 수 있을 만큼 주변 컨텍스트를 보존하세요.
요청 성능을 위해 현재 레퍼런스는 한 번에 1,000개를 넘는 문서를 보내지 않도록 권장합니다. 관련성 점수는 0에서 1 사이로 정규화되지만 값은 질의와 후보에 따라 달라지며 정확성의 선형 척도가 아닙니다. 순위를 이용해 유용한 근거를 찾으세요. 점수 임곗값이 필요하면 실제 검색 작업을 반영하도록 대표적인 분야 질의와 관련성 경계에 있는 구절을 선택하세요.
실용적인 지원 워크플로에서는 파손된 상품에 관한 질문에 대해 반품 정책의 후보 섹션을 재정렬한 뒤 선택한 원문을 답변 작성 단계에 넘길 수 있습니다. 이메일 검색에서는 특정 문제에 따라 메시지 순위를 매기고 각 결과에 원래 메시지 식별자를 보존할 수 있습니다. 유용한 결과물은 순서가 정해진 근거 목록입니다. 후속 모델의 제한으로 대체하지 말고 Rerank 3.5의 더 짧은 컨텍스트와 V2 문서 준비 방식을 결과에 연결해 유지하세요.
Ailoot Ultra · 재순위화 POST /v1/rerank cohere/rerank-v3.5
cohere/rerank-v3.5시작하기
Cohere Rerank 3.5는 질의에 대한 관련성에 따라 후보 텍스트와 반구조화된 레코드의 순서를 재정렬합니다. 100개가 넘는 언어와 4096토큰 컨텍스트를 지원하며, 답변이나 검색 화면에 사용하기 전에 키워드 또는 의미 검색 결과를 다듬습니다.
- 허용 입력
- 텍스트
- 결과
- 순위가 매겨진 결과
Ailoot에서 사용 가능 · 입력 및 메서드
Ailoot Ultra · 재순위화 POST /v1/rerank
- 입력
text- 출력
rerank- 출력 형식
- json
| 필드 | 유형 | 요건 | 값과 한도 | 기본값 |
|---|---|---|---|---|
필드documents | 유형array | 요건필수 | 값과 한도 | 기본값— |
필드model | 유형string | 요건필수 | 값과 한도 cohere/rerank-v3.5 | 기본값— |
필드provider | 유형schema | 요건선택 사항 | 값과 한도 | 기본값— |
필드query | 유형string | 요건필수 | 값과 한도 | 기본값— |
필드session_id | 유형string | 요건선택 사항 | 값과 한도 | 기본값— |
필드top_n | 유형integer | 요건선택 사항 | 값과 한도 최솟값: 1 | 기본값— |
필드trace | 유형schema | 요건선택 사항 | 값과 한도 | 기본값— |
필드user | 유형string | 요건선택 사항 | 값과 한도 | 기본값— |
필드documents[].text | 유형string | 요건선택 사항 | 값과 한도 | 기본값— |
필드documents[].image | 유형string | 요건선택 사항 | 값과 한도 | 기본값— |
입력 자료 조합
text_rerank · 필수: query, documents array with minItems1
메서드 매개변수와 수명 주기
| 매개변수 | 명세 |
|---|---|
매개변수content_type | 명세application/json |
매개변수required | 명세model, query, documents |
매개변수material_types | 명세text |
매개변수optional_controls | 명세provider, session_id, top_n, trace, user |
매개변수multimodal_input_binding | 명세null |
수명 주기: synchronous
정확한 모델 ID를 전송하고 네이티브 응답 전체를 보존하세요.
요금
요금 정보는 요청 옵션을 추가하지 않습니다. 지원되는 매개변수는 선택한 메서드에 표시됩니다.
- 빠른 모드
- 미지정 빠른 모드를 선택한 경우
- Flex 모드
- 미지정 flex 모드를 선택한 경우
- 최대 추론 수준
- 미지정 최대 추론 수준에 default 조정값을 적용하는 경우
Ailoot 요금
설정별 가격
각 요금을 표시된 조건과 대조하세요. 서로 대체되는 설정 묶음마다 하나의 요금만 적용하세요.
| 설정 | 요금표 | 과금 단위 | 요금 |
|---|---|---|---|
| 설정기본 토큰 요금 | 요금표기본 요금 | 과금 단위— | 요금 입력 · 입력 토큰 — / 1K 토큰 출력 · 출력 토큰 — / 1K 토큰 입력 · 캐시 읽기 — / 1K 토큰 입력 · 캐시 쓰기 — / 1K 토큰 입력 · 캐시 쓰기, 1시간 — / 1K 토큰 |
| 설정Ultra | 요금표— | 과금 단위검색 단위당 | 요금 total · 검색 단위 $0.002 검색 단위당 |
Ailoot는 요청 전에 예상 금액을 미리 확보합니다. 결과를 받은 뒤 측정된 사용량을 기준으로 최종 요금을 정산합니다. 스트리밍 정산에는 최종 사용량 기록을 사용합니다. 금액 확보와 정산 방식 →
요청 예제
Ailoot Ultra · 재순위화
{
"documents": [
"Paris is the capital of France.",
"Berlin is the capital of Germany."
],
"model": "cohere/rerank-v3.5",
"query": "What is the capital of France?",
"top_n": 3
}set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_REQUEST_FILE:?Set your actual JSON request file}"
export AILOOT_REQUEST_FILE
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads(Path(os.environ['AILOOT_REQUEST_FILE']).read_text(encoding='utf-8'))
if not isinstance(p,dict): raise SystemExit('Request must be a JSON object')
p['model']='cohere/rerank-v3.5'
Path('request.json').write_text(json.dumps(p,ensure_ascii=False),encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/rerank \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
print(json.dumps(json.loads(Path('result.json').read_text()),ensure_ascii=False,indent=2))
PY_RESULT
결과 수신 및 저장
Ailoot Ultra · 재순위화
json
완료된 결과 모두 보관
반환된 완전한 응답, 파일, 콘텐츠 부분을 모두 보관하세요.
모든 실제 결과 인덱스, 유한한 relevance_score 및 원본 문서 객체가 보존됩니다. 인덱스는 원본 문서 배열과 연결됩니다. 원본 JSON 전체는 정산이 끝난 후에만 저장되고 반환됩니다.
원래 응답을 확인해야 할 경우
원래 작업과 전체/부분 응답을 보존하세요. POST를 재전송하지 마세요.
응답 필드
| 필드 | 유형 |
|---|---|
필드model | 유형string |
필드id | 유형string |
필드provider | 유형string |
필드results[].index | 유형integer |
필드results[].relevance_score | 유형number |
필드results[].document.text | 유형string |
필드results[].document.image | 유형string |
필드usage.search_units | 유형integer |
필드usage.total_tokens | 유형integer |
필드usage.cost | 유형number |
오류와 다음 단계
| 응답 | 조건 | 다음 단계 |
|---|---|---|
응답400 · invalid_request_error | 조건필수 필드, 표현 형식 또는 값이 유효하지 않음 | 다음 단계표시된 요청 필드를 수정하세요. |
별칭
모델 별칭
Ailoot Ultra cohere/rerank-v3.5
메서드 경로 별칭
위에 표시된 메서드 경로를 사용하세요.
관련 호출용 ID
FAQ · Cohere: Rerank v3.5
- 어떤 입력과 결과를 사용할 수 있나요?
POST /v1/rerank·cohere/rerank-v3.5:text→rerank- 요청은 어떤 필드를 사용하나요?
POST /v1/rerank·cohere/rerank-v3.5:documents,model,provider,query,session_id,top_n,trace,user- 어떤 제한이 적용되나요?
POST /v1/rerank·cohere/rerank-v3.5:top_n.minimum:1