Tài liệu

Tham chiếu API & Cài đặt

Một API key ck_ hoạt động trên Claude Code, OpenCode, Codex CLI, Gemini CLI, Cursor, và HTTP trực tiếp. Giá niêm yết chính thức của provider trên một hóa đơn duy nhất — trả theo mức dùng, không cần đăng ký gói.

Mục lục

1. Bắt đầu

Zenn.Engineering là một API gateway thay thế trực tiếp cho các mô hình Anthropic, OpenAI và Google AI, cộng thêm tạo hình ảnh. Bạn dùng một key tiền tố ck_ ở mọi nơi — không cần thay đổi code, chỉ cần trỏ công cụ của bạn vào base URL của chúng tôi.

1. Lấy API Key

Chọn gói tại /pricing, sau đó tạo key tại /manage-api-keys.

2. Đặt Base URL

Trỏ công cụ của bạn vào https://zenn.engineering/api/v1.

3. Build

Hoạt động với Claude Code, OpenCode, Codex CLI, Gemini CLI, Cursor, và bất kỳ client nào tương thích OpenAI/Anthropic.

2. Base URL

Một key, ba base URL tương thích giao thức (Anthropic / OpenAI / Gemini), cộng thêm endpoint tạo hình ảnh.

Bề mặt	Base URL	Dùng Với
Tương thích Anthropic	https://zenn.engineering/api/v1	Claude Code, Anthropic SDK, OpenCode (anthropic provider)
Tương thích OpenAI (Codex)	https://zenn.engineering/api/v1/codex	Codex CLI, OpenAI SDK, Cursor
Tương thích Gemini	https://zenn.engineering/api/v1/gemini	Gemini CLI, Google AI SDK
Tạo hình ảnh	https://zenn.engineering/api/v1/images/generations	gpt-image-2 (payload tương thích OpenAI)

3. Claude Code

CLI chính thức của Anthropic cho Claude. Đặt hai biến môi trường và nó hoạt động như một bản thay thế trực tiếp.

Bước 1 — Đặt biến môi trường

Thêm vào shell profile của bạn (~/.zshrc hoặc ~/.bashrc):

shell

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

Bước 2 — Khởi động lại & chạy

terminal

# Default model (Sonnet 4.6)
claude

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

Cách hoạt động

Claude Code gửi API key qua header x-api-key (chuẩn Anthropic SDK) và nối thêm /messages vào base URL. Cả header anthropic-version và anthropic-beta đều được chuyển tiếp lên upstream. Streaming được hỗ trợ qua SSE.

4. OpenCode

AI coding agent đa provider. Một file config JSON cho bạn Claude, GPT-5, và Gemini qua một key duy nhất.

Bước 1 — Cài đặt

terminal

npm i -g opencode-ai

Bước 2 — Tạo config

Sửa ~/.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" }
      }
    }
  }
}

Bước 3 — Chạy

terminal

opencode

5. Codex CLI

CLI chính thức của OpenAI cho dòng GPT-5 / Codex. Đặt hai biến môi trường và trỏ vào Codex base URL của chúng tôi.

Đặt biến môi trường

shell

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

Chạy

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 dùng Authorization: Bearer và shape OpenAI /chat/completions + /responses — cả hai đều được hỗ trợ.

6. Gemini CLI

Gemini CLI của Google gửi key qua x-goog-api-key. Proxy chấp nhận header đó một cách trong suốt.

Đặt biến môi trường

shell

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

Chạy

terminal

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

7. Cursor IDE

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

Trường	Giá trị
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

Nhấn Verify sau khi lưu — Cursor sẽ gọi /models trên base URL để xác nhận key hoạt động.

8. API Trực tiếp (cURL)

Ba shape giao thức, một key. Chọn cái mà client của bạn đã hỗ trợ.

Tương thích 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"}]
  }'

Tương thích 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. Tạo Hình ảnh

gpt-image-2 là mô hình hình ảnh duy nhất hiện có thể định tuyến qua API. Các tier độ phân giải (1K / 2K / 4K) đều được tính một mức giá cố định — xem mục Mô hình để biết chi tiết. Các mô hình hình ảnh, video, và âm thanh khác được liệt kê là Sắp ra mắt.

Endpoint

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

Tạo một hình ảnh

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
  }'

Hành vi async

DocsPage.imageGen.asyncBody

Trong giao diện chat trên trình duyệt

Mở /chat, chọn "GPT Image 2 — Image Generation" trong bộ chọn mô hình, gửi prompt, và hình ảnh hiển thị inline. Server poll upstream giúp bạn và tính 6 credits ($0.06) cho mỗi hình.

10. Mô hình & Bảng giá

Tính phí theo credit (1.000.000 credit = $1,00). Giá LLM là giá niêm yết chính thức của nhà cung cấp cho mỗi triệu token; hình ảnh tính theo lần tạo. Các mô hình gắn nhãn Sắp ra mắt được liệt kê nhưng API từ chối cho đến khi được bật. Mỗi mô hình tính theo giá niêm yết chính thức — giá trị đến từ hệ số nhân credit khi nạp (Pro 1×, Max 4×, Enterprise 6×). Xem phần 12 để biết chi tiết gói.

Claude (Anthropic)

Model ID	Input / MTok	Output / MTok	Cache Read	Trạng thái
claude-opus-4-7	$15.00	$75.00	$1.50	Live
claude-opus-4-6	$15.00	$75.00	$1.50	Live
claude-sonnet-4-6	$3.00	$15.00	$0.30	Live
claude-haiku-4-5	$1.00	$5.00	$0.10	Live

OpenAI / GPT

Model ID	Input / MTok	Output / MTok	Cache Read	Trạng thái
gpt-5.5	$5.00	$30.00	$0.50	Live
gpt-5.5-instant	$5.00	$30.00	$0.50	Live
gpt-5.5-pro	$30.00	$180.00	$30.00	Live
gpt-5.4	$5.00	$22.50	$0.50	Live
gpt-5.3-codex	$1.75	$14.00	$0.17	Live
gpt-5.2	$1.75	$14.00	$0.17	Live

Gemini (Google)

Model ID	Input / MTok	Output / MTok	Cache Read	Trạng thái
gemini-3.1-pro-preview	$4.00	$18.00	$0.40	Live
gemini-3-pro-preview	$4.00	$18.00	$0.40	Live
gemini-3-flash-preview	$0.50	$3.00	$0.05	Live

DeepSeek / Moonshot / Zhipu

Model ID	Input / MTok	Output / MTok	Cache Read	Trạng thái
deepseek-v4-pro	$1.74	$3.48	$0.01	Live
deepseek-v4-flash	$0.14	$0.28	$0.0028	Live
kimi-k2.6	$0.95	$4.00	$0.16	Live
glm-5.1	$1.40	$4.40	$0.26	Live

Hình ảnh (live)

Model ID	Credits / hình	Giá / hình	Trạng thái
gpt-image-2	60000	$0.06	Live

Tất cả mô hình hình ảnh, video và âm thanh đều tính theo giá niêm yết chính thức. Các mô hình hình ảnh khác (dòng Nano Banana, Gemini 3 Pro Image, Seedream) có trong catalog nhưng hiện đang Sắp ra mắt — API từ chối chúng cho đến khi được kích hoạt. Xem /models để biết catalog đầy đủ.

11. Xác thực

Tất cả API key dùng tiền tố ck_. Proxy chấp nhận mọi format header SDK chuẩn để client hoạt động không cần chỉnh sửa.

Header	Format	Dùng Bởi
x-api-key	ck_...	Claude Code, Anthropic SDK
Authorization	Bearer ck_...	OpenCode, Codex CLI, OpenAI SDK, cURL
anthropic-api-key	ck_...	Header Anthropic thay thế
x-goog-api-key	ck_...	Gemini CLI

Header được chuyển tiếp

anthropic-version (mặc định 2023-06-01) và anthropic-beta được chuyển tiếp. Streaming SSE được hỗ trợ đầy đủ.

12. Gói

Nạp một lần — không đăng ký. Mỗi lần nạp khóa một hệ số nhân credit (Pro 1×, Max 4×, Enterprise 6×) — credit của bạn giữ giá trị hệ số đó cho đến khi chi tiêu hết. Lần nạp sau có thể ở bất kỳ cấp độ nào.

Pro

$10 · 10,000,000 credits

Giá tiêu chuẩn. Trả theo mức dùng.

· Mọi LLM tiên phong với giá niêm yết chính thức
· API tương thích OpenAI / Anthropic / Gemini
· Giới hạn chi tiêu theo từng key, phân tích thời gian thực

Max

$100 · 400,000,000 credits

4× credits — $100 mua được $400 sử dụng theo giá niêm yết.

· Mọi thứ trong Pro
· 4× credits trên mỗi đô khi nạp
· Cùng giá niêm yết trên mọi mô hình
· Hàng đợi ưu tiên + định tuyến nhanh hơn

Enterprise

$1,000 · 6,000,000,000 credits

6× credits — $1,000 mua được $6,000 sử dụng + kênh ưu tiên Anthropic Max.

· Mọi thứ trong Max
· 6× credits trên mỗi đô khi nạp
· Cùng giá niêm yết trên mọi mô hình
· Kênh ưu tiên Anthropic Max
· Hỗ trợ riêng, hóa đơn thân thiện với audit

Một quy tắc giá, mọi mô hình

· Mọi mô hình LLM, hình ảnh, video và âm thanh đều tính theo giá niêm yết chính thức hiển thị trên /models.
· Giá trị của Max ($100 → 4×) và Enterprise ($1,000 → 6×) đến từ credits thưởng thêm khi nạp, không phải từ tier giảm giá theo từng mô hình.
· Không có điều kiện nhóm, không có chú thích nhỏ theo từng mô hình — credits của bạn dùng được như nhau trên Claude Opus, GPT-5.5, và Gemini Flash.

Hệ số áp dụng cho mỗi lần nạp. Credits Max hiện có giữ nguyên giá trị 4× cho đến khi bạn dùng hết — nạp Pro sau đó và $10 đó cấp 10M credits với hệ số 1×. Xem /pricing để biết chi tiết đầy đủ.

13. Giới hạn Tốc độ & Lỗi

Giới hạn tốc độ trên mỗi người dùng

Endpoint	Requests / giờ
/v1/messages, /v1/chat/completions, /v1/gemini	1,000
/v1/images/generations	500
/v1/responses, /v1/codex/*	1,000

Trạng thái giới hạn tốc độ được trả về trong header phản hồi: x-ratelimit-limit, x-ratelimit-remaining, x-ratelimit-reset.

Mã lỗi

Status	Ý nghĩa
401	API key thiếu / không hợp lệ
402	Không đủ credits — nạp tại /checkout
403	Tier không mở khóa mô hình yêu cầu (ví dụ Opus 4.7)
429	Đã đạt giới hạn tốc độ trên mỗi người dùng
503	Mô hình đã được liệt kê nhưng Sắp ra mắt
504	Tạo hình ảnh hết thời gian (thử lại)

14. Sắp ra mắt

Liệt kê công khai nhưng API từ chối cho đến khi biên lợi nhuận dưới mô hình hệ số nhân credit ổn định:

Hình ảnh (thêm)

Dòng Nano Banana, Gemini 3 Pro Image, Seedream, GPT-4o Image, Imagen.

Video

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

Âm thanh

Fish Audio TTS, Voice Clone, ASR.

Xem danh sách đầy đủ trên /models. Các mục sắp ra mắt trả về HTTP 503 từ API; gọi chúng hôm nay là một no-op không tính credits.

Sẵn sàng bắt đầu?

Một key hoạt động trên Claude Code, OpenCode, Codex CLI, Gemini CLI, và Cursor. Nạp credits và tạo API key của bạn.

Xem Gói Quản lý API Key

Tài liệu

Tham chiếu API & Cài đặt

Mục lục

1. Bắt đầu

1. Lấy API Key

Chọn gói tại /pricing, sau đó tạo key tại /manage-api-keys.

2. Đặt Base URL

Trỏ công cụ của bạn vào https://zenn.engineering/api/v1.

3. Build

Hoạt động với Claude Code, OpenCode, Codex CLI, Gemini CLI, Cursor, và bất kỳ client nào tương thích OpenAI/Anthropic.

2. Base URL

Một key, ba base URL tương thích giao thức (Anthropic / OpenAI / Gemini), cộng thêm endpoint tạo hình ảnh.

Bề mặt	Base URL	Dùng Với
Tương thích Anthropic	https://zenn.engineering/api/v1	Claude Code, Anthropic SDK, OpenCode (anthropic provider)
Tương thích OpenAI (Codex)	https://zenn.engineering/api/v1/codex	Codex CLI, OpenAI SDK, Cursor
Tương thích Gemini	https://zenn.engineering/api/v1/gemini	Gemini CLI, Google AI SDK
Tạo hình ảnh	https://zenn.engineering/api/v1/images/generations	gpt-image-2 (payload tương thích OpenAI)

3. Claude Code

CLI chính thức của Anthropic cho Claude. Đặt hai biến môi trường và nó hoạt động như một bản thay thế trực tiếp.

Bước 1 — Đặt biến môi trường

Thêm vào shell profile của bạn (~/.zshrc hoặc ~/.bashrc):

shell

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

Bước 2 — Khởi động lại & chạy

terminal

# Default model (Sonnet 4.6)
claude

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

Cách hoạt động

4. OpenCode

AI coding agent đa provider. Một file config JSON cho bạn Claude, GPT-5, và Gemini qua một key duy nhất.

Bước 1 — Cài đặt

terminal

npm i -g opencode-ai

Bước 2 — Tạo config

Sửa ~/.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" }
      }
    }
  }
}

Bước 3 — Chạy

terminal

opencode

5. Codex CLI

CLI chính thức của OpenAI cho dòng GPT-5 / Codex. Đặt hai biến môi trường và trỏ vào Codex base URL của chúng tôi.

Đặt biến môi trường

shell

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

Chạy

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 dùng Authorization: Bearer và shape OpenAI /chat/completions + /responses — cả hai đều được hỗ trợ.

6. Gemini CLI

Gemini CLI của Google gửi key qua x-goog-api-key. Proxy chấp nhận header đó một cách trong suốt.

Đặt biến môi trường

shell

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

Chạy

terminal

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

7. Cursor IDE

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

Trường	Giá trị
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

Nhấn Verify sau khi lưu — Cursor sẽ gọi /models trên base URL để xác nhận key hoạt động.

8. API Trực tiếp (cURL)

Ba shape giao thức, một key. Chọn cái mà client của bạn đã hỗ trợ.

Tương thích 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"}]
  }'

Tương thích 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. Tạo Hình ảnh

Endpoint

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

Tạo một hình ảnh

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
  }'

Hành vi async

DocsPage.imageGen.asyncBody

Trong giao diện chat trên trình duyệt

10. Mô hình & Bảng giá

Claude (Anthropic)

Model ID	Input / MTok	Output / MTok	Cache Read	Trạng thái
claude-opus-4-7	$15.00	$75.00	$1.50	Live
claude-opus-4-6	$15.00	$75.00	$1.50	Live
claude-sonnet-4-6	$3.00	$15.00	$0.30	Live
claude-haiku-4-5	$1.00	$5.00	$0.10	Live

OpenAI / GPT

Model ID	Input / MTok	Output / MTok	Cache Read	Trạng thái
gpt-5.5	$5.00	$30.00	$0.50	Live
gpt-5.5-instant	$5.00	$30.00	$0.50	Live
gpt-5.5-pro	$30.00	$180.00	$30.00	Live
gpt-5.4	$5.00	$22.50	$0.50	Live
gpt-5.3-codex	$1.75	$14.00	$0.17	Live
gpt-5.2	$1.75	$14.00	$0.17	Live

Gemini (Google)

Model ID	Input / MTok	Output / MTok	Cache Read	Trạng thái
gemini-3.1-pro-preview	$4.00	$18.00	$0.40	Live
gemini-3-pro-preview	$4.00	$18.00	$0.40	Live
gemini-3-flash-preview	$0.50	$3.00	$0.05	Live

DeepSeek / Moonshot / Zhipu

Model ID	Input / MTok	Output / MTok	Cache Read	Trạng thái
deepseek-v4-pro	$1.74	$3.48	$0.01	Live
deepseek-v4-flash	$0.14	$0.28	$0.0028	Live
kimi-k2.6	$0.95	$4.00	$0.16	Live
glm-5.1	$1.40	$4.40	$0.26	Live

Hình ảnh (live)

Model ID	Credits / hình	Giá / hình	Trạng thái
gpt-image-2	60000	$0.06	Live

11. Xác thực

Tất cả API key dùng tiền tố ck_. Proxy chấp nhận mọi format header SDK chuẩn để client hoạt động không cần chỉnh sửa.

Header	Format	Dùng Bởi
x-api-key	ck_...	Claude Code, Anthropic SDK
Authorization	Bearer ck_...	OpenCode, Codex CLI, OpenAI SDK, cURL
anthropic-api-key	ck_...	Header Anthropic thay thế
x-goog-api-key	ck_...	Gemini CLI

Header được chuyển tiếp

anthropic-version (mặc định 2023-06-01) và anthropic-beta được chuyển tiếp. Streaming SSE được hỗ trợ đầy đủ.

12. Gói

Pro

$10 · 10,000,000 credits

Giá tiêu chuẩn. Trả theo mức dùng.

· Mọi LLM tiên phong với giá niêm yết chính thức
· API tương thích OpenAI / Anthropic / Gemini
· Giới hạn chi tiêu theo từng key, phân tích thời gian thực

Max

$100 · 400,000,000 credits

4× credits — $100 mua được $400 sử dụng theo giá niêm yết.

· Mọi thứ trong Pro
· 4× credits trên mỗi đô khi nạp
· Cùng giá niêm yết trên mọi mô hình
· Hàng đợi ưu tiên + định tuyến nhanh hơn

Enterprise

$1,000 · 6,000,000,000 credits

6× credits — $1,000 mua được $6,000 sử dụng + kênh ưu tiên Anthropic Max.

· Mọi thứ trong Max
· 6× credits trên mỗi đô khi nạp
· Cùng giá niêm yết trên mọi mô hình
· Kênh ưu tiên Anthropic Max
· Hỗ trợ riêng, hóa đơn thân thiện với audit

Một quy tắc giá, mọi mô hình

· Mọi mô hình LLM, hình ảnh, video và âm thanh đều tính theo giá niêm yết chính thức hiển thị trên /models.
· Giá trị của Max ($100 → 4×) và Enterprise ($1,000 → 6×) đến từ credits thưởng thêm khi nạp, không phải từ tier giảm giá theo từng mô hình.
· Không có điều kiện nhóm, không có chú thích nhỏ theo từng mô hình — credits của bạn dùng được như nhau trên Claude Opus, GPT-5.5, và Gemini Flash.

13. Giới hạn Tốc độ & Lỗi

Giới hạn tốc độ trên mỗi người dùng

Endpoint	Requests / giờ
/v1/messages, /v1/chat/completions, /v1/gemini	1,000
/v1/images/generations	500
/v1/responses, /v1/codex/*	1,000

Trạng thái giới hạn tốc độ được trả về trong header phản hồi: x-ratelimit-limit, x-ratelimit-remaining, x-ratelimit-reset.

Mã lỗi

Status	Ý nghĩa
401	API key thiếu / không hợp lệ
402	Không đủ credits — nạp tại /checkout
403	Tier không mở khóa mô hình yêu cầu (ví dụ Opus 4.7)
429	Đã đạt giới hạn tốc độ trên mỗi người dùng
503	Mô hình đã được liệt kê nhưng Sắp ra mắt
504	Tạo hình ảnh hết thời gian (thử lại)

14. Sắp ra mắt

Liệt kê công khai nhưng API từ chối cho đến khi biên lợi nhuận dưới mô hình hệ số nhân credit ổn định:

Hình ảnh (thêm)

Dòng Nano Banana, Gemini 3 Pro Image, Seedream, GPT-4o Image, Imagen.

Video

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

Âm thanh

Fish Audio TTS, Voice Clone, ASR.

Xem danh sách đầy đủ trên /models. Các mục sắp ra mắt trả về HTTP 503 từ API; gọi chúng hôm nay là một no-op không tính credits.

Sẵn sàng bắt đầu?

Một key hoạt động trên Claude Code, OpenCode, Codex CLI, Gemini CLI, và Cursor. Nạp credits và tạo API key của bạn.

Xem Gói Quản lý API Key