Cloud · OpenAI SDK · Zenith Docs

Install

Terminal

pip install openai
# or
npm install openai

First request

Choose your language. Python and Node.js use the official OpenAI SDK; Go, PHP, and curl show the same portable HTTP contract with no Zenith-specific package.

chat.py

from openai import OpenAI

client = OpenAI(
    base_url="https://zenithgw.com/api/v1",
    api_key="zk_YOUR_CLOUD_KEY",
)
response = client.chat.completions.create(
    model="auto",
    messages=[{"role": "user", "content": "Hello from Zenith"}],
)
print(response.choices[0].message.content)

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://zenithgw.com/api/v1",
  apiKey: "zk_YOUR_CLOUD_KEY",
});
const response = await client.chat.completions.create({
  model: "auto",
  messages: [{ role: "user", content: "Hello from Zenith" }],
});
console.log(response.choices[0].message.content);

package main

import (
    "bytes"
    "fmt"
    "io"
    "net/http"
    "os"
)

func main() {
    body := []byte("{\"model\":\"auto\",\"messages\":[{\"role\":\"user\",\"content\":\"Hello from Zenith\"}]}")
    req, _ := http.NewRequest("POST", "https://zenithgw.com/api/v1/chat/completions", bytes.NewReader(body))
    req.Header.Set("Authorization", "Bearer "+os.Getenv("ZENITH_CLOUD_KEY"))
    req.Header.Set("Content-Type", "application/json")

    res, err := http.DefaultClient.Do(req)
    if err != nil { panic(err) }
    defer res.Body.Close()
    data, _ := io.ReadAll(res.Body)
    fmt.Println(string(data))
}

<?php
$ch = curl_init("https://zenithgw.com/api/v1/chat/completions");
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer " . getenv("ZENITH_CLOUD_KEY"),
        "Content-Type: application/json",
    ],
    CURLOPT_POSTFIELDS => json_encode([
        "model" => "auto",
        "messages" => [["role" => "user", "content" => "Hello from Zenith"]],
    ]),
]);
echo curl_exec($ch);
curl_close($ch);

curl -sS "https://zenithgw.com/api/v1/chat/completions" \
  -H "Authorization: Bearer $ZENITH_CLOUD_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "auto",
    "messages": [{"role": "user", "content": "Hello from Zenith"}]
  }'

Streaming

stream.py

stream = client.chat.completions.create(
    model="auto",
    messages=[{"role": "user", "content": "Count to five."}],
    stream=True,
)
for event in stream:
    delta = event.choices[0].delta.content or ""
    print(delta, end="", flush=True)

Responses API

responses.py

resp = client.responses.create(
    model="auto",
    input="ping",
)
print(resp)

Tools

Cloud chat-completions accepts OpenAI-compatible tools, tool_choice, and response_format and forwards provider-specific shapes unchanged. Your Own Keys still uses the Zenith OpenAI-compatible path — storing an Anthropic or Gemini key does not enable those vendors’ native SDK protocols through Zenith.