LogoZenn.CEO/
DashboardแชทAPI KeysDocs
เอกสาร

API Reference และการตั้งค่า

API key ck_ ตัวเดียวใช้ได้กับ Claude Code, OpenCode, Codex CLI, Gemini CLI, Cursor และ HTTP โดยตรง ราคา list price อย่างเป็นทางการในบิลเดียว — จ่ายตามการใช้งาน ไม่ต้องสมัครสมาชิก

สารบัญ
1. เริ่มต้นใช้งาน2. Base URLs3. Claude Code4. OpenCode5. Codex CLI6. Gemini CLI7. Cursor IDE8. Direct API (cURL)9. การสร้างภาพ10. โมเดลและราคา11. Authentication12. แพ็กเกจ13. Rate Limits และ Errors14. เร็วๆ นี้

1. เริ่มต้นใช้งาน

Zenn.Engineering เป็น API gateway แบบ drop-in สำหรับโมเดลของ Anthropic, OpenAI และ Google AI พร้อมการสร้างภาพ ใช้คีย์เดียวที่ขึ้นต้นด้วย ck_ ได้ทุกที่ — ไม่ต้องแก้โค้ด แค่ชี้เครื่องมือของคุณมาที่ base URL ของเรา

1. รับ API Key

เลือกแพ็กเกจที่ /pricing แล้วสร้างคีย์ที่ /manage-api-keys

2. ตั้งค่า Base URL

ชี้เครื่องมือของคุณไปที่ https://zenn.engineering/api/v1

3. เริ่มสร้าง

ใช้ได้กับ Claude Code, OpenCode, Codex CLI, Gemini CLI, Cursor และ client ใดๆ ที่รองรับ OpenAI/Anthropic

2. Base URLs

คีย์เดียว สาม base URL ที่รองรับ protocol แตกต่างกัน (Anthropic / OpenAI / Gemini) บวกกับ endpoint สำหรับสร้างภาพ

SurfaceBase URLใช้กับ
รองรับ Anthropichttps://zenn.engineering/api/v1Claude Code, Anthropic SDK, OpenCode (anthropic provider)
รองรับ OpenAI (Codex)https://zenn.engineering/api/v1/codexCodex CLI, OpenAI SDK, Cursor
รองรับ Geminihttps://zenn.engineering/api/v1/geminiGemini CLI, Google AI SDK
การสร้างภาพhttps://zenn.engineering/api/v1/images/generationsgpt-image-2 (payload แบบ OpenAI)

3. Claude Code

CLI อย่างเป็นทางการของ Anthropic สำหรับ Claude ตั้งค่า env var สองตัวก็ใช้แทนกันได้ทันที

ขั้นที่ 1 — ตั้งค่า environment

เพิ่มลงใน shell profile ของคุณ (~/.zshrc หรือ ~/.bashrc):

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

ขั้นที่ 2 — Restart และรัน

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 ส่ง 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 — ติดตั้ง

terminal
npm i -g opencode-ai

ขั้นที่ 2 — สร้าง config

แก้ไข ~/.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

CLI อย่างเป็นทางการของ OpenAI สำหรับตระกูล GPT-5 / Codex ตั้งค่า env var สองตัวและชี้ไปที่ Codex base URL ของเรา

ตั้งค่า environment

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

Gemini CLI ของ Google ส่งคีย์ผ่าน x-goog-api-key proxy รับ header นี้แบบ transparent

ตั้งค่า environment

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":

FieldValue
Override OpenAI Base URLhttps://zenn.engineering/api/v1/codex
OpenAI API Keyck_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 · 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 ได้ในขณะนี้ 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 · 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
  }'

การทำงานแบบ 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 IDInput / MTokOutput / MTokCache 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 IDInput / MTokOutput / MTokCache 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 IDInput / MTokOutput / MTokCache 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 IDInput / MTokOutput / MTokCache 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 IDCredits / ภาพราคา / ภาพสถานะ
gpt-image-260000$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 จึงทำงานได้โดยไม่ต้องแก้ไข

HeaderFormatใช้โดย
x-api-keyck_...Claude Code, Anthropic SDK
AuthorizationBearer ck_...OpenCode, Codex CLI, OpenAI SDK, cURL
anthropic-api-keyck_...Header สำรองของ Anthropic
x-goog-api-keyck_...Gemini CLI

Header ที่ส่งต่อ

anthropic-version (ค่าเริ่มต้น 2023-06-01) และ anthropic-beta ส่งผ่านไป รองรับ SSE streaming เต็มรูปแบบ

12. แพ็กเกจ

เติมเงินครั้งเดียว — ไม่ต้องสมัครสมาชิก แต่ละครั้งของการเติมเงินจะล็อกตัวคูณเครดิต (Pro 1×, Max 4×, Enterprise 6×) — เครดิตของคุณจะคงค่าตัวคูณนั้นไว้จนกว่าจะใช้หมด การเติมเงินครั้งต่อไปสามารถเลือกระดับใดก็ได้

Pro
$10 · 10,000,000 credits

ราคามาตรฐาน จ่ายตามการใช้งาน

  • · LLM ระดับ frontier ทุกตัวที่ราคา list price อย่างเป็นทางการ
  • · API รองรับ OpenAI / Anthropic / Gemini
  • · Spend limit ต่อคีย์, analytics แบบ real-time
Max
$100 · 400,000,000 credits

เครดิต 4 เท่า — $100 ได้ มูลค่าการใช้งาน $400 ที่ราคา list price

  • · ทุกอย่างใน Pro
  • · เครดิต 4 เท่าต่อดอลลาร์ตอนเติมเงิน
  • · ราคา list price เดียวกันทุกโมเดล
  • · Priority queue + routing ที่เร็วขึ้น
Enterprise
$1,000 · 6,000,000,000 credits

เครดิต 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 ต่อผู้ใช้

EndpointRequests / ชั่วโมง
/v1/messages, /v1/chat/completions, /v1/gemini1,000
/v1/images/generations500
/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
403Tier ไม่ปลดล็อกโมเดลที่ขอ (เช่น 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 ของคุณ

ดูแพ็กเกจจัดการ API Keys
Logo
Zenn.CEOFrontier Intelligence สำหรับทุกคน
XX (Twitter)GitHubLinkedInEmail
Product
  • Chat
  • API
  • Pricing
บริษัท
  • About
  • ติดต่อ
  • นโยบายคุกกี้
  • นโยบายความเป็นส่วนตัว
  • ข้อกำหนดการให้บริการ
  • นโยบายการคืนเงิน
ทุกระบบทำงานปกติ
•สร้างจาก California ด้วยใจรัก ❤️
© ลิขสิทธิ์ 2026 สงวนลิขสิทธิ์ทั้งหมด