메인 콘텐츠로 건너뛰기
POST
BaseURL: 기본적으로 https://direct.evolink.ai를 사용하며, https://api.evolink.ai는 대체 주소입니다.

인증

Authorization
string
header
필수

EvoLink API Key를 Bearer 토큰으로 사용하여 인증합니다.

API Key 발급:

API Key 관리 페이지를 방문하세요.

요청 헤더:

본문

application/json

요청 본문은 model, input, questions 세 필드만 허용합니다. 다른 필드(stream 등)를 전달하면 400 invalid_request를 반환합니다.

model
enum<string>
필수

모델 ID입니다. gemini-decision-1을 사용하세요.

이 모델은 대화 모델이 아니며 이 엔드포인트에서만 사용할 수 있습니다. 예를 들어 GPT Decisions 엔드포인트 /v1/decisions로 보내면 400 model_endpoint_mismatch를 반환합니다.

사용 가능한 옵션:
gemini-decision-1
예시:

"gemini-decision-1"

input
필수

모든 질문이 공유하는 입력입니다. 텍스트 문자열, 단일 콘텐츠 블록 또는 콘텐츠 블록 배열(텍스트, 이미지, 오디오, 동영상, PDF 문서)을 지정합니다. 입력은 비워 둘 수 없습니다. 인접한 텍스트 블록은 구분자 없이 순서대로 이어 붙여지므로 필요하면 공백이나 줄바꿈을 직접 넣으세요. JSON 데이터는 문자열로 직렬화해 텍스트로 전달하세요.

Minimum string length: 1
예시:

"I was charged twice for my order."

questions
object
필수

판단할 질문을 “질문 키 → 질문” 형태의 맵으로 지정합니다(1–1,000개). 키는 직접 정하며([A-Za-z0-9_-]+에 맞는 1–64자), 답변은 같은 키로 반환됩니다. 모델은 키를 보지 않으므로 완전한 질문을 instructions에 작성하세요.

각 질문은 같은 입력에 대해 독립적으로 평가되며 서로를 보지 않습니다. 질문 유형은 섞어서 사용할 수 있습니다. 질문 간에 의존 관계가 있으면 여러 요청으로 나누세요. 입력과 모든 질문은 262,144 토큰의 컨텍스트 창을 공유합니다.

예시:

응답

질문마다 하나의 답변을 요청의 질문과 같은 키로 반환합니다

answers
object

질문마다 하나의 답변을 요청의 질문과 같은 키로 반환합니다. 각 답변의 type은 해당 질문과 같습니다. prompt_feedback.block_reason이 설정되면 비어 있습니다

usage
object

토큰 사용량입니다. 입력 토큰만 과금합니다(total_input_tokens). 텍스트, 이미지, 오디오, 동영상, PDF 토큰은 모두 같은 단가이며 출력은 항상 0입니다. 각 요청에는 최소 요금이 적용됩니다. 현재 가격은 모델 가격을 확인하세요. 컨텍스트 캐싱은 지원하지 않으며, 반복되는 입력도 요청마다 별도로 과금합니다. HTTP 200 응답에 prompt_feedback.block_reason이 포함되어도 입력 사용량에 따라 과금합니다. 유효한 사용량이 반환되지 않으면 추정치로 정산합니다.

prompt_feedback
object

입력 콘텐츠 필터의 피드백입니다. block_reason이 설정되면 입력이 차단된 것이며, 질문은 평가되지 않고 answers는 비어 있습니다. HTTP 200으로 반환되면 과금 대상입니다. 자세한 내용은 usage를 확인하세요.