ShareAI Platform Docs

구조화된 결정 내리기

안정적인 ShareAI 엔드포인트 /api/v1/decisions를 사용하세요.

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

구조화된 결정 내리기

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

안정적인 ShareAI 엔드포인트를 사용하세요 /api/v1/decisions. 비어 있지 않은 상태 배열과 이름이 지정된 질문을 제공하세요 noul, choice 또는 score 유형 및 일치 기준과 함께. 최대 100개의 질문과 256개의 상태 항목이 허용되며, 요청 크기 제한은 2 MiB입니다.

시작하기 전에#

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

요청 보내기#

cURL

curl --fail-with-body --request POST "https://api.shareai.now/api/v1/decisions" \
  -H "Authorization: Bearer $SHAREAI_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "YOUR_ENABLED_DECISIONS_MODEL",
  "state": [
    "A bicycle with light wear."
  ],
  "questions": {
    "category": {
      "type": "choice",
      "instructions": "Classify this item.",
      "criteria": {
        "bicycle": "A complete bicycle",
        "other": "Anything else"
      }
    }
  }
}'

요청 필드#

필드유형의미와 제한
model 필수문자열정확히 활성화된 공개 모델 식별자. 이 작업을 선언하고 귀하의 자격 증명으로 허용되어야 합니다.
state 필수배열1–256개의 텍스트 또는 모델 지원 유형 미디어 상태 항목. 요청 크기 제한은 총 2 MiB입니다.
questions 필수객체1–100개의 이름이 지정된 질문. 각 질문은 noul, choice 또는 score 유형, 지침 및 일치 기준을 가집니다. choice는 키-설명 맵을 사용하고, score는 순서가 지정된 목록을 사용하며, noul은 true/false 기준을 사용합니다.
provider객체선택적 공급자 라우팅 선호도. 모델 ID의 접두사가 아닌, 허용된 공급자 태그에 대해 provider.only를 사용하십시오. 계정 및 자격 증명 제한은 여전히 적용됩니다.

결과 읽기#

성공 시 HTTP 200과 JSON이 반환됩니다. 안정적인 ShareAI 엔드포인트를 사용하세요 /api/v1/decisions. 비어 있지 않은 상태 배열과 이름이 지정된 질문을 제공하세요 noul, choice 또는 score 유형 및 일치 기준과 함께. 최대 100개의 질문과 256개의 상태 항목이 허용되며, 요청 크기 제한은 2 MiB입니다.

청구 단위#

의사결정 모델은 입력 토큰 또는 명시적으로 게시된 입력/요청 단위를 사용합니다. 구조화된 의사결정 값은 출력 토큰 수량이 아닙니다. 활성 요금제에서 보고되고 검증된 측정값만 청구됩니다.

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

가격 및 사용량#

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

접근 및 오류#

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

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

ShareAI 플랫폼 문서
모든 문서

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

이 페이지에 대해 문의하기

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

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI