채팅 API

사용 가능

OpenAI 호환 엔드포인트 하나로 채팅 모델을 사용하세요. 기본 URL만 바꾸면 코드는 그대로입니다.

14개 모델 중 100만 토큰당 입력 $0.039 / 출력 $0.182부터최저가gpt-oss-20b

$0.039/100만 토큰부터

시스템 프롬프트선택messagesrole이 system인 첫 메시지로 보냅니다.

최대 출력 토큰max_tokens답변이 이 토큰 수에서 멈춥니다.1,024 토큰

1~117,964. 답변은 여기서 멈추며, 이번 실행 가격은 이를 모두 포함합니다.

입력 토큰 100만 개당 $0.039 · 출력 토큰 100만 개당 $0.182

준비됨

출력 예시

Explain in two short sentences why the sky is blue.

gpt-oss-20b

The air in the atmosphere scatters sunlight, and Rayleigh scattering is far more efficient at bending short‑wavelength (blue) light than longer wavelengths. As a result, the blue component is scattered in all directions, filling the sky with a blue hue.

또는 이렇게 시작하세요

출력 최대 1,024 토큰출력 최대 1,024 토큰

채팅 API 모델 비교

이 엔드포인트의 모든 모델을 실시간 가격과 함께 보여 줍니다. 플레이그라운드에서 써 보거나 모델 페이지를 여세요.

gpt-oss-20bOpenAI100만 토큰당 입력 $0.039 / 출력 $0.182
최저가
페이지
gpt-oss-120bOpenAI100만 토큰당 입력 $0.0481 / 출력 $0.221
페이지
DeepSeek V4 FlashDeepSeek100만 토큰당 입력 $0.078 / 출력 $0.234
페이지
DeepSeek V4.1 FlashDeepSeek100만 토큰당 입력 $0.102 / 출력 $0.3058
제조사 가격과 동일
페이지
Nemotron 3 SuperNVIDIA100만 토큰당 입력 $0.1105 / 출력 $0.52
페이지
Qwen3 235B A22B Instruct 2507Alibaba (Qwen)100만 토큰당 입력 $0.117 / 출력 $0.715
페이지
Llama 3.3 70BMeta100만 토큰당 입력 $0.13 / 출력 $0.416
페이지
Llama 4 ScoutMeta100만 토큰당 입력 $0.13 / 출력 $0.39
페이지
Qwen3.6 35B A3BAlibaba (Qwen)100만 토큰당 입력 $0.13 / 출력 $1.235
100만 토큰당 입력 $0.248 / 출력 $1.485-16%
페이지
Nemotron 3.5 Super VLNVIDIA100만 토큰당 입력 $0.195 / 출력 $0.65
페이지
Qwen3.8 27BAlibaba (Qwen)100만 토큰당 입력 $0.195 / 출력 $2.438
제작사 가격보다 낮음
페이지
Gemma 4 31BGoogle100만 토큰당 입력 $0.26 / 출력 $0.52
페이지
DeepSeek V3.2DeepSeek100만 토큰당 입력 $0.338 / 출력 $0.494
페이지
GLM-4.7Z.ai100만 토큰당 입력 $0.52 / 출력 $2.20
제조사 가격과 동일
페이지

이 도구의 모든 모델과 가격
		공식			길이 / 크기	배지	작업
gpt-oss-20bOpenAI	100만 토큰당 입력 $0.039 / 출력 $0.182	공식 가격 없음	—	—	131K 토큰	최저가	페이지
gpt-oss-120bOpenAI	100만 토큰당 입력 $0.0481 / 출력 $0.221	공식 가격 없음	—	—	131K 토큰		페이지
DeepSeek V4 FlashDeepSeek	100만 토큰당 입력 $0.078 / 출력 $0.234	공식 가격 없음	—	—	1M 토큰		페이지
DeepSeek V4.1 FlashDeepSeek	100만 토큰당 입력 $0.102 / 출력 $0.3058	제조사 가격과 동일	—	—	1M 토큰		페이지
Nemotron 3 SuperNVIDIA	100만 토큰당 입력 $0.1105 / 출력 $0.52	공식 가격 없음	—	—	262K 토큰		페이지
Qwen3 235B A22B Instruct 2507Alibaba (Qwen)	100만 토큰당 입력 $0.117 / 출력 $0.715	공식 가격 없음	—	—	262K 토큰		페이지
Llama 3.3 70BMeta	100만 토큰당 입력 $0.13 / 출력 $0.416	공식 가격 없음	—	—	131K 토큰		페이지
Llama 4 ScoutMeta	100만 토큰당 입력 $0.13 / 출력 $0.39	공식 가격 없음	—	—	328K 토큰		페이지
Qwen3.6 35B A3BAlibaba (Qwen)	100만 토큰당 입력 $0.13 / 출력 $1.235	100만 토큰당 입력 $0.248 / 출력 $1.485	-16%	—	262K 토큰		페이지
Nemotron 3.5 Super VLNVIDIA	100만 토큰당 입력 $0.195 / 출력 $0.65	공식 가격 없음	—	—	262K 토큰		페이지
Qwen3.8 27BAlibaba (Qwen)	100만 토큰당 입력 $0.195 / 출력 $2.438	제작사 가격보다 낮음	—	—	262K 토큰		페이지
Gemma 4 31BGoogle	100만 토큰당 입력 $0.26 / 출력 $0.52	공식 가격 없음	—	—	262K 토큰		페이지
DeepSeek V3.2DeepSeek	100만 토큰당 입력 $0.338 / 출력 $0.494	공식 가격 없음	—	—	164K 토큰		페이지
GLM-4.7Z.ai	100만 토큰당 입력 $0.52 / 출력 $2.20	제조사 가격과 동일	—	—	203K 토큰		페이지

코드에서 채팅 API 호출하기

위의 모든 모델을 엔드포인트 하나로. model 필드만 바꾸면 전환됩니다.

POSThttps://api.opennan.com/v1/chat/completions

GET/v1/models?category=text이 엔드포인트의 모든 모델과 가격

API 키 받기
콘솔에서 키를 만드세요. 플레이그라운드와 같은 잔액을 씁니다.
키 만들기

첫 요청 보내기

플레이그라운드가 보내는 것과 같은 요청입니다. OPENNAN_KEY에 키를 넣으세요.

curl -N https://api.opennan.com/v1/chat/completions \
  -H "Authorization: Bearer $OPENNAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-oss-20b","messages":[{"role":"user","content":"밤의 도시에 관한 하이쿠를 써 주세요."}],"max_tokens":1024,"temperature":1,"top_p":1,"stream":true,"stream_options":{"include_usage":true}}'

결과 읽기
결과는 같은 응답으로 옵니다. X-Usage-Cost-Usd 헤더에 호출 비용이 나옵니다.

파라미터

실시간 카탈로그로 만든 표입니다. 여기 있는 값은 모두 API가 받습니다.

파라미터
이름	형식	허용 값	기본값	가격 영향
`model`필수호출을 실행할 모델.	문자열	—	—	—
`messages`필수지금까지의 대화. 역할과 내용의 쌍으로 보냅니다.	메시지 목록	—	—	—
`max_tokens`선택답변의 최대 길이(토큰).	정수	1–131,072	—	출력 토큰당 과금
`temperature`선택높을수록 답변이 다양해집니다.	숫자	—	—	—
`stream`선택작성되는 대로 답변을 조금씩 보냅니다.	불리언	—	—	—
`tools`선택모델이 호출할 수 있는 함수.	목록	—	—	—

오류와 해결 방법

401키가 없거나 틀림
콘솔에서 만든 키를 Authorization: Bearer 헤더로 보내세요.
402잔액 부족
결제 메뉴에서 잔액을 충전한 뒤 같은 호출을 다시 보내세요.
400받을 수 없는 값
error.message에 필드 이름이 나옵니다. 파라미터 표의 값을 쓰세요.
429요청이 너무 많음
몇 초 기다렸다가 다시 시도하고, 429가 반복되면 더 오래 기다리세요.

AI 앱에 Opennan 추가하기

한 번 설치하면 AI가 Opennan의 모든 도구를 씁니다: 영상, 이미지, 채팅, 음성, 음악, 효과음, 3D, 자막, 더빙. 사용하는 앱을 고르고 단계를 따라 하세요.

MCP 서버https://api.opennan.com/v1/mcp

Codex CLI, Codex 앱, Codex IDE 확장에서 모두 작동합니다(~/.codex/config.toml 공유). 앱이나 IDE가 OPENNAN_KEY를 못 읽으면 키를 넣은 config.toml 방식을 쓰세요. Codex는 도구를 호출하기 전에 묻습니다. 승인하면 계속됩니다.

API 키 받기
콘솔에서 키를 만드세요. sk-로 시작하며 웹사이트와 같은 잔액을 씁니다.
키 만들기

키를 OPENNAN_KEY로 저장

# macOS / Linux (zsh shown; bash: ~/.bashrc)
echo 'export OPENNAN_KEY="sk-..."' >> ~/.zshrc
source ~/.zshrc

# Windows (PowerShell), then open a new terminal
setx OPENNAN_KEY "sk-..."

3
Opennan 플러그인 설치: 서버와 함께 모델 선택, 가격 확인, 결과 대기를 AI에게 알려 주는 스킬이 들어 있습니다
```
codex plugin marketplace add Opennan/opennan-ai-plugin
codex plugin add opennan@opennan
```

또는 서버만 추가

codex mcp add opennan --url https://api.opennan.com/v1/mcp --bearer-token-env-var OPENNAN_KEY

또는 ~/.codex/config.toml에 추가

[mcp_servers.opennan]
url = "https://api.opennan.com/v1/mcp"
http_headers = { Authorization = "Bearer sk-..." }

4
opennan이 목록에 있는지 확인
```
codex mcp list
```
Codex을 다시 시작하고 무엇이든 요청하세요
“네온 거리에 내리는 비 5초 영상, 어울리는 노래, 포스터 이미지를 만들어 줘.”

sk-...를 내 키로 바꾸고 비공개로 두세요. 키를 가진 사람은 잔액을 쓸 수 있습니다. 키가 없어도 도구 목록은 보이지만 만들려면 키가 필요합니다.

AI 에이전트에서 사용하기

에이전트에 Opennan MCP 서버를 추가하고 이 도구를 호출하세요.

도구: chat
예시 인수: { "model": "gpt-oss-20b", "messages": [ { "role": "user", "content": "밤의 도시에 관한 하이쿠를 써 주세요." } ] }

채팅 API: 자주 묻는 질문

모든 모델과 가격

채팅 API 요금은 얼마인가요?

gpt-oss-20b로 100만 토큰당 입력 $0.039 / 출력 $0.182부터이며, 여기 있는 14개 모델 중 가장 저렴합니다. 실행 전에 가격이 표시됩니다.

코드에서 어떻게 호출하나요?

API 키와 함께 POST https://api.opennan.com/v1/chat/completions를 보내세요. 결과는 같은 응답으로 옵니다.

코드를 바꾸지 않고 모델을 바꿀 수 있나요?

네. model 필드만 바꾸고 나머지 요청, 같은 키, 같은 잔액은 그대로 두면 됩니다.

AI 에이전트가 쓸 수 있나요?

네. MCP 서버 https://api.opennan.com/v1/mcp를 추가해 chat 도구를 호출하거나, 에이전트에게 https://api.opennan.com/llms.txt를 알려 주세요.

실행이 실패하면 어떻게 되나요?

실패한 요청은 청구되지 않습니다. 사용한 토큰만 결제합니다.