신규잘못된 모델을 올린 판매자를 어떻게 잡아내고 환불하는지 알려 드립니다.

인증

API 키

추론 요청은 MartLLM API 키로 인증됩니다. 키는 ull_로 시작하며 그 뒤에 임의의 접미사가 붙습니다. 이를 베어러 토큰으로 전달하세요:

Authorization: Bearer ull_your_key_here

Anthropic 표면은 x-api-key 헤더에서도 키를 허용합니다.

첫 번째 키는 대시보드에 처음 방문할 때 생성되며, 붙여넣을 수 있는 첫 번째 호출과 함께 표시됩니다. 대시보드 → API 키에서 키를 생성, 편집, 나열 및 삭제할 수 있습니다. 전체 비밀 키는 생성 시 한 번만 표시됩니다. 즉시 저장하세요. MartLLM은 해시만 보관하며 다시 표시할 수 없습니다. 키를 삭제하면 (대시보드 → API 키 → 삭제) 즉시 적용됩니다. 해당 키를 사용하는 앱은 작동을 멈추고, 과거 사용량은 총계에 남아 있습니다.

키별 제어

각 키는 자체 제어 기능을 가질 수 있으며, 키 생성 시 또는 나중에 대시보드 → API 키에서 편집을 통해 설정할 수 있습니다. 변경 사항은 해당 키의 다음 요청부터 적용됩니다.

  • 지출 한도 — daily, monthly 또는 lifetime 기간 동안의 USD 지출 상한선입니다. 이를 초과하는 요청은 402 key_spend_cap_exceeded 오류와 함께 거부됩니다. 비워두면 한도가 없습니다.
  • 일일 한도 — 지출 한도 외에 daily_limit_usd이 추가됩니다. 요청은 두 한도 모두를 충족해야 하며, 일일 한도는 UTC 자정에 재설정됩니다. 어느 한도라도 초과하는 요청은 402 key_spend_cap_exceeded와 함께 거부되며, 요금이 부과되지 않습니다. 키 페이지 또는 PATCH /api/v1/keys/{id}를 사용하여 설정할 수 있습니다.
  • 요청 속도 제한 — 분당 요청 상한선(1 ~ 10,000)입니다. 비워두면 표준 키별 한도(분당 300)가 적용됩니다.
  • 내 요청 및 답변 저장 안 함 — 기본적으로 비활성화되어 있습니다: MartLLM은 실패한 요청을 수정하고 지원 질문에 답변하기 위해 각 요청과 그 답변을 90일 동안 보관합니다. 이 기능을 켜면 해당 키로 이루어진 호출은 저장되지 않습니다. 저희는 각 호출의 기록(시간, 모델, 토큰 수, 비용, 요청이 발생한 주소, 시도한 공급자 및 반환된 오류)만 보관하며, 귀하가 보낸 내용이나 받은 내용은 보관하지 않습니다. 따라서 잘못된 답변에 대해 조사해 드릴 수 없습니다. 비디오 및 음악 작업은 여전히 요청을 보관하므로, 공급자가 중단한 작업은 다시 시작할 수 있습니다. 요청을 처리하는 공급자는 어떤 경우든 요청을 받습니다. 키 페이지에서 설정하거나, POST /api/v1/keys 및 PATCH /api/v1/keys/{id}에서 no_store (true/false)을 사용하여 설정할 수 있습니다. GET /api/v1/keys는 이를 반환합니다.
  • BYOK 공급자 — 키를 고정하여 귀하의 자체 공급자 자격 증명(아래 참조)을 통해 라우팅하도록 합니다.

잔액 부족 알림 이메일

대시보드 → 크레딧에서 잔액이 직접 설정한 금액 미만으로 떨어질 때 이메일을 받도록 요청할 수 있습니다. 이 기능은 기본적으로 꺼져 있으며, 잔액이 해당 금액 미만으로 떨어질 때마다 한 번씩 이메일을 보내고, 계정 소유자에게 발송됩니다. 이미지, 비디오, 음악 또는 음성 요청을 위해 할당된 금액이 작업 종료 후 15분 동안 계속 보류되어 있는 경우, 계정 소유자는 해당 작업 목록이 포함된 이메일을 받게 되며 저희 팀에도 통보됩니다. 해당 금액은 여전히 고객님의 소유이며 곧 해제될 것입니다.

BYOK — 자체 키 가져오기

Dashboard → BYOK에서 제공업체 자격 증명을 추가하세요. BYOK 제공업체를 통해 라우팅되는 요청은 사용자 자격 증명을 직접 사용합니다. 크레딧이 예약되지 않으며 MartLLM 잔액에서 토큰당 비용은 0입니다. 저장된 자격 증명은 암호화되며 마스킹된 마지막 -4으로만 표시됩니다.

대시보드 세션

웹 대시보드에 Google로 로그인할 수 있습니다 (한 번의 클릭: martllm.com의 "Continue as" 프롬프트 또는 Google 버튼). 또는 이메일로 로그인할 수도 있습니다. 이 경우 15분 후에 만료되는 6자리 코드(및 로그인 링크)를 보내드립니다. 비밀번호는 없습니다. 로그인하면 httpOnly 쿠키에 저장되는 단기 세션이 생성됩니다. 이 세션은 ull_ inference keys와 별개입니다. /api/v1/* 아래의 dashboard endpoints는 쿠키를 사용하고, gateway (/v1/*)는 API key를 사용합니다.

오류

인증 실패 시 OpenAI 스타일의 오류 엔벨로프를 반환합니다:

{ "error": { "code": "invalid_api_key", "message": "…", "type": "authentication_error" } }

전체 목록은 오류 및 제한에서 확인하세요.