문서

API 레퍼런스 및 설정

ck_ API 키 하나로 Claude Code, OpenCode, Codex CLI, Gemini CLI, Cursor, 직접 HTTP 호출까지 모두 사용할 수 있습니다. 공식 공급자 정가, 청구서 하나 — 사용한 만큼 결제, 구독 불필요.

1. 시작하기

Zenn.Engineering은 Anthropic, OpenAI, Google AI 모델과 이미지 생성을 위한 드롭인 API 게이트웨이입니다. 모든 곳에서 ck_ 접두사가 붙은 키 하나만 사용 — 코드 변경 없이 도구를 베이스 URL로 가리키기만 하면 됩니다.

1. API 키 발급

/pricing에서 요금제를 선택한 다음, /manage-api-keys에서 키를 생성하세요.

2. 베이스 URL 설정

도구를 https://zenn.engineering/api/v1로 가리키도록 설정하세요.

3. 빌드

Claude Code, OpenCode, Codex CLI, Gemini CLI, Cursor, 그리고 OpenAI/Anthropic 호환 클라이언트라면 무엇이든 작동합니다.

2. 베이스 URL

키 하나로 프로토콜 호환 베이스 URL 3개(Anthropic / OpenAI / Gemini)와 이미지 생성 엔드포인트까지 사용할 수 있습니다.

서피스	베이스 URL	함께 사용
Anthropic 호환	https://zenn.engineering/api/v1	Claude Code, Anthropic SDK, OpenCode (anthropic provider)
OpenAI 호환 (Codex)	https://zenn.engineering/api/v1/codex	Codex CLI, OpenAI SDK, Cursor
Gemini 호환	https://zenn.engineering/api/v1/gemini	Gemini CLI, Google AI SDK
이미지 생성	https://zenn.engineering/api/v1/images/generations	gpt-image-2 (OpenAI 호환 페이로드)

3. Claude Code

Anthropic의 공식 Claude CLI. 환경 변수 두 개만 설정하면 드롭인 대체로 작동합니다.

1단계 — 환경 설정

셸 프로필(~/.zshrc 또는 ~/.bashrc)에 추가하세요:

shell

export ANTHROPIC_BASE_URL=https://zenn.engineering/api/v1
export ANTHROPIC_API_KEY=ck_YOUR_API_KEY

2단계 — 재시작 후 실행

terminal

# Default model (Sonnet 4.6)
claude

# Pick a different model
claude --model claude-opus-4-7
claude --model claude-haiku-4-5

동작 원리

Claude Code는 x-api-key 헤더(Anthropic SDK 네이티브)로 API 키를 전송하고 베이스 URL에 /messages를 붙입니다. anthropic-version과 anthropic-beta 헤더 모두 업스트림으로 전달됩니다. SSE를 통한 스트리밍을 지원합니다.

4. OpenCode

멀티 공급자 AI 코딩 에이전트. JSON 설정 하나로 키 하나에서 Claude, GPT-5, Gemini를 모두 사용할 수 있습니다.

1단계 — 설치

terminal

npm i -g opencode-ai

2단계 — 설정 파일 생성

~/.config/opencode/opencode.json을 편집하세요:

opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "anthropic": {
      "options": {
        "baseURL": "https://zenn.engineering/api/v1",
        "apiKey": "ck_YOUR_API_KEY"
      },
      "models": {
        "claude-opus-4-7": { "name": "Claude Opus 4.7" },
        "claude-sonnet-4-6": { "name": "Claude Sonnet 4.6" },
        "claude-haiku-4-5": { "name": "Claude Haiku 4.5" }
      }
    },
    "zenn-codex": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Zenn Codex",
      "options": {
        "baseURL": "https://zenn.engineering/api/v1/codex",
        "apiKey": "ck_YOUR_API_KEY"
      },
      "models": {
        "gpt-5.5": { "name": "GPT-5.5" },
        "gpt-5.5-pro": { "name": "GPT-5.5 Pro" },
        "gpt-5.5-instant": { "name": "GPT-5.5 Instant" },
        "gpt-5.4": { "name": "GPT-5.4" },
        "gpt-5.3-codex": { "name": "GPT-5.3 Codex" }
      }
    },
    "zenn-gemini": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Zenn Gemini",
      "options": {
        "baseURL": "https://zenn.engineering/api/v1/gemini",
        "apiKey": "ck_YOUR_API_KEY"
      },
      "models": {
        "gemini-3.1-pro-preview": { "name": "Gemini 3.1 Pro" },
        "gemini-3-pro-preview": { "name": "Gemini 3 Pro" },
        "gemini-3-flash-preview": { "name": "Gemini 3 Flash" }
      }
    },
    "zenn-chinese": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Zenn Chinese (DeepSeek / Moonshot / Zhipu)",
      "options": {
        "baseURL": "https://zenn.engineering/api/v1/codex",
        "apiKey": "ck_YOUR_API_KEY"
      },
      "models": {
        "deepseek-v4-pro": { "name": "DeepSeek V4 Pro" },
        "deepseek-v4-flash": { "name": "DeepSeek V4 Flash" },
        "kimi-k2.6": { "name": "Kimi K2.6" },
        "glm-5.1": { "name": "GLM-5.1" }
      }
    }
  }
}

3단계 — 실행

terminal

opencode

5. Codex CLI

OpenAI의 공식 GPT-5 / Codex 패밀리 CLI. 환경 변수 두 개를 설정하고 Codex 베이스 URL을 가리키게 하세요.

환경 설정

shell

export OPENAI_BASE_URL=https://zenn.engineering/api/v1/codex
export OPENAI_API_KEY=ck_YOUR_API_KEY

실행

terminal

# Default
codex

# Pick a model
codex --model gpt-5.5
codex --model gpt-5.5-pro
codex --model gpt-5.5-instant
codex --model gpt-5.3-codex

# Chinese coding models (via OpenAI-compatible /v1/codex)
codex --model deepseek-v4-pro
codex --model kimi-k2.6
codex --model glm-5.1

Codex CLI는 Authorization: Bearer와 OpenAI /chat/completions + /responses 형식을 사용 — 둘 다 지원됩니다.

6. Gemini CLI

Google Gemini CLI는 x-goog-api-key로 키를 전송합니다. 프록시는 이 헤더를 그대로 받아들입니다.

환경 설정

shell

export GEMINI_BASE_URL=https://zenn.engineering/api/v1/gemini
export GEMINI_API_KEY=ck_YOUR_API_KEY

실행

terminal

gemini --model gemini-3.1-pro-preview
gemini --model gemini-3-flash-preview

7. Cursor IDE

Cursor → Settings → Models → "Custom OpenAI Model":

필드	값
Override OpenAI Base URL	https://zenn.engineering/api/v1/codex
OpenAI API Key	ck_YOUR_API_KEY
Add custom models	gpt-5.5, gpt-5.5-pro, gpt-5.5-instant, gpt-5.4, gpt-5.3-codex, deepseek-v4-pro, kimi-k2.6, glm-5.1

저장 후 Verify를 클릭하세요 — Cursor가 베이스 URL의 /models를 호출하여 키가 작동하는지 확인합니다.

8. Direct API (cURL)

프로토콜 형식 3가지, 키 1개. 클라이언트가 이미 사용하는 형식을 선택하세요.

Anthropic 호환 — /v1/messages

cURL · Claude

curl -X POST https://zenn.engineering/api/v1/messages \
  -H "x-api-key: ck_YOUR_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello, Claude"}]
  }'

OpenAI 호환 — /v1/codex/chat/completions

cURL · GPT-5.5

curl -X POST https://zenn.engineering/api/v1/codex/chat/completions \
  -H "Authorization: Bearer ck_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "messages": [{"role": "user", "content": "Hello, GPT-5.5"}],
    "stream": true
  }'

Gemini — /v1/gemini/chat/completions

cURL · Gemini

curl -X POST https://zenn.engineering/api/v1/gemini/chat/completions \
  -H "Authorization: Bearer ck_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3.1-pro-preview",
    "messages": [{"role": "user", "content": "Hello, Gemini"}]
  }'

9. 이미지 생성

gpt-image-2가 현재 API로 라우팅 가능한 유일한 이미지 모델입니다. 해상도 등급(1K / 2K / 4K)은 단일 정액 요금으로 청구됩니다 — 자세한 내용은 모델 섹션 참조. 다른 이미지, 비디오, 오디오 모델은 출시 예정으로 표시됩니다.

엔드포인트

POST https://zenn.engineering/api/v1/images/generations
GET  https://zenn.engineering/api/v1/images/generations  (list models)

이미지 생성

cURL · gpt-image-2

curl -X POST https://zenn.engineering/api/v1/images/generations \
  -H "Authorization: Bearer ck_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "A cinematic photo of a small red apple on a marble countertop",
    "n": 1
  }'

비동기 동작

DocsPage.imageGen.asyncBody

브라우저 채팅에서

/chat을 열고 모델 선택기에서 "GPT Image 2 — Image Generation"을 선택한 뒤 프롬프트를 보내면 이미지가 인라인으로 렌더링됩니다. 서버가 업스트림을 폴링해주며 이미지당 6 크레딧($0.06)이 청구됩니다.

크레딧 기반 청구 (1,000,000 크레딧 = $1.00). LLM 가격은 각 제공업체의 공식 백만 토큰당 가격이며, 이미지는 생성당 가격입니다. 출시 예정 태그가 있는 모델은 등재되어 있지만 활성화되기 전까지 API에서 거부됩니다. 모든 모델은 공식 정가로 소진됩니다 — 충전 시점의 크레딧 배수(Pro 1×, Max 4×, Enterprise 6×)에서 가치가 발생합니다. 자세한 플랜 정보는 12절을 참고하세요.

Claude (Anthropic)

모델 ID	입력 / MTok	출력 / MTok	캐시 읽기	상태
claude-opus-4-7	$15.00	$75.00	$1.50	라이브
claude-opus-4-6	$15.00	$75.00	$1.50	라이브
claude-sonnet-4-6	$3.00	$15.00	$0.30	라이브
claude-haiku-4-5	$1.00	$5.00	$0.10	라이브

OpenAI / GPT

모델 ID	입력 / MTok	출력 / MTok	캐시 읽기	상태
gpt-5.5	$5.00	$30.00	$0.50	라이브
gpt-5.5-instant	$5.00	$30.00	$0.50	라이브
gpt-5.5-pro	$30.00	$180.00	$30.00	라이브
gpt-5.4	$5.00	$22.50	$0.50	라이브
gpt-5.3-codex	$1.75	$14.00	$0.17	라이브
gpt-5.2	$1.75	$14.00	$0.17	라이브

Gemini (Google)

모델 ID	입력 / MTok	출력 / MTok	캐시 읽기	상태
gemini-3.1-pro-preview	$4.00	$18.00	$0.40	라이브
gemini-3-pro-preview	$4.00	$18.00	$0.40	라이브
gemini-3-flash-preview	$0.50	$3.00	$0.05	라이브

DeepSeek / Moonshot / Zhipu

모델 ID	입력 / MTok	출력 / MTok	캐시 읽기	상태
deepseek-v4-pro	$1.74	$3.48	$0.01	라이브
deepseek-v4-flash	$0.14	$0.28	$0.0028	라이브
kimi-k2.6	$0.95	$4.00	$0.16	라이브
glm-5.1	$1.40	$4.40	$0.26	라이브

이미지 (라이브)

모델 ID	이미지당 크레딧	이미지당 가격	상태
gpt-image-2	60000	$0.06	라이브

모든 이미지, 비디오, 오디오 모델은 공식 정가로 소진됩니다. 다른 이미지 모델(Nano Banana 패밀리, Gemini 3 Pro Image, Seedream)은 카탈로그에 등록되어 있지만 현재 출시 예정 — 활성화 전까지 API가 거부합니다. 전체 카탈로그는 /models를 참조하세요.

11. 인증

모든 API 키는 ck_ 접두사를 사용합니다. 프록시는 모든 표준 SDK 헤더 형식을 받아들이므로 클라이언트를 수정하지 않아도 작동합니다.

헤더	형식	사용 도구
x-api-key	ck_...	Claude Code, Anthropic SDK
Authorization	Bearer ck_...	OpenCode, Codex CLI, OpenAI SDK, cURL
anthropic-api-key	ck_...	대체 Anthropic 헤더
x-goog-api-key	ck_...	Gemini CLI

전달되는 헤더

anthropic-version (기본값 2023-06-01)와 anthropic-beta가 그대로 전달됩니다. SSE 스트리밍을 완벽히 지원합니다.

12. 요금제

일회성 충전 — 구독 없음. 각 충전 시 크레딧 배수(Pro 1×, Max 4×, Enterprise 6×)가 고정되어 해당 크레딧을 다 쓸 때까지 그 배수 가치가 유지됩니다. 이후 충전은 어떤 등급이든 가능합니다.

Pro

$10 · 10,000,000 크레딧

표준 가격. 사용한 만큼 결제.

· 모든 프런티어 LLM을 공식 정가로
· OpenAI / Anthropic / Gemini 호환 API
· 키별 지출 한도, 실시간 분석

Max

$100 · 400,000,000 크레딧

4× 크레딧 — $100으로 정가 기준 $400 사용량.

· Pro의 모든 기능
· 충전 시 1달러당 4× 크레딧
· 모든 모델에 동일한 정가 적용
· 우선 큐 + 더 빠른 라우팅

Enterprise

$1,000 · 6,000,000,000 크레딧

6× 크레딧 — $1,000으로 $6,000 사용량 + Anthropic Max 우선 채널.

· Max의 모든 기능
· 충전 시 1달러당 6× 크레딧
· 모든 모델에 동일한 정가 적용
· Anthropic Max 우선 채널
· 전담 지원, 감사 친화적 인보이스

단 하나의 가격 규칙, 모든 모델에 적용

· 모든 LLM, 이미지, 비디오, 오디오 모델은 /models에 표시된 공식 정가로 소진됩니다.
· Max ($100 → 4×)와 Enterprise ($1,000 → 6×)의 가치는 모델별 할인 등급이 아니라 충전 시 추가로 지급되는 크레딧에서 옵니다.
· 버킷 자격 요건도, 모델별 부가 조건도 없습니다 — 크레딧은 Claude Opus, GPT-5.5, Gemini Flash에서 동일하게 작동합니다.

배수는 충전 단위로 적용됩니다. 기존 Max 크레딧은 소진할 때까지 4× 가치를 유지합니다 — 그 후 Pro로 충전하면 $10당 20M 크레딧이 1×로 지급됩니다. 전체 분석은 /pricing을 참조하세요.

13. 속도 제한 및 오류

사용자별 속도 제한

엔드포인트	시간당 요청 수
/v1/messages, /v1/chat/completions, /v1/gemini	1,000
/v1/images/generations	500
/v1/responses, /v1/codex/*	1,000

속도 제한 상태는 응답 헤더로 반환됩니다: x-ratelimit-limit, x-ratelimit-remaining, x-ratelimit-reset.

오류 코드

상태	의미
401	API 키 누락 / 유효하지 않음
402	크레딧 부족 — /checkout에서 충전하세요
403	요청한 모델에 대한 등급 권한 없음 (예: Opus 4.7)
429	사용자별 속도 제한 도달
503	모델이 등록되어 있지만 출시 예정 상태
504	이미지 생성 타임아웃 (재시도 필요)

14. 출시 예정

공개적으로 등재되어 있지만, 크레딧 배수 모델 하의 마진이 안정될 때까지 API가 거부합니다：

이미지 (추가)

Nano Banana 패밀리, Gemini 3 Pro Image, Seedream, GPT-4o Image, Imagen.

비디오

Veo 3.1, Kling 3.0, Seedance 2.0, HappyHorse 1.0, MiniMax Hailuo, Vidu Q3, WAN 2.6.

오디오

Fish Audio TTS, Voice Clone, ASR.

전체 목록은 /models에서 확인하세요. 출시 예정 항목은 API에서 HTTP 503을 반환합니다. 오늘 호출해도 크레딧은 차감되지 않는 no-op입니다.

시작할 준비됐나요?

키 하나로 Claude Code, OpenCode, Codex CLI, Gemini CLI, Cursor 모두 사용 가능. 크레딧을 충전하고 API 키를 만드세요.

요금제 보기 API 키 관리

문서

API 레퍼런스 및 설정

1. 시작하기

1. API 키 발급

/pricing에서 요금제를 선택한 다음, /manage-api-keys에서 키를 생성하세요.

2. 베이스 URL 설정

도구를 https://zenn.engineering/api/v1로 가리키도록 설정하세요.

3. 빌드

Claude Code, OpenCode, Codex CLI, Gemini CLI, Cursor, 그리고 OpenAI/Anthropic 호환 클라이언트라면 무엇이든 작동합니다.

2. 베이스 URL

키 하나로 프로토콜 호환 베이스 URL 3개(Anthropic / OpenAI / Gemini)와 이미지 생성 엔드포인트까지 사용할 수 있습니다.

서피스	베이스 URL	함께 사용
Anthropic 호환	https://zenn.engineering/api/v1	Claude Code, Anthropic SDK, OpenCode (anthropic provider)
OpenAI 호환 (Codex)	https://zenn.engineering/api/v1/codex	Codex CLI, OpenAI SDK, Cursor
Gemini 호환	https://zenn.engineering/api/v1/gemini	Gemini CLI, Google AI SDK
이미지 생성	https://zenn.engineering/api/v1/images/generations	gpt-image-2 (OpenAI 호환 페이로드)

3. Claude Code

Anthropic의 공식 Claude CLI. 환경 변수 두 개만 설정하면 드롭인 대체로 작동합니다.

1단계 — 환경 설정

셸 프로필(~/.zshrc 또는 ~/.bashrc)에 추가하세요:

shell

export ANTHROPIC_BASE_URL=https://zenn.engineering/api/v1
export ANTHROPIC_API_KEY=ck_YOUR_API_KEY

2단계 — 재시작 후 실행

terminal

# Default model (Sonnet 4.6)
claude

# Pick a different model
claude --model claude-opus-4-7
claude --model claude-haiku-4-5

동작 원리

4. OpenCode

멀티 공급자 AI 코딩 에이전트. JSON 설정 하나로 키 하나에서 Claude, GPT-5, Gemini를 모두 사용할 수 있습니다.

1단계 — 설치

terminal

npm i -g opencode-ai

2단계 — 설정 파일 생성

~/.config/opencode/opencode.json을 편집하세요:

opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "anthropic": {
      "options": {
        "baseURL": "https://zenn.engineering/api/v1",
        "apiKey": "ck_YOUR_API_KEY"
      },
      "models": {
        "claude-opus-4-7": { "name": "Claude Opus 4.7" },
        "claude-sonnet-4-6": { "name": "Claude Sonnet 4.6" },
        "claude-haiku-4-5": { "name": "Claude Haiku 4.5" }
      }
    },
    "zenn-codex": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Zenn Codex",
      "options": {
        "baseURL": "https://zenn.engineering/api/v1/codex",
        "apiKey": "ck_YOUR_API_KEY"
      },
      "models": {
        "gpt-5.5": { "name": "GPT-5.5" },
        "gpt-5.5-pro": { "name": "GPT-5.5 Pro" },
        "gpt-5.5-instant": { "name": "GPT-5.5 Instant" },
        "gpt-5.4": { "name": "GPT-5.4" },
        "gpt-5.3-codex": { "name": "GPT-5.3 Codex" }
      }
    },
    "zenn-gemini": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Zenn Gemini",
      "options": {
        "baseURL": "https://zenn.engineering/api/v1/gemini",
        "apiKey": "ck_YOUR_API_KEY"
      },
      "models": {
        "gemini-3.1-pro-preview": { "name": "Gemini 3.1 Pro" },
        "gemini-3-pro-preview": { "name": "Gemini 3 Pro" },
        "gemini-3-flash-preview": { "name": "Gemini 3 Flash" }
      }
    },
    "zenn-chinese": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Zenn Chinese (DeepSeek / Moonshot / Zhipu)",
      "options": {
        "baseURL": "https://zenn.engineering/api/v1/codex",
        "apiKey": "ck_YOUR_API_KEY"
      },
      "models": {
        "deepseek-v4-pro": { "name": "DeepSeek V4 Pro" },
        "deepseek-v4-flash": { "name": "DeepSeek V4 Flash" },
        "kimi-k2.6": { "name": "Kimi K2.6" },
        "glm-5.1": { "name": "GLM-5.1" }
      }
    }
  }
}

3단계 — 실행

terminal

opencode

5. Codex CLI

OpenAI의 공식 GPT-5 / Codex 패밀리 CLI. 환경 변수 두 개를 설정하고 Codex 베이스 URL을 가리키게 하세요.

환경 설정

shell

export OPENAI_BASE_URL=https://zenn.engineering/api/v1/codex
export OPENAI_API_KEY=ck_YOUR_API_KEY

실행

terminal

# Default
codex

# Pick a model
codex --model gpt-5.5
codex --model gpt-5.5-pro
codex --model gpt-5.5-instant
codex --model gpt-5.3-codex

# Chinese coding models (via OpenAI-compatible /v1/codex)
codex --model deepseek-v4-pro
codex --model kimi-k2.6
codex --model glm-5.1

Codex CLI는 Authorization: Bearer와 OpenAI /chat/completions + /responses 형식을 사용 — 둘 다 지원됩니다.

6. Gemini CLI

Google Gemini CLI는 x-goog-api-key로 키를 전송합니다. 프록시는 이 헤더를 그대로 받아들입니다.

환경 설정

shell

export GEMINI_BASE_URL=https://zenn.engineering/api/v1/gemini
export GEMINI_API_KEY=ck_YOUR_API_KEY

실행

terminal

gemini --model gemini-3.1-pro-preview
gemini --model gemini-3-flash-preview

7. Cursor IDE

Cursor → Settings → Models → "Custom OpenAI Model":

필드	값
Override OpenAI Base URL	https://zenn.engineering/api/v1/codex
OpenAI API Key	ck_YOUR_API_KEY
Add custom models	gpt-5.5, gpt-5.5-pro, gpt-5.5-instant, gpt-5.4, gpt-5.3-codex, deepseek-v4-pro, kimi-k2.6, glm-5.1

저장 후 Verify를 클릭하세요 — Cursor가 베이스 URL의 /models를 호출하여 키가 작동하는지 확인합니다.

8. Direct API (cURL)

프로토콜 형식 3가지, 키 1개. 클라이언트가 이미 사용하는 형식을 선택하세요.

Anthropic 호환 — /v1/messages

cURL · Claude

curl -X POST https://zenn.engineering/api/v1/messages \
  -H "x-api-key: ck_YOUR_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello, Claude"}]
  }'

OpenAI 호환 — /v1/codex/chat/completions

cURL · GPT-5.5

curl -X POST https://zenn.engineering/api/v1/codex/chat/completions \
  -H "Authorization: Bearer ck_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "messages": [{"role": "user", "content": "Hello, GPT-5.5"}],
    "stream": true
  }'

Gemini — /v1/gemini/chat/completions

cURL · Gemini

curl -X POST https://zenn.engineering/api/v1/gemini/chat/completions \
  -H "Authorization: Bearer ck_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3.1-pro-preview",
    "messages": [{"role": "user", "content": "Hello, Gemini"}]
  }'

9. 이미지 생성

엔드포인트

POST https://zenn.engineering/api/v1/images/generations
GET  https://zenn.engineering/api/v1/images/generations  (list models)

이미지 생성

cURL · gpt-image-2

curl -X POST https://zenn.engineering/api/v1/images/generations \
  -H "Authorization: Bearer ck_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "A cinematic photo of a small red apple on a marble countertop",
    "n": 1
  }'

비동기 동작

DocsPage.imageGen.asyncBody

브라우저 채팅에서

10. 모델 및 가격

Claude (Anthropic)

모델 ID	입력 / MTok	출력 / MTok	캐시 읽기	상태
claude-opus-4-7	$15.00	$75.00	$1.50	라이브
claude-opus-4-6	$15.00	$75.00	$1.50	라이브
claude-sonnet-4-6	$3.00	$15.00	$0.30	라이브
claude-haiku-4-5	$1.00	$5.00	$0.10	라이브

OpenAI / GPT

모델 ID	입력 / MTok	출력 / MTok	캐시 읽기	상태
gpt-5.5	$5.00	$30.00	$0.50	라이브
gpt-5.5-instant	$5.00	$30.00	$0.50	라이브
gpt-5.5-pro	$30.00	$180.00	$30.00	라이브
gpt-5.4	$5.00	$22.50	$0.50	라이브
gpt-5.3-codex	$1.75	$14.00	$0.17	라이브
gpt-5.2	$1.75	$14.00	$0.17	라이브

Gemini (Google)

모델 ID	입력 / MTok	출력 / MTok	캐시 읽기	상태
gemini-3.1-pro-preview	$4.00	$18.00	$0.40	라이브
gemini-3-pro-preview	$4.00	$18.00	$0.40	라이브
gemini-3-flash-preview	$0.50	$3.00	$0.05	라이브

DeepSeek / Moonshot / Zhipu

모델 ID	입력 / MTok	출력 / MTok	캐시 읽기	상태
deepseek-v4-pro	$1.74	$3.48	$0.01	라이브
deepseek-v4-flash	$0.14	$0.28	$0.0028	라이브
kimi-k2.6	$0.95	$4.00	$0.16	라이브
glm-5.1	$1.40	$4.40	$0.26	라이브

이미지 (라이브)

모델 ID	이미지당 크레딧	이미지당 가격	상태
gpt-image-2	60000	$0.06	라이브

11. 인증

모든 API 키는 ck_ 접두사를 사용합니다. 프록시는 모든 표준 SDK 헤더 형식을 받아들이므로 클라이언트를 수정하지 않아도 작동합니다.

헤더	형식	사용 도구
x-api-key	ck_...	Claude Code, Anthropic SDK
Authorization	Bearer ck_...	OpenCode, Codex CLI, OpenAI SDK, cURL
anthropic-api-key	ck_...	대체 Anthropic 헤더
x-goog-api-key	ck_...	Gemini CLI

전달되는 헤더

anthropic-version (기본값 2023-06-01)와 anthropic-beta가 그대로 전달됩니다. SSE 스트리밍을 완벽히 지원합니다.

12. 요금제

Pro

$10 · 10,000,000 크레딧

표준 가격. 사용한 만큼 결제.

· 모든 프런티어 LLM을 공식 정가로
· OpenAI / Anthropic / Gemini 호환 API
· 키별 지출 한도, 실시간 분석

Max

$100 · 400,000,000 크레딧

4× 크레딧 — $100으로 정가 기준 $400 사용량.

· Pro의 모든 기능
· 충전 시 1달러당 4× 크레딧
· 모든 모델에 동일한 정가 적용
· 우선 큐 + 더 빠른 라우팅

Enterprise

$1,000 · 6,000,000,000 크레딧

6× 크레딧 — $1,000으로 $6,000 사용량 + Anthropic Max 우선 채널.

· Max의 모든 기능
· 충전 시 1달러당 6× 크레딧
· 모든 모델에 동일한 정가 적용
· Anthropic Max 우선 채널
· 전담 지원, 감사 친화적 인보이스

단 하나의 가격 규칙, 모든 모델에 적용

· 모든 LLM, 이미지, 비디오, 오디오 모델은 /models에 표시된 공식 정가로 소진됩니다.
· Max ($100 → 4×)와 Enterprise ($1,000 → 6×)의 가치는 모델별 할인 등급이 아니라 충전 시 추가로 지급되는 크레딧에서 옵니다.
· 버킷 자격 요건도, 모델별 부가 조건도 없습니다 — 크레딧은 Claude Opus, GPT-5.5, Gemini Flash에서 동일하게 작동합니다.

13. 속도 제한 및 오류

사용자별 속도 제한

엔드포인트	시간당 요청 수
/v1/messages, /v1/chat/completions, /v1/gemini	1,000
/v1/images/generations	500
/v1/responses, /v1/codex/*	1,000

속도 제한 상태는 응답 헤더로 반환됩니다: x-ratelimit-limit, x-ratelimit-remaining, x-ratelimit-reset.

오류 코드

상태	의미
401	API 키 누락 / 유효하지 않음
402	크레딧 부족 — /checkout에서 충전하세요
403	요청한 모델에 대한 등급 권한 없음 (예: Opus 4.7)
429	사용자별 속도 제한 도달
503	모델이 등록되어 있지만 출시 예정 상태
504	이미지 생성 타임아웃 (재시도 필요)

14. 출시 예정

공개적으로 등재되어 있지만, 크레딧 배수 모델 하의 마진이 안정될 때까지 API가 거부합니다：

이미지 (추가)

Nano Banana 패밀리, Gemini 3 Pro Image, Seedream, GPT-4o Image, Imagen.

비디오

Veo 3.1, Kling 3.0, Seedance 2.0, HappyHorse 1.0, MiniMax Hailuo, Vidu Q3, WAN 2.6.

오디오

Fish Audio TTS, Voice Clone, ASR.

전체 목록은 /models에서 확인하세요. 출시 예정 항목은 API에서 HTTP 503을 반환합니다. 오늘 호출해도 크레딧은 차감되지 않는 no-op입니다.

시작할 준비됐나요?

키 하나로 Claude Code, OpenCode, Codex CLI, Gemini CLI, Cursor 모두 사용 가능. 크레딧을 충전하고 API 키를 만드세요.

요금제 보기 API 키 관리