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 30 RPM for gpt-5.5. Token packs and PAYG credit can use all published Zora GPT/Codex text routes. 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.

Avoid 401 invalid_api_key
Use the full key copied from Dashboard API Keys. Do not use the placeholder text, a masked key with* characters, an older disabled key, or a key with leading/trailing spaces. The header must beAuthorization: Bearer YOUR_ZORA_API_KEY.

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. Detailed Codex troubleshooting is available in Responses API for Codex CLI.

Install
npm install -g @openai/codex codex --version
~/.codex/config.toml
model_provider = "zora" model = "gpt-5.5" [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 = "YOUR_ZORA_API_KEY" codex exec -m gpt-5.5 "Reply with exactly: ZORA_CODEX_OK"
macOS / Linux smoke test
export ZORA_API_KEY="YOUR_ZORA_API_KEY" codex exec -m gpt-5.5 "Reply with exactly: ZORA_CODEX_OK"
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. Anthropic-Compatible Route Status

Production model discovery now returns the Zora model IDs. Prefer direct Zora model IDs such asgpt-5.5 and gpt-5.4-mini; legacy Claude-style aliases are no longer part of the public model catalog. The Anthropic-compatible /v1/messages route is disabled while production is in current production mode.

Status
POST /v1/messages is disabled in current production mode. Use /v1/responses or /v1/chat/completions with gpt-5.5, gpt-5.4-mini, or another model from GET /v1/models.
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. If you still keep Claude-style settings locally, verify the selected model is one of the current Zora model IDs from GET /v1/models.

6. Use With VS Code

Yes. Zora can be used in VS Code through extensions that support a custom OpenAI-compatible provider. Use the base URL https://api.zora.io.vn/v1, your Zora API key, and a chat model such asgpt-5.5. VS Code tools usually call /v1/chat/completions; tools that use the newer OpenAI Responses wire format can call /v1/responses.

Cline

  1. Install the official Cline extension in VS Code.
  2. Open Cline settings and choose OpenAI Compatible as the API provider.
  3. Set Base URL to https://api.zora.io.vn/v1.
  4. Set API Key to your Zora API key.
  5. Set Model ID to gpt-5.5 or another Zora model available on your plan.
  6. Leave custom headers empty and keep the Azure options disabled.
  7. Use the exact model ID without extra suffixes or model-mode aliases.
  8. Click continue, then send a short test prompt.
Cline test prompt
Reply with exactly one sentence: Zora VS Code test OK.
Cline checkpoint warning
If Cline shows Cannot use checkpoints in Desktop directory, the API is not failing. Open a normal project folder such as C:\web\my-project instead of the Desktop folder, then start a new Cline task. A successful API test returns a normal assistant message such as Hi! How can I help you today?.

Continue

Continue uses ~/.continue/config.yaml for local model configuration. Add a Zora model entry like this:

~/.continue/config.yaml
name: Zora version: 1.0.0 schema: v1 models: - name: Zora GPT 5.5 provider: openai model: gpt-5.5 apiBase: https://api.zora.io.vn/v1 apiKey: YOUR_ZORA_API_KEY roles: - chat - edit - apply
VS Code compatibility note
Extensions that only support the official OpenAI endpoint or only GitHub Copilot billing cannot use a custom Zora base URL. Pick a VS Code extension with an OpenAI-compatible or custom base URL setting, and prefer its local secrets store when it is available.

7. Install The SDK

Python
pip install openai
Node.js
npm install openai

8. Make Your First SDK Request

Windows terminal note
PowerShell does not use bash line continuations. If you copy a curl example with \, use the PowerShell tab below or run it from Git Bash, WSL, macOS, or Linux.
Auth smoke test
curl https://api.zora.io.vn/v1/models \ -H "Authorization: Bearer YOUR_ZORA_API_KEY"
from openai import OpenAI client = OpenAI( api_key="YOUR_ZORA_API_KEY", base_url="https://api.zora.io.vn/v1" ) response = client.chat.completions.create( model="gpt-5.5", messages=[ {"role": "user", "content": "Hello Zora"} ] ) print(response.choices[0].message.content)

Model IDs

Production uses the exact Zora model IDs returned by GET /v1/models. Audio routes use their own exact model IDs from GET /v1/audio/models.

Examples
gpt-5.5 gpt-5.4 gpt-5.4-mini gpt-5.3-codex whisper-large-v3 whisper-large-v3-turbo
Agent-readable setup
AI agents should use /llms.txt and /docs/agent to guide users safely.