API Documentation

Everything you need to integrate Ezkielyna API into your application.

Quick Start

Get started with Ezkielyna API in 3 simple steps. No credit card required.

Create Account

Get API Key

Generate your API key from the Dashboard → API Keys page.

Make Requests

Use your key to call any supported AI model via our gateway.

Create Free Account

Your First API Call

Ezkielyna API is 100% compatible with the OpenAI SDK. Just change the base_url and api_key:

bash

curl -X POST https://api-ezkielyna.tech/api/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ez-your-api-key-here" \
  -d '{
    "model": "gpt-4o",
    "messages": [
      {"role": "system", "content": "You are a helpful assistant."},
      {"role": "user", "content": "Explain quantum computing in simple terms"}
    ],
    "temperature": 0.7,
    "max_tokens": 500
  }'

Example Response

json

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "created": 1716000000,
  "model": "gpt-4o",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Quantum computing uses quantum bits..."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 25,
    "completion_tokens": 150,
    "total_tokens": 175
  }
}

Authentication

All API requests require a Bearer token in the Authorization header.

http

Authorization: Bearer ez-your-api-key-here

⚠️ Keep your API key secret. Do not expose it in client-side code, public repos, or browser requests. Use server-side calls or environment variables.

Getting Your API Key

Log in to your Dashboard
Navigate to API Keys in the sidebar
Click "Create New Key"
Copy and securely store your key (it will only be shown once)

API Endpoints

All endpoints are OpenAI-compatible. Base URL: https://api-ezkielyna.tech/api/v1

Method	Endpoint	Description
POST	/chat/completions	Chat completions (GPT, Claude, Gemini)
POST	/completions	Text completions (legacy)
POST	/embeddings	Text embeddings
GET	/models	List available models
POST	/images/generations	Image generation (DALL·E, etc.)

Streaming Responses

Add "stream": true to receive Server-Sent Events (SSE):

javascript

const response = await client.chat.completions.create({
  model: "claude-3.5-sonnet",
  messages: [{ role: "user", content: "Write a poem about AI" }],
  stream: true,  // Enable streaming
});

for await (const chunk of response) {
  const content = chunk.choices[0]?.delta?.content || "";
  process.stdout.write(content);
}

Supported Models

Access all major AI models through a single API key:

OpenAI

gpt-4ogpt-4o-minigpt-4-turbogpt-3.5-turbodall-e-3

Anthropic

claude-3.5-sonnetclaude-3-opusclaude-3-haiku

Google

gemini-1.5-progemini-1.5-flashgemini-pro

Other

deepseek-v3deepseek-codermixtral-8x7b

Error Handling

The API uses standard HTTP status codes and returns JSON error responses:

json

{
  "error": {
    "message": "Insufficient balance to process this request.",
    "type": "insufficient_balance",
    "code": 402
  }
}

Code	Meaning	Solution
400	Bad Request	Check your request body and parameters
401	Unauthorized	Check your API key is valid
402	Insufficient Balance	Top up your account balance
403	Model Not Allowed	Upgrade your plan to access this model
429	Rate Limited	Slow down; check Retry-After header
500	Server Error	Retry after a moment; contact support if persistent

Billing & Pricing

Ezkielyna API uses a pay-as-you-go model. You only pay for what you use — no monthly subscriptions required.

💳 How It Works

Top up your balance via the Dashboard
Each API call deducts from your balance based on token usage
Monitor your usage in real-time from the Dashboard

📊 Usage Tracking

View token consumption per model
Daily and weekly usage charts
Export usage data as CSV