Knowledge base

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

Zora API Documentation

Zora provides OpenAI-compatible GPT 5.5, Claude-compatible chat access, image generation, and audio speech tools through a single Zora API key. It can also be used from VS Code extensions that support a custom OpenAI-compatible base URL. The current product focuses on GPT 5.5, Claude aliases, async audio routes, clear request packages, VNPay/VietQR payment, PayPal or Crypto support via Telegram, and Google-only account login.

OpenAI SDK compatible
Use your existing OpenAI SDK client. Change the base URL to https://api.zora.io.vn/v1 and use your Zora API key.

Core Flow

  • Google login only - users sign in with Google before payments or API key setup.
  • Plan quotas - plans can use request quotas, token quotas, RPM limits, or route-specific limits.
  • Model IDs - use exact model IDs from GET /v1/models.
  • VNPay/VietQR payment - the user scans a generated QR code from their own banking app.
  • PayPal/Crypto support - international customers can DM Telegram with the payment code for manual confirmation.
  • Agent-readable docs - AI agents can read /llms.txt and /api/agent/manifest.

Base URL

Base URL
https://api.zora.io.vn/v1

Authentication

User accounts use Google login. API requests use the full, unmasked Zora API key in theAuthorization header.

HTTP Header
Authorization: Bearer YOUR_ZORA_API_KEY
401 checklist
A 401 invalid_api_key means the key is missing, mistyped, masked, revoked, or from an older disabled key. Copy the full key from Dashboard API Keys, remove extra spaces or quotes, and keep the header exactly as Authorization: Bearer YOUR_ZORA_API_KEY.

Available Endpoints

POST/v1/chat/completions
Create a chat completion with a supported Zora GPT or Claude-compatible model.
POST/v1/responses
Responses API route used by Codex CLI custom providers.
POST/v1/messages
Anthropic-compatible Messages route used by Claude Code.
POST/v1/audio/speech
Create an async text-to-speech task with a selected voice.
POST/v1/audio/transcriptions
Transcribe uploaded audio with a supported Zora audio model.
GET/v1/audio/tasks/{task_id}
Poll async audio tasks and read output URLs from task metadata.
POST/v1/images/jobs
Submit one-image async jobs and poll for Zora-hosted file URLs.
POST/v1/images/generations
Generate one-off n=1 images as public Zora file URLs; over-RPM requests return 429.
GET/v1/models
List model IDs exposed by your Zora plan.
GET/api/agent/manifest
Machine-readable Zora setup manifest for AI agents.