ShareAI Platform Docs

문서 재정렬

쿼리와 1–1000개의 문서를 제공하세요.

Markdown으로 보기
이 페이지에서
POST https://api.shareai.now/api/v1/rerank

문서 재정렬

기본 URL
https://api.shareai.now
인증
Bearer API 키 또는 승인된 OAuth 액세스 토큰
필수 범위
inference or monetization_gateway

쿼리와 1–1000개의 문서를 제공합니다. 각 문서는 텍스트, {"text":"..."} 객체 또는 모델이 지원하는 {"image":"https://..."} 객체입니다. top_n 최소 1개 이상, 문서 수를 초과하지 않아야 합니다. 결과는 원본 문서 인덱스와 일치합니다.

시작하기 전에#

서버에서 SHAREAI_API_KEY를 설정하고 모델 자리 표시자를 현재 활성화된 모델로 교체하세요. API 키를 브라우저 코드에 노출하지 마세요. 모델, 계정, 자격 증명 및 제공자가 모두 이 작업을 허용해야 합니다. 아래의 선택적 설정은 모델 지원이 필요합니다. API 안전 한도는 모든 모델이 모든 값을 지원한다는 보장이 아닙니다.

요청 보내기#

cURL

curl --fail-with-body --request POST "https://api.shareai.now/api/v1/rerank" \
  -H "Authorization: Bearer $SHAREAI_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "YOUR_ENABLED_RERANK_MODEL",
  "query": "A cat",
  "documents": [
    {
      "text": "A cat on a windowsill."
    },
    {
      "text": "A map of Berlin."
    }
  ],
  "top_n": 1
}'

요청 필드#

필드유형의미와 제한
model 필수문자열정확히 활성화된 공개 모델 식별자. 이 작업을 선언하고 귀하의 자격 증명으로 허용되어야 합니다.
query 필수문자열비어 있지 않은 관련성 쿼리.
documents 필수배열1–1000개의 비어 있지 않은 텍스트 문자열 또는 단일 키 텍스트/이미지 객체. 이미지 값은 HTTPS URL 또는 모델 이미지 입력을 지원하는 이미지 데이터 URL이어야 합니다.
top_n정수선택적으로 1부터 문서 수까지의 결과 개수를 지정할 수 있습니다. 반환된 인덱스는 원본 문서 배열을 참조합니다.
return_documents불리언선택적으로 제공자가 지원하는 원본 문서를 결과에 포함할 수 있습니다.
provider객체선택적 공급자 라우팅 선호도. 모델 ID의 접두사가 아닌, 허용된 공급자 태그에 대해 provider.only를 사용하십시오. 계정 및 자격 증명 제한은 여전히 적용됩니다.

결과 읽기#

성공 시 HTTP 200과 JSON을 반환합니다. 쿼리와 1–1000개의 문서를 제공합니다. 각 문서는 텍스트, {"text":"..."} 객체 또는 모델이 지원하는 {"image":"https://..."} 객체입니다. top_n 최소 1개 이상, 문서 수를 초과하지 않아야 합니다. 결과는 원본 문서 인덱스와 일치합니다.

청구 단위#

재정렬 비율은 입력 토큰, 점수가 매겨진 문서, 요청 또는 제공자가 보고한 검색 수량을 사용할 수 있습니다. 보편적인 검색-토큰 변환은 가정되지 않습니다. 가격이 책정된 차원을 보고할 수 없는 제공자는 해당 요금제에서 사용할 수 없습니다.

Console에서 정확히 활성화된 모델 식별자를 선택하세요. 선언된 작업 및 입출력 기능이 이 엔드포인트와 일치해야 합니다. 텍스트 채팅 모델은 다른 작업으로 대체될 수 없습니다. 자격 증명, 제공자 및 계정 제한은 여전히 적용됩니다.

가격 및 사용량#

요금은 선택된 모델, 제공자, 단위 및 변형에 대해 EUR AI 크레딧으로 게시됩니다. 활성 요금제의 차원만 청구됩니다. 실행 전에 크레딧을 예약하는 견적이 제공되며, 최종 청구는 측정된 사용량을 기준으로 합니다. 가격은 해상도, 출력 형식 또는 사용량 대역에 따라 달라질 수 있습니다. 최종 ShareAI 차감액은 Console Usage에서 확인하세요. 상류 비용 필드와 미디어 바이트는 발명된 토큰 수로 변환되지 않습니다.

접근 및 오류#

사용 inference 승인된 네트워크 비용 추론의 경우 monetization_gateway 승인된 Builder 마크업 및 수락된 청구 조건의 경우. 신원 확인만으로는 지출이 승인되지 않습니다. 유효성 검사, 모델 승인, 크레딧 부족, 속도 제한 및 실행 실패는 구조화된 error. 를 반환합니다. 타임아웃 또는 불확실한 제출 후에는 또 다른 잠재적으로 유료 요청을 생성하기 전에 Usage 또는 비디오 작업을 확인하세요.

마지막 업데이트 2026년 11월 3일

ShareAI 플랫폼 문서
모든 문서

제목 또는 내용으로 검색하세요.

이 페이지에 대해 문의하기

이 페이지를 탐색할 도우미를 선택하세요. 페이지를 복사하여 대화에 붙여넣을 수도 있습니다.

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI