Mindlogic Logo
Docs
/
API Gateway
API Gateway/์‹œ์ž‘ํ•˜๊ธฐ/์ธ์ฆ

์ธ์ฆ

ํŒฉํŠธ์ฑ— API Gateway๋ฅผ ์•ˆ์ „ํ•˜๊ฒŒ ์‚ฌ์šฉํ•˜๊ธฐ ์œ„ํ•œ ์ธ์ฆ ์„ค์ •์„ ์•ˆ๋‚ดํ•ฉ๋‹ˆ๋‹ค.
ํ•˜๋‚˜์˜ API ํ‚ค๋กœ ๋ชจ๋“  AI ๋ชจ๋ธ์— ์ ‘๊ทผํ•  ์ˆ˜ ์žˆ์œผ๋ฉฐ, OpenAI SDK์™€ Anthropic SDK ๋ชจ๋‘ ๋ณ„๋„์˜ ํ—ค๋” ์„ค์ • ์—†์ด ๋ฐ”๋กœ ์‚ฌ์šฉํ•  ์ˆ˜ ์žˆ๋„๋ก ๋‘ ๊ฐ€์ง€ ์ธ์ฆ ๋ฐฉ์‹์„ ์ง€์›ํ•ฉ๋‹ˆ๋‹ค.
์•„๋ž˜ ๊ฐ€์ด๋“œ๋ฅผ ๋”ฐ๋ผ ๋น ๋ฅด๊ฒŒ ์„ค์ •ํ•ด๋ณด์„ธ์š”!

API ํ‚ค ๋ฐœ๊ธ‰

  1. ํŒฉํŠธ์ฑ— ์›น์‚ฌ์ดํŠธ์— ๋กœ๊ทธ์ธํ•ด์ฃผ์„ธ์š”.
  2. ์ขŒ์ธก ํ•˜๋‹จ์˜ API Gateway ๋ฒ„ํŠผ์„ ํด๋ฆญํ•ด์ฃผ์„ธ์š”.
  3. API ํ‚ค ์ƒ์„ฑ ๋ฒ„ํŠผ์„ ํด๋ฆญํ•˜์—ฌ ํ‚ค๋ฅผ ๋ฐœ๊ธ‰ํ•ด์ฃผ์„ธ์š”.
  4. ์ƒ์„ฑ๋œ API ํ‚ค๋ฅผ ๋ณต์‚ฌํ•˜์—ฌ ์•ˆ์ „ํ•œ ๊ณณ์— ๋ณด๊ด€ํ•ด์ฃผ์„ธ์š”.
API ํ˜ธ์ถœ ์‹œ ํฌ๋ ˆ๋”ง์€ API ํ‚ค๋ฅผ ์ƒ์„ฑํ•œ ๊ณ„์ •์—์„œ ์ฐจ๊ฐ๋ฉ๋‹ˆ๋‹ค.
์ƒ์„ฑ๋œ ํ‚ค๋Š” ๋‹ค์‹œ ์กฐํšŒํ•  ์ˆ˜ ์—†์Šต๋‹ˆ๋‹ค. ๋ณด์•ˆ์„ ์œ„ํ•ด ๋ฐ˜๋“œ์‹œ ์•ˆ์ „ํ•œ ๊ณณ์— ๋ณด๊ด€ํ•ด์ฃผ์„ธ์š”.

์ง€์›๋˜๋Š” ํ—ค๋” ๋ฐฉ์‹

๋ฐฉ๋ฒ• 1: Authorization Bearer (OpenAI SDK ๊ธฐ๋ณธ)

OpenAI Python/JS SDK์—์„œ ๊ธฐ๋ณธ์œผ๋กœ ์‚ฌ์šฉ๋ฉ๋‹ˆ๋‹ค.

๋ฐฉ๋ฒ• 2: x-api-key (Anthropic SDK ๊ธฐ๋ณธ)

Anthropic Python/JS SDK ๋ฐ Claude Code CLI์—์„œ ๊ธฐ๋ณธ์œผ๋กœ ์‚ฌ์šฉ๋ฉ๋‹ˆ๋‹ค.
๋‘ ๋ฐฉ์‹ ๋ชจ๋‘ ์™„์ „ํžˆ ์ง€์›๋˜๋ฏ€๋กœ, ํ‘œ์ค€ SDK ์‚ฌ์šฉ ์‹œ ๋ณ„๋„์˜ ํ—ค๋” ์„ค์ •์ด ํ•„์š”ํ•˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค.

ํ™˜๊ฒฝ ๋ณ€์ˆ˜ ํŒจํ„ด

OpenAI SDK

Anthropic SDK / Claude Code

Claude Code์—์„œ ์ปค์Šคํ…€ Base URL์„ ์„ค์ •ํ•  ๋•Œ๋Š” ANTHROPIC_API_KEY๊ฐ€ ์•„๋‹Œ ANTHROPIC_AUTH_TOKEN์„ ์‚ฌ์šฉํ•ด์•ผ ํ•ฉ๋‹ˆ๋‹ค.

๋ณด์•ˆ

API ํ‚ค ๋ณด์•ˆ์„ ์œ„ํ•ด ๋‹ค์Œ ์‚ฌํ•ญ์„ ๋ฐ˜๋“œ์‹œ ์ง€์ผœ์ฃผ์„ธ์š”:
  • API ํ‚ค๋Š” ํ•ญ์ƒ ํ™˜๊ฒฝ ๋ณ€์ˆ˜์— ์ €์žฅํ•˜๊ณ , ์†Œ์Šค ์ฝ”๋“œ์— ์ง์ ‘ ํฌํ•จํ•˜์ง€ ๋งˆ์„ธ์š”
  • HTTPS ์—”๋“œํฌ์ธํŠธ๋งŒ ์‚ฌ์šฉํ•˜์„ธ์š” (HTTP๋Š” ์ง€์›๋˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค)
  • ํ‚ค๊ฐ€ ๋…ธ์ถœ๋˜์—ˆ๋‹ค๋ฉด ์ฆ‰์‹œ API Gateway ํŽ˜์ด์ง€์—์„œ ํ•ด์ง€ํ•˜๊ณ  ์ƒˆ ํ‚ค๋ฅผ ๋ฐœ๊ธ‰๋ฐ›์œผ์„ธ์š”
  • API ํ‚ค๋Š” ์กฐ์ง๋ณ„๋กœ ๋ฒ”์œ„๊ฐ€ ์ง€์ •๋ฉ๋‹ˆ๋‹ค โ€” ๋‹ค๋ฅธ ์กฐ์ง์˜ ๋ชจ๋ธ์— ์ ‘๊ทผํ•  ์ˆ˜ ์—†์Šต๋‹ˆ๋‹ค
  • ํ‚ค๋Š” API Gateway ํŽ˜์ด์ง€์—์„œ ์–ธ์ œ๋“ ์ง€ ํ•ด์ง€ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค

์ธ์ฆ ์„ค์ •์„ ๋งˆ์น˜์…จ๋‚˜์š”? curl ์˜ˆ์ œ ํŽ˜์ด์ง€์—์„œ ๊ฐ„๋‹จํ•œ API ํ˜ธ์ถœ์„ ์‹œ๋„ํ•ด๋ณด์„ธ์š”.

๋งˆ์ง€๋ง‰ ์ˆ˜์ • ๋‚ ์งœ: Apr 15, 2026

์ด์ „

๊ฐœ์š”

๋‹ค์Œ

/models

๋ชฉ์ฐจ