Install

pip install openai

Configure the client

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["UOUODUO_API_KEY"],
    base_url="https://uouo.cloud/v1",
)

Chat

response = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[
        {"role": "system", "content": "You are a concise production assistant."},
        {"role": "user", "content": "Write a short release note."},
    ],
)

print(response.choices[0].message.content)

Streaming

stream = client.chat.completions.create(
    model="gpt-4o-mini",
    stream=True,
    messages=[{"role": "user", "content": "Explain SSE step by step."}],
)

for chunk in stream:
    print(chunk.choices[0].delta.content or "", end="")

Embeddings

result = client.embeddings.create(
    model="text-embedding-3-small",
    input=["Gateway documentation", "Vector search sample"],
)

Error handling

from openai import AuthenticationError, RateLimitError, APIError

try:
    client.models.list()
except AuthenticationError:
    print("Invalid API key. Create a new key in /app/keys.")
except RateLimitError:
    print("Rate limit, quota, or balance issue. Check /app/usage.")
except APIError as exc:
    print(f"Gateway or upstream error: {exc}")