Skip to main content

Quick Start

Get started with Z.AI in under 2 minutes:
from portkey_ai import Portkey

# 1. Install: pip install portkey-ai
# 2. Add @z-ai provider in model catalog
# 3. Use it:

portkey = Portkey(api_key="PORTKEY_API_KEY")

response = portkey.chat.completions.create(
    model="@z-ai/glm-4v",
    messages=[{"role": "user", "content": "Hello!"}]
)

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

Image Generation

Z.AI supports image generation through the CogView model family. Use the standard OpenAI-compatible images API:
from portkey_ai import Portkey

portkey = Portkey(api_key="PORTKEY_API_KEY")

response = portkey.images.generate(
    model="@z-ai/cogview-4-250304",
    prompt="A serene mountain landscape at sunset",
    size="1024x1024"
)

print(response.data[0].url)
Supported Parameters:
ParameterTypeDescription
promptstringThe text prompt for image generation (Required)
modelstringModel to use, e.g. cogview-4-250304 (Required)
sizestringImage dimensions
userstringEnd-user identifier

Add Provider in Model Catalog

Before making requests, add Z AI to your Model Catalog:
  1. Go to Model Catalog → Add Provider
  2. Select Z AI
  3. Enter your Z.AI API key
  4. Name your provider (e.g., Z AI)

Complete Setup Guide

See all setup options and detailed configuration instructions

Next Steps

For complete SDK documentation:

SDK Reference

Complete Portkey SDK documentation
Last modified on March 11, 2026