LogoZenn.CEO/
DashboardChatAPI KeysDocs
Dokumentasi

API Reference & Setup

Satu API key ck_ bekerja di seluruh Claude Code, OpenCode, Codex CLI, Gemini CLI, Cursor, dan HTTP langsung. Harga resmi dari provider dalam satu tagihan — pay as you go, tanpa langganan.

Daftar Isi
1. Memulai2. Base URLs3. Claude Code4. OpenCode5. Codex CLI6. Gemini CLI7. Cursor IDE8. Direct API (cURL)9. Image Generation10. Model & Harga11. Authentication12. Paket13. Rate Limits & Errors14. Segera Hadir

1. Memulai

Zenn.Engineering adalah API gateway drop-in untuk model Anthropic, OpenAI, dan Google AI, plus image generation. Anda menggunakan satu key dengan prefix ck_ di mana saja — tanpa perubahan code, cukup arahkan tool Anda ke base URL kami.

1. Dapatkan API Key

Pilih paket di /pricing, lalu buat key di /manage-api-keys.

2. Set Base URL

Arahkan tool Anda ke https://zenn.engineering/api/v1.

3. Build

Bekerja dengan Claude Code, OpenCode, Codex CLI, Gemini CLI, Cursor, dan client OpenAI/Anthropic-compatible apa pun.

2. Base URLs

Satu key, tiga base URL protocol-compatible (Anthropic / OpenAI / Gemini), plus endpoint image-generation.

SurfaceBase URLDigunakan Dengan
Anthropic-compatiblehttps://zenn.engineering/api/v1Claude Code, Anthropic SDK, OpenCode (anthropic provider)
OpenAI-compatible (Codex)https://zenn.engineering/api/v1/codexCodex CLI, OpenAI SDK, Cursor
Gemini-compatiblehttps://zenn.engineering/api/v1/geminiGemini CLI, Google AI SDK
Image generationhttps://zenn.engineering/api/v1/images/generationsgpt-image-2 (OpenAI-compatible payload)

3. Claude Code

CLI resmi Anthropic untuk Claude. Set dua env var dan ia bekerja sebagai pengganti drop-in.

Step 1 — Set environment

Tambahkan ke shell profile Anda (~/.zshrc atau ~/.bashrc):

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

Step 2 — Restart & jalankan

terminal
# Default model (Sonnet 4.6)
claude

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

Cara kerjanya

Claude Code mengirim API key melalui header x-api-key (Anthropic SDK native) dan menambahkan /messages ke base URL. Header anthropic-version dan anthropic-beta diteruskan ke upstream. Streaming didukung melalui SSE.

4. OpenCode

AI coding agent multi-provider. Satu config JSON memberi Anda Claude, GPT-5, dan Gemini melalui satu key.

Step 1 — Install

terminal
npm i -g opencode-ai

Step 2 — Buat config

Edit ~/.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" }
      }
    }
  }
}

Step 3 — Jalankan

terminal
opencode

5. Codex CLI

CLI resmi OpenAI untuk keluarga GPT-5 / Codex. Set dua env var dan arahkan ke Codex base URL kami.

Set environment

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

Jalankan

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 menggunakan Authorization: Bearer dan format OpenAI /chat/completions + /responses — keduanya didukung.

6. Gemini CLI

Gemini CLI dari Google mengirim key melalui x-goog-api-key. Proxy menerima header tersebut secara transparan.

Set environment

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

Jalankan

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

7. Cursor IDE

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

FieldValue
Override OpenAI Base URLhttps://zenn.engineering/api/v1/codex
OpenAI API Keyck_YOUR_API_KEY
Add custom modelsgpt-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

Klik Verify setelah menyimpan — Cursor akan memanggil /models di base URL untuk mengonfirmasi key bekerja.

8. Direct API (cURL)

Tiga bentuk protocol, satu key. Pilih yang sudah didukung client Anda.

Anthropic-compatible — /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-compatible — /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. Image Generation

gpt-image-2 adalah satu-satunya model gambar yang saat ini dapat dirutekan melalui API. Tier resolusi (1K / 2K / 4K) dikenakan biaya satu harga flat — lihat Models untuk detailnya. Model image, video, dan audio lainnya tercantum sebagai Coming Soon.

Endpoint

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

Hasilkan gambar

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

Perilaku async

DocsPage.imageGen.asyncBody

Di chat browser

Buka /chat, pilih "GPT Image 2 — Image Generation" dari model picker, kirim prompt, dan gambar akan muncul inline. Server melakukan polling ke upstream untuk Anda dan menagih 6 kredit ($0.06) per gambar.

10. Model & Harga

Penagihan berbasis kredit (1.000.000 kredit = $1,00). Harga LLM adalah harga daftar resmi penyedia per juta token; gambar per generasi. Model yang ditandai Segera Hadir tercantum tetapi API menolaknya sampai diaktifkan. Setiap model ditagih dengan harga daftar resmi — nilai berasal dari pengganda kredit saat top-up (Pro 1×, Max 4×, Enterprise 6×). Lihat bagian 12 untuk detail paket.

Claude (Anthropic)

Model IDInput / MTokOutput / MTokCache ReadStatus
claude-opus-4-7$15.00$75.00$1.50Live
claude-opus-4-6$15.00$75.00$1.50Live
claude-sonnet-4-6$3.00$15.00$0.30Live
claude-haiku-4-5$1.00$5.00$0.10Live

OpenAI / GPT

Model IDInput / MTokOutput / MTokCache ReadStatus
gpt-5.5$5.00$30.00$0.50Live
gpt-5.5-instant$5.00$30.00$0.50Live
gpt-5.5-pro$30.00$180.00$30.00Live
gpt-5.4$5.00$22.50$0.50Live
gpt-5.3-codex$1.75$14.00$0.17Live
gpt-5.2$1.75$14.00$0.17Live

Gemini (Google)

Model IDInput / MTokOutput / MTokCache ReadStatus
gemini-3.1-pro-preview$4.00$18.00$0.40Live
gemini-3-pro-preview$4.00$18.00$0.40Live
gemini-3-flash-preview$0.50$3.00$0.05Live

DeepSeek / Moonshot / Zhipu

Model IDInput / MTokOutput / MTokCache ReadStatus
deepseek-v4-pro$1.74$3.48$0.01Live
deepseek-v4-flash$0.14$0.28$0.0028Live
kimi-k2.6$0.95$4.00$0.16Live
glm-5.1$1.40$4.40$0.26Live

Gambar (live)

Model IDKredit / gambarHarga / gambarStatus
gpt-image-260000$0.06Live

Semua model image, video, dan audio di-burn dengan harga list resmi. Model gambar lainnya (keluarga Nano Banana, Gemini 3 Pro Image, Seedream) terdaftar di katalog tetapi saat ini Coming Soon — API menolaknya hingga diaktifkan. Lihat /models untuk katalog lengkap.

11. Authentication

Semua API key menggunakan prefix ck_. Proxy menerima setiap format header SDK standar sehingga client bekerja tanpa modifikasi.

HeaderFormatDigunakan Oleh
x-api-keyck_...Claude Code, Anthropic SDK
AuthorizationBearer ck_...OpenCode, Codex CLI, OpenAI SDK, cURL
anthropic-api-keyck_...Header alternatif Anthropic
x-goog-api-keyck_...Gemini CLI

Header yang diteruskan

anthropic-version (default ke 2023-06-01) dan anthropic-beta diteruskan. SSE streaming didukung penuh.

12. Paket

Top-up sekali — tanpa langganan. Setiap top-up mengunci pengganda kredit (Pro 1×, Max 4×, Enterprise 6×) — kredit Anda mempertahankan nilai pengganda itu sampai habis. Top-up berikutnya bisa di tier mana saja.

Pro
$10 · 20.000.000 kredit

Harga standar. Pay-as-you-go.

  • · Setiap LLM frontier dengan harga list resmi
  • · API kompatibel OpenAI / Anthropic / Gemini
  • · Limit pengeluaran per key, analitik real-time
Max
$100 · 800.000.000 kredit

4× kredit — $100 mendapatkan penggunaan $400 dengan harga list.

  • · Semua yang ada di Pro
  • · 4× kredit per dolar saat top-up
  • · Harga list yang sama di setiap model
  • · Priority queue + routing lebih cepat
Enterprise
$1,000 · 12.000.000.000 kredit

6× kredit — $1,000 mendapatkan penggunaan $6,000 + channel prioritas Anthropic Max.

  • · Semua yang ada di Max
  • · 6× kredit per dolar saat top-up
  • · Harga list yang sama di setiap model
  • · Channel prioritas Anthropic Max
  • · Dukungan dedicated, invoicing audit-friendly

Satu aturan harga, semua model

  • · Setiap model LLM, image, video, dan audio di-burn dengan harga list resmi yang ditampilkan di /models.
  • · Nilai Max ($100 → 4×) dan Enterprise ($1,000 → 6×) berasal dari kredit ekstra yang diberikan saat top-up, bukan dari tier diskon per model.
  • · Tanpa eligibility bucket, tanpa fine print per model — kredit Anda berlaku sama di Claude Opus, GPT-5.5, dan Gemini Flash.

Multiplier berlaku per top-up. Kredit Max yang ada tetap memiliki nilai 4× hingga Anda menghabiskannya — top up Pro setelahnya dan $10 itu memberikan 20M kredit dengan 1×. Lihat /pricing untuk rincian lengkap.

13. Rate Limits & Errors

Rate limit per user

EndpointRequest / jam
/v1/messages, /v1/chat/completions, /v1/gemini1,000
/v1/images/generations500
/v1/responses, /v1/codex/*1,000

Status rate-limit dikembalikan dalam response header: x-ratelimit-limit, x-ratelimit-remaining, x-ratelimit-reset.

Kode error

StatusArti
401API key tidak ada / tidak valid
402Kredit tidak mencukupi — top up di /checkout
403Tier tidak membuka model yang diminta (mis. Opus 4.7)
429Rate limit per user tercapai
503Model terdaftar namun Coming Soon
504Image generation timeout (retry)

14. Segera Hadir

Tercantum secara publik tetapi API menolaknya sampai marjin di bawah model pengganda kredit stabil:

Image (lainnya)

Keluarga 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.

Audio

Fish Audio TTS, Voice Clone, ASR.

Lihat daftar lengkap di /models. Entry coming-soon mengembalikan HTTP 503 dari API; memanggilnya hari ini adalah no-op yang tidak menagih kredit.

Siap untuk memulai?

Satu key bekerja di Claude Code, OpenCode, Codex CLI, Gemini CLI, dan Cursor. Top up kredit dan buat API key Anda.

Lihat PaketKelola API Keys
Logo
Zenn.CEOKecerdasan Frontier untuk Semua Orang
XX (Twitter)GitHubLinkedInEmail
Product
  • Chat
  • API
  • Pricing
Perusahaan
  • About
  • Kontak
  • Kebijakan Cookie
  • Kebijakan Privasi
  • Syarat Layanan
  • Kebijakan Refund
Semua sistem normal
•Dibangun dari California dengan Cinta ❤️
© Hak Cipta 2026. Semua Hak Dilindungi.