Source: https://ailoot.ai/docs/ko/connect/curl/
Canonical: https://ailoot.ai/docs/ko/connect/curl/
Language: ko

[연결](https://ailoot.ai/docs/ko/) 

# HTTP 요청(curl)

[Markdown](https://ailoot.ai/docs/ko/connect/curl/index.md)

SDK 없이 API 사용: HTTP 요청을 보낼 수 있는 모든 언어와 도구에서 사용합니다.

모든 요청의 대상 주소: `https://api.ailoot.ai` — HTTPS로 보내며 본문은 JSON입니다(파일 업로드는 multipart). 키는 인증 헤더 중 하나에 넣습니다.

변수에 키 저장

```bash
export AILOOT_API_KEY="sk-..."
```

## [](https://ailoot.ai/docs/ko/connect/curl/#chat)OpenAI Chat Completions

```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가 무엇인지 두 문장으로 설명해 줘."}
    ]
  }' 
```

## [](https://ailoot.ai/docs/ko/connect/curl/#stream)스트리밍 응답

플래그 `-N` 는 curl 버퍼링을 해제해 이벤트가 도착하자마자 표시되게 합니다. 각 이벤트의 시작: `data:`, 스트림의 종료 줄: `data: [DONE]`.

Ailoot는 유료 텍스트 응답을 비용 계산 후 전달합니다. 따라서 설정 `stream: true` 사용 시 SSE 형식은 유지되지만 텍스트는 모델이 완료한 뒤 한 번에 전달되며 단어별로 전달되지 않습니다. 약 15초 이상 걸리면 Chat Completions, Responses, Messages 스트림에서 먼저 서비스용 줄 `: ping` 이 약 10초 간격으로 오고, 다음 줄 `: ailoot-charged-usd …` 에는 차감 금액이 담기며, 그 뒤에 실제 응답 데이터가 전달됩니다. SDK는 이러한 서비스용 줄을 건너뜁니다.

```bash
curl -N https://api.ailoot.ai/v1/chat/completions \
  -H "Authorization: Bearer $AILOOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "deepseek-v4-pro", "stream": true,
       "messages": [{"role": "user", "content": "다섯까지 세어 줘"}]}' 
```

## [](https://ailoot.ai/docs/ko/connect/curl/#responses)OpenAI Responses

```bash
curl https://api.ailoot.ai/v1/responses \
  -H "Authorization: Bearer $AILOOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-6.1-sol", "input": "동료의 생일을 축하하는 건배사를 써 줘"}' 
```

## [](https://ailoot.ai/docs/ko/connect/curl/#messages)Anthropic Messages

```bash
curl https://api.ailoot.ai/v1/messages \
  -H "x-api-key: $AILOOT_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5-5",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "안녕! 어떤 일을 할 수 있어?"}]
  }' 
```

## [](https://ailoot.ai/docs/ko/connect/curl/#gemini)Gemini

```bash
curl "https://api.ailoot.ai/v1beta/models/gemini-3.8-flash:generateContent" \
  -H "x-goog-api-key: $AILOOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {"role": "user", "parts": [{"text": "카페 이름 세 가지를 제안해 줘."}]}
    ]
  }' 
```

## [](https://ailoot.ai/docs/ko/connect/curl/#models)모델 목록

```bash
curl -s https://api.ailoot.ai/v1/models \
  -H "Authorization: Bearer $AILOOT_API_KEY" | jq -r '.data[].id'
```

## [](https://ailoot.ai/docs/ko/connect/curl/#headers)응답 헤더

헤더를 보려면 다음을 추가하세요: `-i` — 응답 헤더를 표시합니다. `X-Request-ID` — 요청 식별자이며 오류 메시지에도 동일하게 표시됩니다. `X-Ailoot-Charged-USD` — 유료 텍스트 응답의 차감 금액입니다. 전체 헤더 설명 페이지: [작동 방식](https://ailoot.ai/docs/ko/how-it-works/#headers).

궁금한 점이 남았나요? Request ID와 설명을 보내 주시면 해결을 도와드리겠습니다.[지원팀에 문의](mailto:support@ailoot.ai)

## Ailoot · 회사와 그 프로젝트 포트폴리오





Ailoot는 축적된 운영 경험, 폭넓은 고객 기반, 안정적인 서비스, 지속적인 KPI 관리를 바탕으로 합니다.





회사와 그 프로젝트 포트폴리오: 수백만 고객, 매월 수십억 규모의 매출.





Ailoot는 이러한 운영 경험을 고객의 제품, 에이전트, 애플리케이션, 자동화에서 AI 기능을 이용할 수 있는 API 접근에 활용합니다.