DocsAPI Docs

ZORO Inference API — Chat Completion Interface

Connect, prompt, retrieve — developer tools

The ZORO Inference API provides an OpenAI-compatible chat interface for interacting with wallet-bound AI agents. It supports API key authentication, persistent memory context, and is ideal for integrating intelligent agents into Web3 applications.

⚠️ API access is currently in private testing. You can generate your API key in your user dashboard.


API Access

Base URL:

https://api.zoro.org/api-v1/

Authentication: All requests must include your API key in the header:

Authorization: Bearer <API Key>

🔑 You can create and manage your API key in the user dashboard.


Chat Completion Endpoint (OpenAI-Compatible)

Endpoint:

POST https://api.zoro.org/api-v1/chat/completions

Request Example:

{
  "model": "zoro-llm-v1",
  "messages": [
    {"role": "system", "content": "You are a AI assistant."},
    {"role": "user", "content": "Hello!"},
    {"role": "assistant", "content": "Hi how can i help you?"}
  ],
  "temperature": 0.3
}

Optional Parameters:

  • temperature: float (0.0-1) — controls randomness in output. Lower values make responses more focused and deterministic

Code Examples

cURL:

curl -X POST https://api.zoro.org/api-v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <your-zoro-api-key>" \
  -d '{
    "model": "zoro-llm-v1",
    "messages": [
      {"role": "system", "content": "You are a AI assistant."},
      {"role": "user", "content": "Hello!"},
      {"role": "assistant", "content": "Hi how can i help you?"}
    ],
    "temperature": 0.3
  }'

Python:

from openai import OpenAI

client = OpenAI(
    api_key="<your-zoro-api-key>",
    base_url="https://api.zoro.org/api-v1/"
)

response = client.chat.completions.create(
    model="zoro-llm-v1",
    messages=[
        {"role": "system", "content": "You are a AI assistant."},
        {"role": "user", "content": "Hello!"},
        {"role": "assistant", "content": "Hi how can i help you?"}
    ],
    temperature=0.3
)

print(response.content)

Node.js:

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: '<your-zoro-api-key>',
  baseURL: 'https://api.zoro.org/api-v1/'
});

const response = await client.chat.completions.create({
  model: 'zoro-llm-v1',
  messages: [
    {role: 'system', content: 'You are a AI assistant.'},
    {role: 'user', content: 'Hello!'},
    {role: 'assistant', content: 'Hi how can i help you?'}
  ],
  temperature: 0.3
});

console.log(response.content);

Response: Returns:

  • AI-generated message(s)
  • Token usage

Billing

API usage is billed in ZORO tokens, based on the number of generated tokens:

Call TypeBilling Formula
Chat Completion0.0001 $ZORO × tokens_generated

Examples:

  • 50 tokens → 0.005 $ZORO
  • 300 tokens → 0.03 $ZORO

Subscription Plan

20 $$ZORO/month includes:

  • Unlimited basic chat access
  • Persistent memory and session history
  • Reduced per-token billing rate
  • Access to advanced context modes

SDKs (Coming Soon)

Planned SDKs:

  • TypeScript (@zoro-ai/sdk)
  • Python (zoro_sdk)
  • Node.js (native)

AI Agent Creation
AI-on-Chain
$ZORO
Run a Node