API Reference และการตั้งค่า
API key ck_ ตัวเดียวใช้ได้กับ Claude Code, OpenCode, Codex CLI, Gemini CLI, Cursor และ HTTP โดยตรง ราคา list price อย่างเป็นทางการในบิลเดียว — จ่ายตามการใช้งาน ไม่ต้องสมัครสมาชิก
1. เริ่มต้นใช้งาน
Zenn.Engineering เป็น API gateway แบบ drop-in สำหรับโมเดลของ Anthropic, OpenAI และ Google AI พร้อมการสร้างภาพ ใช้คีย์เดียวที่ขึ้นต้นด้วย ck_ ได้ทุกที่ — ไม่ต้องแก้โค้ด แค่ชี้เครื่องมือของคุณมาที่ base URL ของเรา
เลือกแพ็กเกจที่ /pricing แล้วสร้างคีย์ที่ /manage-api-keys
ชี้เครื่องมือของคุณไปที่ https://zenn.engineering/api/v1
ใช้ได้กับ Claude Code, OpenCode, Codex CLI, Gemini CLI, Cursor และ client ใดๆ ที่รองรับ OpenAI/Anthropic
2. Base URLs
คีย์เดียว สาม base URL ที่รองรับ protocol แตกต่างกัน (Anthropic / OpenAI / Gemini) บวกกับ endpoint สำหรับสร้างภาพ
| Surface | Base 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 (payload แบบ OpenAI) |
3. Claude Code
CLI อย่างเป็นทางการของ Anthropic สำหรับ Claude ตั้งค่า env var สองตัวก็ใช้แทนกันได้ทันที
ขั้นที่ 1 — ตั้งค่า environment
เพิ่มลงใน shell profile ของคุณ (~/.zshrc หรือ ~/.bashrc):
export ANTHROPIC_BASE_URL=https://zenn.engineering/api/v1 export ANTHROPIC_API_KEY=ck_YOUR_API_KEY
ขั้นที่ 2 — Restart และรัน
# Default model (Sonnet 4.6) claude # Pick a different model claude --model claude-opus-4-7 claude --model claude-haiku-4-5
หลักการทำงาน
Claude Code ส่ง API key ผ่าน header x-api-key (Anthropic SDK รองรับโดยตรง) และต่อ /messages ที่ท้าย base URL ทั้ง anthropic-version และ anthropic-beta จะถูกส่งต่อขึ้นไปยัง upstream รองรับ streaming ผ่าน SSE
4. OpenCode
AI coding agent หลาย provider config JSON เดียวให้คุณใช้ Claude, GPT-5 และ Gemini ผ่านคีย์เดียว
ขั้นที่ 1 — ติดตั้ง
npm i -g opencode-ai
ขั้นที่ 2 — สร้าง config
แก้ไข ~/.config/opencode/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 — รัน
opencode
5. Codex CLI
CLI อย่างเป็นทางการของ OpenAI สำหรับตระกูล GPT-5 / Codex ตั้งค่า env var สองตัวและชี้ไปที่ Codex base URL ของเรา
ตั้งค่า environment
export OPENAI_BASE_URL=https://zenn.engineering/api/v1/codex export OPENAI_API_KEY=ck_YOUR_API_KEY
รัน
# 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
Gemini CLI ของ Google ส่งคีย์ผ่าน x-goog-api-key proxy รับ header นี้แบบ transparent
ตั้งค่า environment
export GEMINI_BASE_URL=https://zenn.engineering/api/v1/gemini export GEMINI_API_KEY=ck_YOUR_API_KEY
รัน
gemini --model gemini-3.1-pro-preview gemini --model gemini-3-flash-preview
7. Cursor IDE
ใน Cursor → Settings → Models → "Custom OpenAI Model":
| Field | Value |
|---|---|
| Override OpenAI Base URL | https://zenn.engineering/api/v1/codex |
| OpenAI API Key | ck_YOUR_API_KEY |
| เพิ่มโมเดลกำหนดเอง | 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 จะเรียก /models บน base URL เพื่อยืนยันว่าคีย์ใช้งานได้
8. Direct API (cURL)
Protocol สามรูปแบบ คีย์เดียว เลือกอันที่ client ของคุณรองรับอยู่แล้ว
รองรับ Anthropic — /v1/messages
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 -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 -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 ได้ในขณะนี้ Resolution ทุกระดับ (1K / 2K / 4K) คิดราคาเดียว — ดูรายละเอียดได้ที่หน้า Models โมเดลภาพ วิดีโอ และเสียงอื่นๆ ระบุว่าเร็วๆ นี้
Endpoint
POST https://zenn.engineering/api/v1/images/generations GET https://zenn.engineering/api/v1/images/generations (list models)
สร้างภาพ
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
}'การทำงานแบบ Async
DocsPage.imageGen.asyncBody
ในหน้าแชทบนเบราว์เซอร์
เปิด /chat เลือก "GPT Image 2 — Image Generation" จาก model picker ส่ง prompt แล้วภาพจะแสดงในหน้าแชท เซิร์ฟเวอร์จะ poll upstream ให้คุณและคิด 6 credits ($0.06) ต่อภาพ
10. โมเดลและราคา
การคิดเงินตามเครดิต (1,000,000 เครดิต = $1.00) ราคา LLM เป็นราคาตามรายการอย่างเป็นทางการของผู้ให้บริการต่อล้านโทเคน; รูปภาพคิดต่อการสร้าง โมเดลที่ติดป้าย เร็วๆ นี้ มีในรายการแต่ API จะปฏิเสธจนกว่าจะเปิดใช้งาน ทุกโมเดลคิดที่ราคาตามรายการอย่างเป็นทางการ — มูลค่ามาจากตัวคูณเครดิตในตอนเติมเงิน (Pro 1×, Max 4×, Enterprise 6×) ดูรายละเอียดแผนในหัวข้อ 12
Claude (Anthropic)
| Model ID | Input / MTok | Output / MTok | Cache Read | สถานะ |
|---|---|---|---|---|
| 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
| Model ID | Input / MTok | Output / MTok | Cache Read | สถานะ |
|---|---|---|---|---|
| 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)
| Model ID | Input / MTok | Output / MTok | Cache Read | สถานะ |
|---|---|---|---|---|
| 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
| Model ID | Input / MTok | Output / MTok | Cache Read | สถานะ |
|---|---|---|---|---|
| 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 | พร้อมใช้ |
ภาพ (พร้อมใช้)
| Model ID | Credits / ภาพ | ราคา / ภาพ | สถานะ |
|---|---|---|---|
| gpt-image-2 | 60000 | $0.06 | พร้อมใช้ |
โมเดลภาพ วิดีโอ และเสียงทั้งหมดคิดที่ list price อย่างเป็นทางการ โมเดลภาพอื่นๆ (ตระกูล Nano Banana, Gemini 3 Pro Image, Seedream) อยู่ใน catalog แต่ตอนนี้ยัง Coming Soon — API ปฏิเสธจนกว่าจะเปิดใช้งาน ดู catalog เต็มได้ที่ /models
11. Authentication
API key ทั้งหมดใช้ prefix ck_ Proxy รับ header SDK มาตรฐานทุกรูปแบบ ดังนั้น client จึงทำงานได้โดยไม่ต้องแก้ไข
| Header | Format | ใช้โดย |
|---|---|---|
| x-api-key | ck_... | Claude Code, Anthropic SDK |
| Authorization | Bearer ck_... | OpenCode, Codex CLI, OpenAI SDK, cURL |
| anthropic-api-key | ck_... | Header สำรองของ Anthropic |
| x-goog-api-key | ck_... | Gemini CLI |
Header ที่ส่งต่อ
anthropic-version (ค่าเริ่มต้น 2023-06-01) และ anthropic-beta ส่งผ่านไป รองรับ SSE streaming เต็มรูปแบบ
12. แพ็กเกจ
เติมเงินครั้งเดียว — ไม่ต้องสมัครสมาชิก แต่ละครั้งของการเติมเงินจะล็อกตัวคูณเครดิต (Pro 1×, Max 4×, Enterprise 6×) — เครดิตของคุณจะคงค่าตัวคูณนั้นไว้จนกว่าจะใช้หมด การเติมเงินครั้งต่อไปสามารถเลือกระดับใดก็ได้
ราคามาตรฐาน จ่ายตามการใช้งาน
- · LLM ระดับ frontier ทุกตัวที่ราคา list price อย่างเป็นทางการ
- · API รองรับ OpenAI / Anthropic / Gemini
- · Spend limit ต่อคีย์, analytics แบบ real-time
เครดิต 4 เท่า — $100 ได้ มูลค่าการใช้งาน $400 ที่ราคา list price
- · ทุกอย่างใน Pro
- · เครดิต 4 เท่าต่อดอลลาร์ตอนเติมเงิน
- · ราคา list price เดียวกันทุกโมเดล
- · Priority queue + routing ที่เร็วขึ้น
เครดิต 6 เท่า — $1,000 ได้ มูลค่าการใช้งาน $6,000 + ช่อง priority Anthropic Max
- · ทุกอย่างใน Max
- · เครดิต 6 เท่าต่อดอลลาร์ตอนเติมเงิน
- · ราคา list price เดียวกันทุกโมเดล
- · ช่อง priority Anthropic Max
- · Support เฉพาะ, ใบแจ้งหนี้รองรับการตรวจสอบ
กฎราคาเดียว ทุกโมเดล
- · LLM, ภาพ, วิดีโอ และเสียงทุกโมเดลคิดที่ list price อย่างเป็นทางการตามที่แสดงใน /models
- · มูลค่าของ Max ($100 → 4×) และ Enterprise ($1,000 → 6×) มาจากเครดิตเพิ่มเติมที่มอบให้ตอนเติมเงิน ไม่ใช่จากส่วนลดรายโมเดล
- · ไม่มีเงื่อนไข bucket ไม่มี fine print รายโมเดล — เครดิตของคุณใช้ได้เหมือนกันบน Claude Opus, GPT-5.5 และ Gemini Flash
ตัวคูณใช้กับการเติมแต่ละครั้ง เครดิต Max ที่มีอยู่จะคงค่า 4× ไว้จนกว่าจะใช้หมด — เติม Pro หลังจากนั้น $10 จะให้ 10M credits ที่ 1× ดูรายละเอียดทั้งหมดได้ที่ /pricing
13. Rate Limits และ Errors
Rate limit ต่อผู้ใช้
| Endpoint | Requests / ชั่วโมง |
|---|---|
| /v1/messages, /v1/chat/completions, /v1/gemini | 1,000 |
| /v1/images/generations | 500 |
| /v1/responses, /v1/codex/* | 1,000 |
สถานะ rate limit ส่งกลับใน response header: x-ratelimit-limit, x-ratelimit-remaining, x-ratelimit-reset
รหัสข้อผิดพลาด
| Status | ความหมาย |
|---|---|
| 401 | ไม่มี / API key ไม่ถูกต้อง |
| 402 | เครดิตไม่พอ — เติมที่ /checkout |
| 403 | Tier ไม่ปลดล็อกโมเดลที่ขอ (เช่น Opus 4.7) |
| 429 | ถึง rate limit ต่อผู้ใช้ |
| 503 | โมเดลถูกแสดงแต่ยัง Coming Soon |
| 504 | การสร้างภาพ timeout (ลองใหม่) |
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 รายการ coming-soon จะส่งกลับ HTTP 503 จาก API การเรียกตอนนี้เป็น no-op ที่ไม่คิดเครดิต
พร้อมเริ่มใช้งานแล้ว?
คีย์เดียวใช้ได้กับ Claude Code, OpenCode, Codex CLI, Gemini CLI และ Cursor เติมเครดิตแล้วสร้าง API key ของคุณ
