Source: https://ailoot.ai/docs/ko/ Canonical: https://ailoot.ai/docs/ko/ Language: ko [시작하기](https://ailoot.ai/docs/ko/) # 빠른 시작 — AI API 가격과 연결 방법 [Markdown](https://ailoot.ai/docs/ko/index.md) 키, 주소, 요청 하나로 몇 분 만에 Ailoot 모델의 첫 응답을 받습니다. Ailoot는 OpenAI, Anthropic, Google, xAI, DeepSeek, Alibaba, Moonshot, Z.ai, MiniMax, NVIDIA, Meta, Poolside, TypeSafe 등 다양한 기업의 AI 모델을 위한 통합 API입니다. 키 하나와 달러 잔액 하나를 사용합니다. 카탈로그에는 모델 카드 1256개와 문서화된 메서드 2692개가 있습니다. 대체 호출 ID나 별칭이 있으면 선택한 메서드 아래에 표시됩니다. Ailoot는 OpenAI, Anthropic, Gemini의 세 API 형식을 지원합니다. 따라서 준비된 SDK와 사용자 지정 API 주소를 설정할 수 있는 거의 모든 앱을 사용할 수 있습니다. Claude Code, Codex CLI, Cline, Cursor, Open WebUI, n8n 및 그 밖의 수십 개 앱이 해당합니다. | 방법 | 적합한 용도 | | --- | --- | | [HTTP 요청](https://ailoot.ai/docs/ko/connect/curl/) | 모든 언어에서 의존성 없이 키를 빠르게 확인 | | [OpenAI SDK](https://ailoot.ai/docs/ko/connect/openai-sdk/) | Python, Node.js에서 카탈로그 모델을 OpenAI 형식으로 사용 | | [Anthropic SDK](https://ailoot.ai/docs/ko/connect/anthropic-sdk/) | Claude 등 모델을 Messages 형식으로 사용 | | [기성 앱](https://ailoot.ai/integrations/ko/) | 에이전트·편집기·채팅 앱 85개: 77개는 준비된 설정 제공, 8개는 검토 중 | 특정 프로그램이 필요하다면 다음을 여세요: [연동 카탈로그](https://ailoot.ai/integrations/ko/) — 각 프로그램의 주소·키 입력 위치와 복사 가능한 설정을 제공합니다. ## [](https://ailoot.ai/docs/ko/#key)키 받기 1. **회원가입** 계정을 만들 주소: [ailoot.ai/register](https://ailoot.ai/register). 이후 로그인 주소: [ailoot.ai/login](https://ailoot.ai/login). 2. **잔액을 충전하세요** 대시보드에서 «요금» 메뉴를 여세요. $18부터 일회성 충전 또는 잔액 보너스가 있는 구독을 선택하세요. 자세한 내용: [충전](https://ailoot.ai/docs/ko/billing/topup/) 및 [구독](https://ailoot.ai/docs/ko/billing/subscriptions/). 3. **API 키 생성** 대시보드 키 메뉴에서 새 키를 만드세요. 키의 시작 문자열: `sk-`. 대시보드 키 메뉴에서 복사할 수 있습니다. 비밀번호처럼 보관하세요. 키를 환경 변수에 저장 ```bash export AILOOT_API_KEY="sk-..." # 확인: 모델 목록이 반환되어야 합니다 curl -s https://api.ailoot.ai/v1/models -H "Authorization: Bearer $AILOOT_API_KEY" | head -c 300 ``` ## [](https://ailoot.ai/docs/ko/#first-request)첫 요청 보내기 API 주소: `https://api.ailoot.ai`. OpenAI 형식 SDK의 기본 주소: `https://api.ailoot.ai/v1`, Anthropic 및 Gemini의 기본 주소: `https://api.ailoot.ai` — 접미사 없이 사용합니다. SDK가 경로를 자동 추가합니다. ```bash curl https://api.ailoot.ai/v1/chat/completions \ -H "Authorization: Bearer $AILOOT_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "claude-sonnet-5-5", "messages": [ {"role": "user", "content": "API가 무엇인지 두 문장으로 설명해 줘."} ] }' ``` ```python from openai import OpenAI import os client = OpenAI(max_retries=0, base_url="https://api.ailoot.ai/v1", api_key=os.environ["AILOOT_API_KEY"], ) resp = client.chat.completions.create( model="claude-sonnet-5-5", messages=[{"role": "user", "content": "API가 무엇인지 두 문장으로 설명해 줘."}], ) print(resp.choices[0].message.content) ``` ```js import OpenAI from "openai"; const client = new OpenAI({ maxRetries: 0, baseURL: "https://api.ailoot.ai/v1", apiKey: process.env.AILOOT_API_KEY, }); const resp = await client.chat.completions.create({ model: "claude-sonnet-5-5", messages: [{ role: "user", content: "API가 무엇인지 두 문장으로 설명해 줘." }], }); console.log(resp.choices[0].message.content); ``` ```python import anthropic import os client = anthropic.Anthropic(max_retries=0, base_url="https://api.ailoot.ai", # /v1 제외: SDK가 /v1/messages를 자동으로 추가합니다 api_key=os.environ["AILOOT_API_KEY"], ) msg = client.messages.create( model="claude-sonnet-5-5", max_tokens=1024, messages=[{"role": "user", "content": "API가 무엇인지 두 문장으로 설명해 줘."}], ) print(msg.content[0].text) ``` 익숙한 형식으로 응답합니다. 블록 `usage` 에는 질문·응답에 사용한 토큰 수가 있으며 이를 기준으로 차감액을 계산합니다. 200 OK ```json { "id": "chatcmpl-8f2c…", "object": "chat.completion", "created": 1790812800, "model": "claude-sonnet-5-5", "choices": [ { "index": 0, "message": { "role": "assistant", "content": "API는 한 프로그램이 다른 프로그램에 어떤 작업을 요청하는 방법을 정한 약속입니다…" }, "finish_reason": "stop" } ], "usage": { "prompt_tokens": 21, "completion_tokens": 48, "total_tokens": 69 } } ``` ## [](https://ailoot.ai/docs/ko/#streaming)스트리밍 응답 설정 `"stream": true` 사용 시 원본 API처럼 Server-Sent Events로 응답하므로 SDK와 클라이언트가 변경 없이 파싱합니다. OpenAI SDK에서 다음 최종 값을 요청하면 편리합니다: `usage` — 마지막 이벤트로 반환합니다. Ailoot는 유료 텍스트 응답을 비용 계산 후 전달합니다. 따라서 설정 `stream: true` 사용 시 SSE 형식은 유지되지만 텍스트는 모델이 완료한 뒤 한 번에 전달되며 단어별로 전달되지 않습니다. 약 15초 이상 걸리면 Chat Completions, Responses, Messages 스트림에서 먼저 서비스용 줄 `: ping` 이 약 10초 간격으로 오고, 다음 줄 `: ailoot-charged-usd …` 에는 차감 금액이 담기며, 그 뒤에 실제 응답 데이터가 전달됩니다. SDK는 이러한 서비스용 줄을 건너뜁니다. ```python stream = client.chat.completions.create( model="gpt-6.1-sol", messages=[{"role": "user", "content": "비에 관한 하이쿠를 써 줘"}], stream=True, stream_options={"include_usage": True}, ) for chunk in stream: if chunk.choices and chunk.choices[0].delta.content: print(chunk.choices[0].delta.content, end="", flush=True) ``` ```js const stream = await client.chat.completions.create({ model: "gpt-6.1-sol", messages: [{ role: "user", content: "비에 관한 하이쿠를 써 줘" }], stream: true, stream_options: { include_usage: true }, }); for await (const chunk of stream) { process.stdout.write(chunk.choices[0]?.delta?.content ?? ""); } ``` ```bash curl -N https://api.ailoot.ai/v1/chat/completions \ -H "Authorization: Bearer $AILOOT_API_KEY" \ -H "Content-Type: application/json" \ -d '{"model": "gpt-6.1-sol", "stream": true, "messages": [{"role": "user", "content": "비에 관한 하이쿠를 써 줘"}]}' ``` ## [](https://ailoot.ai/docs/ko/#models)모델 선택 필드 `model` — 정확한 식별자 확인 위치: [모델 카탈로그](https://ailoot.ai/models/ko/) 또는 응답 `GET /v1/models`. 여러 모델에 짧은 별칭이 있습니다. 예: `claude-sonnet-latest` 또는 `qwen`. 별칭이 현재 가리키는 모델은 카탈로그를 확인하세요. 재현 가능한 결과에는 정확한 ID를 사용하세요. | 작업 | 시작할 모델 | | --- | --- | | 코드와 에이전트 | `claude-sonnet-5-5`, `gpt-6.1-sol`, `claude-opus-5-5` | | 빠르고 저렴하게 | `gemini-3.8-flash`, `deepseek-v4.1-flash`, `qwen3.8-flash` | | 최대 1M토큰의 긴 컨텍스트 | `claude-sonnet-5-5`, `deepseek-v4-pro`, `qwen3.8-max` | | 이미지 | `gpt-image-2.5`, `gemini-3.1-flash-image`, `grok-imagine-image-2.0` | 모든 모델이 모든 형식에서 제공되는 것은 아닙니다. 예를 들어 Gemini 모델은 Anthropic Messages 및 네이티브 Gemini 형식으로 동작하며, OpenAI Chat에서는 다음 모델만 지원합니다: `gemini-3.6-flash`. 모델별 지원 형식 확인 위치: [카탈로그](https://ailoot.ai/models/ko/). ## [](https://ailoot.ai/docs/ko/#next)다음 단계 [**작동 방식** 요청 처리 과정, 금액 예약·차감, 오류](https://ailoot.ai/docs/ko/how-it-works/) [**호환성** 지원 형식과 클라이언트](https://ailoot.ai/docs/ko/compatibility/) [**연동** 설정이 준비된 앱 77개](https://ailoot.ai/integrations/ko/) [**오류와 제한** 응답 코드와 처리 방법](https://ailoot.ai/docs/ko/errors/) 궁금한 점이 남았나요? Request ID와 설명을 보내 주시면 해결을 도와드리겠습니다.[지원팀에 문의](mailto:support@ailoot.ai) Claude Code, OpenCode, Hermes, 자체 앱에 Ailoot를 연결하세요. ## 회사와 그 프로젝트 포트폴리오 회사와 그 프로젝트 포트폴리오: 수백만 고객, 매월 수십억 규모의 매출. ## 할인받아 토큰을 구매하세요. 정기 작업에는 구독 할인, 토큰 구매에는 최대 50% 프로모션 코드. 구독 정기 요청에 맞는 할인 요금제를 선택하세요. 최대 50% 프로모션 코드 구매할 때 코드를 넣으면 진행 중 행사에 따라 가격을 다시 계산합니다. 이력의 지출 요청마다 모델, 토큰, 금액을 저장합니다. [구독 선택](https://ailoot.ai/docs/ko/billing/subscriptions/) · [모델 가격 보기](https://ailoot.ai/models/ko/) ## 판매하는 제품에 API를 연결하세요. Ailoot 공식 이용 조건과 라이선스 계약으로 SaaS, 앱, 봇에 사용하세요. 재판매에는 리셀러 라이선스를 요청하세요. 상업용 앱 서비스의 유료 기능에 텍스트, 이미지, 영상, 소리 생성을 넣으세요. 리셀러 라이선스 프로젝트 설명과 접근 구조를 보내 사용·재판매의 서면 조건을 요청하세요. 사이트의 문서 연결 전에 공식 이용 조건, 라이선스 계약, 데이터 처리 정책을 읽을 수 있습니다. [리셀러 라이선스 요청](mailto:support@ailoot.ai) · [공식 이용 조건과 라이선스 계약](https://ailoot.ai/legal/offer?lang=ko) ## 자주 묻는 질문 첫 API 요청은 어떻게 보내나요? Ailoot API 키를 만드세요. OpenAI SDK에는 https://api.ailoot.ai/v1 을, Anthropic 및 Gemini SDK에는 https://api.ailoot.ai 를 설정하세요. GET /v1/models 는 무료이며 키로 이용할 수 있는 모델 목록을 제공합니다. 그런 다음 선택한 모델과 API 메서드의 예제를 사용하세요. 어떤 API 키를 사용해야 하나요? 계정에서 발급한 Ailoot API 키를 선택한 클라이언트 형식의 인증 필드에 입력하세요. 동일한 키로 GET /v1/models 를 보내면 해당 키로 이용할 수 있는 모델을 무료로 확인할 수 있습니다. 다른 서비스의 키로는 Ailoot에 접근할 수 없습니다. 첫 요청이 실패하면 무엇을 확인해야 하나요? API 주소, Ailoot API 키, 정확한 모델 ID, API 메서드를 모델 카드 및 요청 예제와 대조하세요. 반환된 오류를 읽어 보세요. 도움이 필요하면 API 키를 제외하고 오류와 요청 ID를 support@ailoot.ai 로 보내세요. 구독의 혜택은 무엇인가요? 정기 작업용 토큰 구매 할인입니다. 요청량에 맞는 요금제를 선택하고 가입 화면에서 조건·가격을 확인하세요. 최대 50% 코드는 어떻게 적용하나요? 토큰 구매 때 입력하면 행사 조건에 따라 다시 계산하며 결제 전에 할인율이 보입니다. ## AI API 가격과 연결 방법 ### Ailoot AI API 키는 어디에서 만들 수 있나요? 대시보드 키 메뉴에서 새 키를 만드세요. 키의 시작 문자열: sk-. 대시보드 키 메뉴에서 복사할 수 있습니다. 비밀번호처럼 보관하세요. ### OpenAI·Anthropic·Gemini 형식의 AI API 기본 주소는 어떻게 설정하나요? API 주소: https://api.ailoot.ai. OpenAI 형식 SDK의 기본 주소: https://api.ailoot.ai/v1, Anthropic 및 Gemini의 기본 주소: https://api.ailoot.ai — 접미사 없이 사용합니다. SDK가 경로를 자동 추가합니다. ### AI API 비용을 줄이는 구독 할인과 최대 50% 프로모션 코드가 있나요? 정기 작업에는 구독 할인, 토큰 구매에는 최대 50% 프로모션 코드. ### AI API를 유료 제품에 연결하거나 재판매할 수 있나요? 네. 공식 이용 조건과 계약으로 SaaS, 앱, 봇에 연결하세요. 재판매는 프로젝트별 서면 조건과 라이선스를 요청하세요. ## Ailoot · 회사와 그 프로젝트 포트폴리오 Ailoot는 축적된 운영 경험, 폭넓은 고객 기반, 안정적인 서비스, 지속적인 KPI 관리를 바탕으로 합니다. 회사와 그 프로젝트 포트폴리오: 수백만 고객, 매월 수십억 규모의 매출. Ailoot는 이러한 운영 경험을 고객의 제품, 에이전트, 애플리케이션, 자동화에서 AI 기능을 이용할 수 있는 API 접근에 활용합니다.