첫 API 호출

시작 전 준비

• AI 게이트웨이 API 키

  현재 사용할 수 있는 AI 게이트웨이 API 키를 준비합니다.

• 모델 코드와 지원 엔드포인트

  에셋에 접근해 호출할 모델의 정확한 코드와 지원 API를 확인합니다.

• 실행 환경

  cURL을 실행할 셸이나 Python 또는 Node.js 개발 환경을 준비합니다.

API 형식 선택

OpenAI 호환 경로는 기존 코드의 base URL과 키를 바꾸는 방식입니다. 지원 모델과 엔드포인트는 에셋마다 다르므로 에셋에서 먼저 확인합니다.

첫 API 요청 보내기

1. 모델 코드 확인하기

   AI 게이트웨이 > 에셋에서 Chat Completions를 지원하는 모델 코드를 고릅니다. 공급사 prefix 없이 표시된 코드를 그대로 사용합니다.

2. 키와 모델 코드를 현재 셸에 설정하기

   AI 게이트웨이 > API 키에서 자신의 AI 게이트웨이 API 키를 만들고 안전한 시크릿 저장소에 보관합니다. 아래 명령은 Bash에서 키 입력을 화면과 셸 히스토리에 남기지 않고 현재 셸 세션에만 설정합니다. 새 터미널을 열면 다시 설정해야 합니다.

   키 값을 코드, 명령어 인수, 셸 히스토리, 브라우저 또는 모바일 앱에 직접 넣지 마세요. 아래 예제는 현재 셸의 LETSUR_API_KEY와 LETSUR_MODEL_CODE를 읽습니다.

   read -rsp "AI 게이트웨이 API 키: " LETSUR_API_KEY && printf '\n'
   read -rp "에셋의 모델 코드: " LETSUR_MODEL_CODE
   export LETSUR_API_KEY LETSUR_MODEL_CODE

3. 요청 보내기

   curl --config -는 인증 헤더를 프로세스 명령어 인수에 넣지 않고 표준 입력으로 전달합니다.

   (
     test -n "${LETSUR_API_KEY:-}" || { echo "LETSUR_API_KEY가 필요합니다." >&2; exit 1; }
     test -n "${LETSUR_MODEL_CODE:-}" || { echo "LETSUR_MODEL_CODE가 필요합니다." >&2; exit 1; }
    
     env -u LETSUR_API_KEY -u LETSUR_MODEL_CODE curl --config - <<EOF
   url = "https://gw.letsur.ai/v1/chat/completions"
   header = "Authorization: Bearer ${LETSUR_API_KEY}"
   header = "Content-Type: application/json"
   data = "{\"model\":\"${LETSUR_MODEL_CODE}\",\"messages\":[{\"role\":\"user\",\"content\":\"안녕하세요\"}]}"
   EOF
   )

성공 응답 확인

응답 본문과 usage가 보이면 첫 호출에 성공한 것입니다. 이 Chat Completions 비스트리밍 응답에서 estimated_cost는 usage 내부 필드가 아니며, 이름에는 estimated가 남아 있지만 호출별 비용 추적에 사용하는 값입니다.

SDK로 같은 요청을 보내려면 위에서 설정한 API 키와 모델 코드를 그대로 사용합니다. 사용하는 서버 runtime을 선택하고 코드를 개발 환경에 붙여 넣어 실행하세요.

import os
 
from openai import OpenAI
 
client = OpenAI(
    api_key=os.environ["LETSUR_API_KEY"],
    base_url="https://gw.letsur.ai/v1",
)
 
response = client.chat.completions.create(
    model=os.environ["LETSUR_MODEL_CODE"],
    messages=[{"role": "user", "content": "안녕하세요"}],
)
 
print(response.choices[0].message.content)

import OpenAI from "openai";
 
const apiKey = process.env.LETSUR_API_KEY;
const modelCode = process.env.LETSUR_MODEL_CODE;
if (!apiKey || !modelCode) {
  throw new Error("LETSUR_API_KEY와 LETSUR_MODEL_CODE가 필요합니다.");
}
 
const client = new OpenAI({
  apiKey,
  baseURL: "https://gw.letsur.ai/v1",
});
 
const response = await client.chat.completions.create({
  model: modelCode,
  messages: [{ role: "user", content: "안녕하세요" }],
});
 
console.log(response.choices[0].message.content);

응답 본문이 출력되면 선택한 SDK에서도 첫 호출에 성공한 것입니다.

문제 해결

표에 없는 오류이거나 같은 오류가 계속되면 오류 처리에서 type별 대응, 재시도 기준과 문의 시 전달할 정보를 확인합니다.

운영에 연결하기

API 키별 상한은 한도, 보유 및 초과 유닛과 호출 차단 상태는 유닛에서 확인합니다.