인증

종량제 엔드포인트에 대한 모든 요청은 api14 API 키로 인증되며, 키는 Authorization 헤더에 Bearer 토큰으로 전송합니다.

Authorization: Bearer sk-api14-...

OpenAI SDK는 apiKey / api_key 옵션을 바탕으로 이 헤더를 자동으로 설정합니다.

API 키

키는 API 키에서 만들고 관리합니다.

• 키는 sk-api14-로 시작하며, 생성할 때 단 한 번만 표시됩니다. 해시만 저장되므로 분실한 키는 복구할 수 없습니다. 새 키를 만들고 기존 키는 폐기하세요.
• 키마다 분당 요청 수 한도, 일일 USD 지출 한도, 모델 허용 목록을 따로 설정할 수 있습니다. 속도 제한을 참고하세요.
• 보유할 수 있는 키 개수는 요금제에 따라 다릅니다. Free는 1개, Pro는 10개, Team과 Enterprise는 그 이상입니다.
• 키 폐기는 즉시 적용되며, 해당 키로 보낸 요청은 401 invalid_api_key를 반환합니다.

키 사용하기

키는 환경 변수에 보관하고 코드에서 읽어 오세요.

export API14_API_KEY="sk-api14-..."

curl https://api14.com/api/v1/chat/completions \
  -H "Authorization: Bearer $API14_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "openai/gpt-5-mini", "messages": [{"role": "user", "content": "Hello"}]}'

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api14.com/api/v1",
  apiKey: process.env.API14_API_KEY,
});

const result = await client.chat.completions.create({
  "model": "openai/gpt-5-mini",
  "messages": [
    {
      "role": "user",
      "content": "Explain vector databases in two sentences."
    }
  ]
});
console.log(result.choices[0].message.content);

키가 필요 없는 엔드포인트

다음 읽기 전용 카탈로그 엔드포인트는 인증 없이 사용할 수 있습니다.

그 밖의 생성 엔드포인트, /credits, /key, /generation, 동영상 작업 상태는 모두 키가 필요합니다.

인증 오류

키가 없거나, 형식이 잘못되었거나, 폐기된 경우 다음을 반환합니다.

{
  "error": {
    "message": "Missing or invalid API key. Use \"Authorization: Bearer sk-api14-…\".",
    "type": "authentication_error",
    "code": "invalid_api_key"
  }
}

HTTP 상태는 401입니다. 허용 목록으로 제한된 키는 그 밖의 모델에 대해 403 model_not_allowed를 반환합니다. 오류를 참고하세요.

키를 안전하게 지키기

• 브라우저나 모바일 앱 코드에 키를 넣지 마세요. 누구나 읽을 수 있습니다. api14는 서버에서 호출하세요.
• 키를 소스 관리에 커밋하지 마세요. 환경 변수나 시크릿 관리자를 사용하세요.
• 앱이나 환경마다 별도의 키를 사용하면 다른 키에 영향을 주지 않고 하나만 폐기할 수 있습니다.
• 스크립트나 신뢰도가 낮은 서비스에서 쓰는 키에는 일일 USD 한도를 설정해 버그로 잔액이 바닥나지 않도록 하세요.
• 키가 유출되었다면 즉시 API 키에서 폐기하세요.