Ezkielyna API docs
Ezkielyna API · Documentation

Build with leading AI models through one API key.

Ezkielyna API works with the OpenAI and Anthropic formats you already know. Change the base URL, paste your key, and your existing SDKs, apps and coding agents just work.

Baru pakai API?Baca Panduan Bahasa Indonesia: langkah demi langkah untuk Cherry Studio, Chatbox, Cline, OpenCode, Hermes Agent, Claude Code, dan lainnya.

Quickstart

1Create an account

Sign up with your email and verify it.

2Add balance

Buy an Ezkielyna API Credit pack at ezkielyna.store, then redeem the code in Wallet.

3Create an API key

Open API Keys → Create API Key. Choose the Auto group: one key for text, Claude, GPT, images and video.

Use this base URL everywhere:

Base URL
https://api.ezkielyna.store/v1

Send your first request (replace sk-YOUR_KEY with your key):

Terminal
curl https://api.ezkielyna.store/v1/chat/completions \
  -H "Authorization: Bearer sk-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"deepseek-v4.1-flash","stream":true,"messages":[{"role":"user","content":"Hello!"}]}'
Keep your key secretAnyone with your key can spend your balance. Never paste it in public code, screenshots or group chats. You can delete and recreate keys at any time.

API keys & groups

Every key belongs to a group. The group decides which models the key can use and the price multiplier. You pick it when you create the key.

GroupRateModels
Auto recommended1× / 1.5×Text, Claude, GPT, images and video in one key. Tries Standard, then Premium, then Hemat, then Media — each model is billed at the rate of the group that serves it. Auto does not use Pro.
Standard1×Text models: DeepSeek, GLM, Kimi K2, MiniMax, Qwen, MiMo, Hy4, embeddings & rerank. No Claude, GPT, images or video.
Premium1.5×Claude, GPT, Grok, Gemini 3.1 Pro, Kimi K3, Qwen Max. Text only — no images or video.
Pro3×Claude, GPT and Grok through a backup route, used when the main route is full. Also the only place for claude-opus-4.5 and claude-sonnet-4.5. Pick it yourself when you create the key; Auto does not use it.
Media1×All image and video models: GPT Image, Nano Banana, Flux, Imagen, Ideogram, Seedream, Seedance, Kling, Veo, Wan, Sora, Vidu, Grok Imagine, MiniMax and Muse. Trial and promo accounts cannot create Media keys.
Hemat1×Budget models: hy3, hy4-preview, hy4-preview-f, edge-tts, auto.
TipIf a model returns No available channel for model … under group …, your key's group does not include that model. Create a key in the Auto group (or the group shown in Model Square). Image and video models need a Media or Auto key; Claude and GPT need Premium or Auto.

OpenAI format

Point any OpenAI SDK or tool at https://api.ezkielyna.store/v1. Supported endpoints: /chat/completions, /embeddings, /rerank, /images/generations, /audio/speech, /audio/transcriptions, /videos and /models.

from openai import OpenAI

client = OpenAI(
    base_url="https://api.ezkielyna.store/v1",
    api_key="sk-YOUR_KEY",
)

stream = client.chat.completions.create(
    model="deepseek-v4.1-flash",
    messages=[{"role": "user", "content": "Explain RAG in two sentences."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

List the models your key can use: GET https://api.ezkielyna.store/v1/models.

Anthropic format

Every chat model also speaks the Anthropic Messages API. Use base URL https://api.ezkielyna.store (the SDK adds /v1/messages) and send your key as x-api-key.

from anthropic import Anthropic

client = Anthropic(
    base_url="https://api.ezkielyna.store",
    api_key="sk-YOUR_KEY",
)

message = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Write a haiku about Jakarta."}],
)
print(message.content[0].text)

Any model works here — for example deepseek-v4-pro or glm-5.3 through the Anthropic format as well.

Streaming & reasoning tips

  • Use "stream": true. You see the first words sooner, and long answers never time out. Non-stream requests also work, but must finish within 100 seconds (otherwise you get 524), so always stream long or reasoning-heavy answers.
  • Reasoning models think first. Models such as kimi-k3, glm-5.3, hy4 or deepseek-v4-pro spend tokens on a thinking phase. Give them enough max_tokens (2,000+), or the visible answer can be empty.
  • Go faster and cheaper with "reasoning_effort": "low" for simple tasks (chat, summaries, translations).
  • Big prompts take longer. A 100k-token prompt usually needs 6–12 seconds before the first token. Keep context short when you can.
  • Prompt caching is automatic on supported models and makes repeated context up to 4× cheaper.
  • Images: base64 data: URLs work on every vision model; plain https:// image URLs can fail on some models. Requests can be up to 32 MB.
  • Base URL: https://api.ezkielyna.store/v1 for OpenAI-style clients, https://api.ezkielyna.store for Anthropic/Claude Code. Not supported: /v1/messages/count_tokens and legacy /v1/completions.
  • Need speed? Try glm-5.3-flash or deepseek-v4.1-flash (first token in ~1–2 s).

Embeddings, images, video & audio

Embeddings & rerank (RAG)

curl https://api.ezkielyna.store/v1/embeddings \
  -H "Authorization: Bearer sk-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"bge-m3","input":["Halo dunia","Hello world"]}'

Good picks: bge-m3 or qwen3-embedding-0.6b (multilingual, great for Indonesian) and bge-reranker-base for reranking.

Images

Terminal
curl https://api.ezkielyna.store/v1/images/generations \
  -H "Authorization: Bearer sk-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-image-2","prompt":"a cozy coffee shop in Bandung, watercolor"}'

Image and video models are in the Media group: use a Media or Auto key. A Standard or Premium key cannot call them.

You get a 1024×1024 image link that stays online for 24 hours — download it right away, or add "response_format":"b64_json" to receive the image data directly. Models include gpt-image-2, nano-banana-2, flux.2-max, ideogram-4 and grok-imagine-image-pro; the full list is in Model Square under the Media group.

Video

Video is generated in the background. Submit a job, poll its status, then download the MP4. Use a Media or Auto key.

Terminal
# 1) submit (seconds: 4, 8 or 12 · size: 1280x720 or 720x1280)
curl https://api.ezkielyna.store/v1/videos \
  -H "Authorization: Bearer sk-YOUR_KEY" -H "Content-Type: application/json" \
  -d '{"model":"grok-imagine-video","prompt":"a red kite over the sea","seconds":"4","size":"1280x720"}'

# 2) check status until "completed"
curl https://api.ezkielyna.store/v1/videos/TASK_ID -H "Authorization: Bearer sk-YOUR_KEY"

# 3) download
curl -L -o video.mp4 https://api.ezkielyna.store/v1/videos/TASK_ID/content -H "Authorization: Bearer sk-YOUR_KEY"

Video is billed per second of footage.

Text-to-speech

Terminal
curl https://api.ezkielyna.store/v1/audio/speech \
  -H "Authorization: Bearer sk-YOUR_KEY" -H "Content-Type: application/json" \
  -d '{"model":"edge-tts","input":"Halo, selamat datang!","voice":"id-ID-GadisNeural"}' \
  -o speech.mp3

edge-tts is a Standard model. Voice: an Edge voice ID such as id-ID-GadisNeural, id-ID-ArdiNeural or en-US-AriaNeural, or an OpenAI voice name such as alloy. Output is MP3, up to 4,096 characters per request, billed per character.

One-click apps

The fastest way to chat: open the Chat menu in the console sidebar, pick an app and choose one of your keys. The app opens with Ezkielyna already configured.

AppPlatformWhat happens
Cherry StudioWindows · macOS · LinuxAdds an “Ezkielyna” provider with your key. Then click Manage → add the models you want.
CC SwitchWindows · macOS · LinuxConfigures Claude Code or Codex in one click. Pick the app and default model in the dialog.
ChatboxWindows · macOS · Linux · mobileImports an “Ezkielyna API” provider with popular models pre-listed.
DeepChatWindows · macOS · LinuxInstalls the provider with your key.
AionUIWindows · macOS · LinuxAdds the provider with your key.
LobeChatWebOpens LobeChat in the browser with your key and base URL filled in.
AI as WorkspaceWebOpens AIaW with the provider set.
OpenCatiOS · macOSJoins the Ezkielyna server in OpenCat.
Nothing happens when you click?Install the desktop app first, then click again. Desktop apps open through a link like cherrystudio://…; your browser may ask “Open app?” — allow it. If it still fails, set it up manually: provider type OpenAI-compatible, base URL https://api.ezkielyna.store/v1, and your key.

Ezkielyna Studio

studio.ezkielyna.store is a browser workspace for your Ezkielyna API key: chat with any text model, create images and videos, and keep prompts, canvases and assets in one place. Charges come from your normal API balance.

Chat

Pick a model, send text or photos (vision models read images), get streamed answers. Billed per token.

Image Studio

GPT image: quality and size. Grok Imagine 2.0: 9 aspect ratios, 1K/2K. Up to 4 images per run, each billed separately.

Video Studio

Landscape 16:9 or portrait 9:16, 4/8/12 seconds, billed per second. Output is currently about 480p.

  1. Create a key in API Keys with the Auto group (it includes Media, where the image and video models live). Trial and promo accounts cannot create Media keys.
  2. Open Studio → Account & settings → paste the key → Connect your account. The key is kept server-side for the session only, never in the browser.
  3. Check the estimated charge in the confirm dialog, then generate. Results stay in your history for 7 days — download what you want to keep.
Usage policyNo sexual content involving minors, no sexual images or deceptive deepfakes of real people, no violent, hateful or illegal content, no scams or forged documents. Report abuse with the task ID to [email protected].

Studio is available in English, Chinese and Bahasa Indonesia (/id/). Step-by-step guide in Indonesian: Panduan → Ezkielyna Studio.

Claude Code, Codex & IDEs

Claude Code

Easiest: use CC Switch from the Chat menu. Or set these environment variables before running claude:

export ANTHROPIC_BASE_URL="https://api.ezkielyna.store"
export ANTHROPIC_AUTH_TOKEN="sk-YOUR_KEY"
export ANTHROPIC_MODEL="claude-sonnet-5"
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-5"
export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-5.5"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-v4.1-flash"
claude

Want a cheaper coding model? Set ANTHROPIC_MODEL to kimi-k3, glm-5.3 or deepseek-v4-pro — they all work through the Anthropic format.

Codex CLI

Add a provider to ~/.codex/config.toml and set your key as an environment variable:

~/.codex/config.toml
model = "deepseek-v4.1-flash"
model_provider = "ezkielyna"

[model_providers.ezkielyna]
name = "Ezkielyna API"
base_url = "https://api.ezkielyna.store/v1"
env_key = "EZKIELYNA_API_KEY"
wire_api = "responses"
Terminal
export EZKIELYNA_API_KEY="sk-YOUR_KEY"
codex

Cursor

  1. Open Settings → Models.
  2. Under OpenAI API Key, paste your key and enable Override OpenAI Base URL → https://api.ezkielyna.store/v1.
  3. Click Add model and type the exact model name, e.g. claude-sonnet-5 or deepseek-v4-pro.

Cline, Roo Code & Kilo Code (VS Code)

  1. API Provider: OpenAI Compatible.
  2. Base URL: https://api.ezkielyna.store/v1 · API Key: your key.
  3. Model ID: any model name from Model Square, e.g. kimi-k3.

OpenCode

opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "ezkielyna": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Ezkielyna API",
      "options": { "baseURL": "https://api.ezkielyna.store/v1", "apiKey": "sk-YOUR_KEY" },
      "models": { "kimi-k3": {}, "glm-5.3": {}, "claude-sonnet-5": {} }
    }
  }
}

Continue

config.yaml
models:
  - name: Ezkielyna DeepSeek
    provider: openai
    model: deepseek-v4-pro
    apiBase: https://api.ezkielyna.store/v1
    apiKey: sk-YOUR_KEY

Other apps

Any app with an “OpenAI-compatible” option works with the same three values:

FieldValue
Base URL / API hosthttps://api.ezkielyna.store/v1 (some apps want it without /v1)
API keyYour key (sk-…)
ModelExact name from Model Square

This includes Open WebUI (Settings → Connections → OpenAI API), NextChat, n8n (OpenAI credentials → Base URL), Dify, Flowise, LangChain and LlamaIndex.

Models & pricing

Model Square lists every model with its live price. You pay only for what you use:

  • Chat — input tokens + output tokens (cached input is cheaper).
  • Images — per image. Video — per second. Transcription — per file. Text-to-speech — per character.
  • The group rate is applied on top (Standard 1×, Premium 1.5×, Media 1×, Hemat 1×, Pro 3×).

What $10 gets you

Rough estimates with a 4:1 input:output ratio and no caching.

ModelGroupAbout
hy3 / hy4-previewHemat500 million tokens
deepseek-v4.1-flashStandard460 million tokens
glm-5.3-flashStandard548 million tokens
deepseek-v4-proStandard131 million tokens
minimax-m3Standard81 million tokens
kimi-k2.6Standard50 million tokens
glm-5.3Standard97 million tokens
kimi-k3Premium21 million tokens
gpt-5.6Premium30 million tokens
claude-sonnet-5Premium17 million tokens
claude-opus-5.5Premium12 million tokens
bge-m3 (embeddings)Standard658 million tokens
grok-imagine-imageMedia110 images
grok-imagine-videoMedia47 seconds of video

Balance, top up & refunds

  • Top up: buy an Ezkielyna API Credit pack at ezkielyna.store (QRIS, Binance Pay, crypto or bot balance). You receive a redeem code — enter it in Wallet.
  • Track usage: every request (model, tokens, cost, speed) appears in Usage Logs. Your balance is on the Dashboard.
  • Failed requests: if a normal-size streamed request fails before any output is produced, the charge is refunded automatically within about 10 minutes.
  • Promo bonus: sign-up bonus balance works on Standard models. When you top up, the same amount of bonus unlocks for Premium models too. Trial and promo accounts cannot create Media keys, so image and video need a top-up first.

Troubleshooting

MessageWhat it meansFix
401 Invalid tokenWrong, deleted or disabled key — or the key's own quota is used up (status Exhausted in API Keys).Copy the key again from API Keys (it starts with sk-), or raise the key's quota.
403 / insufficient quota / 用户额度不足Wallet balance is empty, or the key's quota limit is reached (token quota is not enough).Top up at ezkielyna.store and redeem in Wallet, or raise the key's quota in API Keys.
503 No available channel for model X under group YThe model is not in your key's group, or the name is misspelled. Accounts on the free signup bonus can use Standard models only.Use an Auto key and check the exact name in Model Square. Premium models unlock after your first top-up. Image and video need a Media or Auto key.
429 / rate limitMore than 300 requests/min or 50 parallel requests from one IP, or the model provider is busy.Wait the Retry-After seconds and retry; slow down parallel requests.
404 wrong_base_url or an HTML page instead of JSONThe base URL is missing /v1.Use https://api.ezkielyna.store/v1 (Anthropic clients: without /v1).
413 request_too_largeThe request is larger than 32 MB.Send smaller or fewer images, and trim long contexts.
524 (Cloudflare page)A non-stream request took longer than 100 seconds.Use "stream": true for long answers and reasoning models.
Empty answerA reasoning model used all max_tokens for thinking.Raise max_tokens or add "reasoning_effort":"low".
Slow first tokenVery long prompt or a reasoning model.Stream, trim context, or pick a flash model.
Image link says expiredImage links last 24 hours.Download immediately or request b64_json.

FAQ & support

Which model should I start with?
For everyday chat and coding help, deepseek-v4.1-flash or glm-5.3-flash are fast and very cheap. For the hardest coding and reasoning, try kimi-k3, claude-sonnet-5 or gpt-6.1-sol.
Do I need a separate key for Claude and GPT?
No. One key in the Auto group covers text, Claude, GPT, images and video, in both the OpenAI and Anthropic formats. Only the Pro backup group (3×) is picked separately.
Is my data stored?
Your usage logs record metadata only — model, token counts, cost and timing — not the content of your prompts or answers.
Can I get an invoice or help with a payment?
Yes — contact us with your order code from ezkielyna.store.

Still stuck? Email [email protected], message the admin on WhatsApp wa.me/6285710999204, ask in the Telegram community t.me/EzkielynaCommunity or use the bot @EzkielynaStore_Bot. Live model health: status page.

© 2026 Ezkielyna API — a service of Ezkielyna AI Group, makers of the Ezkielyna Store.