Knowledge base

Tìm nhanh trong tài liệu Zora

Quick Start

Zora is OpenAI-compatible. Sign in with Google, get your API key, then point your OpenAI SDK client tohttps://api.zora.io.vn/v1.

1. Sign In With Google

Zora supports Google login only. Open Login, continue with Google, then go to your dashboard.

2. Choose A Plan

Free tier includes 50 requests at 2 RPM for selected Zora and premium chat routes. Paid plans unlock all Zora GPT/Codex families, all four reasoning modes, and Zora audio routes; claude-sonnet-4.5 opens from the 7-day plan upward. Payments use VNPay/VietQR by default. International customers can choose PayPal or Crypto on the payment page and contact Telegram support with the payment code.

3. Get Your API Key

Open Dashboard API Keys and create or retrieve your Zora key. Store the key only in your local tool config or environment variables.

4. Use With Codex CLI

Codex CLI uses the Responses protocol for custom providers. Zora exposes /v1/responses, so configure Codex as a Zora provider and keep the API key in an environment variable. On Windows,~/.codex/config.toml means C:\Users\YOUR_NAME\.codex\config.toml.

Install
npm install -g @openai/codex codex --version
~/.codex/config.toml
model_provider = "zora" model = "gpt-5.5-low" [model_providers.zora] name = "Zora" base_url = "https://api.zora.io.vn/v1" env_key = "ZORA_API_KEY" wire_api = "responses"
PowerShell smoke test
$env:ZORA_API_KEY = "zr_live_sk_your_key_here" codex exec -m gpt-5.5-low "Reply with one short sentence."
macOS / Linux smoke test
export ZORA_API_KEY="zr_live_sk_your_key_here" codex exec -m gpt-5.5-low "Reply with one short sentence."
Keep the key private
Do not paste the Zora API key into public chat, commit it to a repository, or store it in frontend code. The config file should reference ZORA_API_KEY, not contain the raw key.

5. Use With Claude Code

Claude Code uses the Anthropic Messages API. Zora exposes /v1/messages and accepts your Zora key through ANTHROPIC_API_KEY, so set the base URL without the /v1 suffix. Zora also exposes Claude Code discovery aliases such as anthropic/zora-gpt-5.5-lowfor the model picker; the direct Zora model IDs still work in --model.

PowerShell
$env:ANTHROPIC_BASE_URL = "https://api.zora.io.vn" $env:ANTHROPIC_API_KEY = "zr_live_sk_your_key_here" $env:ANTHROPIC_MODEL = "gpt-5.5-low" $env:ANTHROPIC_DEFAULT_SONNET_MODEL = "gpt-5.5-low" $env:ANTHROPIC_DEFAULT_HAIKU_MODEL = "gpt-5.4-low" $env:ANTHROPIC_CUSTOM_MODEL_OPTION = "gpt-5.5-low" $env:ANTHROPIC_CUSTOM_MODEL_OPTION_NAME = "Zora GPT 5.5 Low" claude --model gpt-5.5-low
macOS / Linux
export ANTHROPIC_BASE_URL="https://api.zora.io.vn" export ANTHROPIC_API_KEY="zr_live_sk_your_key_here" export ANTHROPIC_MODEL="gpt-5.5-low" export ANTHROPIC_DEFAULT_SONNET_MODEL="gpt-5.5-low" export ANTHROPIC_DEFAULT_HAIKU_MODEL="gpt-5.4-low" export ANTHROPIC_CUSTOM_MODEL_OPTION="gpt-5.5-low" export ANTHROPIC_CUSTOM_MODEL_OPTION_NAME="Zora GPT 5.5 Low" claude --model gpt-5.5-low
Existing Claude Code config
If ~/.claude/settings.json already contains an env block, it can override shell variables. Update that file or launch Claude Code with a separate --settings file for Zora. Current Claude Code versions use ANTHROPIC_DEFAULT_HAIKU_MODEL for the fast model alias.

6. Install The SDK

Python
pip install openai
Node.js
npm install openai

7. Make Your First SDK Request

from openai import OpenAI client = OpenAI( api_key="zr_live_sk_your_key_here", base_url="https://api.zora.io.vn/v1" ) response = client.chat.completions.create( model="gpt-5.5-low", messages=[ {"role": "user", "content": "Hello Zora"} ] ) print(response.choices[0].message.content)

Model Modes

Zora GPT/Codex paid routes can use low, medium, high, and xhigh. Use higher modes when you need deeper reasoning and keep low/medium for faster routine coding tasks. Audio routes use their exact model IDs without a Zora reasoning suffix.

Examples
gpt-5.5-low gpt-5.5-medium gpt-5.5-high gpt-5.5-xhigh gpt-5.4-medium whisper-large-v3 whisper-large-v3-turbo
Agent-readable setup
AI agents should use /llms.txt and /docs/agent to guide users safely.