📚 API Documentation

Our API is fully compatible with OpenAI's API format. Simply change the base URL and use your API key.

Base URL

https://zaijiank.cloud/v1

Authentication

Include your API key in the Authorization header:

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

Endpoints

POST /v1/chat/completions

Send a chat completion request

Request Body

ParameterTypeRequiredDescription
modelstringYesModel to use (gpt-4, gpt-4o, gpt-3.5-turbo, claude-3-5-sonnet)
messagesarrayYesArray of message objects
temperaturefloatNoResponse creativity (0-2, default 0.7)
max_tokensintegerNoMax response length
streambooleanNoEnable streaming responses

Example Request

curl https://zaijiank.cloud/v1/chat/completions \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4",
    "messages": [
      {"role": "system", "content": "You are a helpful assistant."},
      {"role": "user", "content": "Hello!"}
    ]
  }'

Example Response

{
  "id": "chatcmpl-123",
  "object": "chat.completion",
  "created": 1677652288,
  "model": "gpt-4",
  "choices": [{
    "index": 0,
    "message": {
      "role": "assistant",
      "content": "Hello! How can I help you today?"
    },
    "finish_reason": "stop"
  }]
}

Models

ModelDescriptionPrice (per 1M tokens)
gpt-4Most capable model$30 in / $60 out
gpt-4oLatest GPT-4 model$5 in / $15 out
gpt-3.5-turboFast & cost-effective$0.5 in / $1.5 out
claude-3-5-sonnetAnthropic Claude 3.5$3 in / $15 out

Error Codes

CodeDescription
invalid_api_keyInvalid or missing API key
insufficient_balanceAccount has insufficient balance
rate_limit_exceededToo many requests
model_not_foundModel does not exist

SDK Integration

Python

from openai import OpenAI

client = OpenAI(
    api_key="sk-your-api-key",
    base_url="https://zaijiank.cloud/v1"
)

response = client.chat.completions.create(
    model="gpt-4",
    messages=[{"role": "user", "content": "Hello!"}]
)

JavaScript/Node.js

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: 'sk-your-api-key',
  baseURL: 'https://zaijiank.cloud/v1'
});

const response = await client.chat.completions.create({
  model: 'gpt-4',
  messages: [{ role: 'user', content: 'Hello!' }]
});