개발자 빠른 연동

OpenAI 호환 인터페이스를 사용해 첫 번째 최소 기능 호출 완료하기

직접 코드를 작성해 MoleAPI에 연동하려면, 우선 아래 두 가지를 기억하세요.

Base URL：https://api.moleapi.com/v1
인증 방식：Authorization: Bearer <YOUR_API_KEY>

가장 일반적으로 처음 호출하는 인터페이스는 다음과 같습니다.

POST /chat/completions

0단계: 먼저 두 개의 파라미터를 환경에 넣기

API Key를 코드에 직접 하드코딩하지 말고, 먼저 환경 변수에 저장하는 것을 권장합니다.

PowerShell

$env:MOLEAPI_KEY="sk-xxxxxxxxxxxxxxxx"

Bash / zsh

export MOLEAPI_KEY="sk-xxxxxxxxxxxxxxxx"

왜 먼저 환경 변수를 사용하나요

이렇게 하면 로컬 테스트, CI, 운영 환경을 전환할 때 환경 설정만 교체하면 되고, 소스 코드를 반복해서 수정할 필요가 없습니다.

cURL 예시

Bash / zsh

curl https://api.moleapi.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $MOLEAPI_KEY" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [
      {"role": "user", "content": "你好，请用一句话介绍 MoleAPI。"}
    ]
  }'

PowerShell

$headers = @{
  "Content-Type" = "application/json"
  "Authorization" = "Bearer $env:MOLEAPI_KEY"
}

$body = @{
  model = "gpt-4o-mini"
  messages = @(
    @{
      role = "user"
      content = "你好，请用一句话介绍 MoleAPI。"
    }
  )
} | ConvertTo-Json -Depth 5

Invoke-RestMethod -Method Post `
  -Uri "https://api.moleapi.com/v1/chat/completions" `
  -Headers $headers `
  -Body $body

요청이 성공하면, 일반적으로 최소한 다음 항목을 포함한 JSON 응답을 받게 됩니다.

id
model
choices[0].message.content

모델이 정상적으로 텍스트를 반환하는 것만 확인되면, 최소 연동 경로는 이미 정상적으로 동작한 것입니다.

Python 최소 예시

from openai import OpenAI
import os

client = OpenAI(
    api_key=os.environ["MOLEAPI_KEY"],
    base_url="https://api.moleapi.com/v1",
)

resp = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "你好，请返回一句接入成功提示。"}],
)

print(resp.choices[0].message.content)

Node.js 최소 예시

import OpenAI from "openai";

async function main() {
  const client = new OpenAI({
    apiKey: process.env.MOLEAPI_KEY,
    baseURL: "https://api.moleapi.com/v1",
  });

  const resp = await client.chat.completions.create({
    model: "gpt-4o-mini",
    messages: [{ role: "user", content: "你好，请返回一句接入成功提示。" }],
  });

  console.log(resp.choices[0]?.message?.content);
}

main().catch(console.error);

처음 정상 동작을 확인할 때는 이 3가지만 검증하는 것을 권장합니다

요청이 정상적인 JSON 응답을 받는지
반환 내용이 오류 메시지가 아닌지
사용 중인 모델명과 분组이 현재 사용 가능한지

이 단계가 안정화된 후에, 아래 항목을 점진적으로 추가하세요.

스트리밍 출력
더 긴 컨텍스트
도구 호출
이미지, 오디오 등 멀티모달 기능

최소 문제 해결 순서

먼저 Base URL과 경로가 올바른지 확인합니다
다음으로 API Key가 유효하고, 대상 모델 권한이 있는지 확인합니다
마지막으로 모델명과 현재 분组을 대조합니다

작게 시작하고 점차 확장하세요

가장 짧은 요청으로 먼저 정상 동작을 확인한 다음, 긴 컨텍스트, 스트리밍 출력, 더 복잡한 파라미터를 순차적으로 추가하세요.

cURL은 되는데 프로젝트 코드에서는 동작하지 않는 경우

이 경우는 일반적으로 플랫폼 자체에는 문제가 없고, 프로젝트 연동 계층에서 막혔을 가능성이 높습니다. 우선 아래를 확인하세요.

코드에서 실제로 MOLEAPI_KEY를 읽고 있는지
SDK 설정의 baseURL / base_url이 여전히 다른 플랫폼을 가리키고 있지 않은지
비즈니스 코드에서 요청 주소를 다시 이어 붙이는 처리가 있는지
프록시, Gateway 또는 서버 환경 변수가 로컬과 일치하는지

다음으로 무엇을 보면 좋을까요

기존 OpenAI chat/completions 인터페이스 외에도, MoleAPI의 일부 모델은 OpenAI 최신 responses 인터페이스, Gemini 인터페이스, 그리고 Anthropic 요청 인터페이스도 지원합니다. 구체적인 지원 범위와 호출 방식은 API 레퍼런스에서 확인할 수 있습니다.

이 페이지의 목차