Skip to main content

Quick Start

Get started with Moonshot in under 2 minutes:
from portkey_ai import Portkey

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

portkey = Portkey(api_key="PORTKEY_API_KEY")

response = portkey.chat.completions.create(
    model="@moonshot/moonshot-v1-8k",
    messages=[{"role": "user", "content": "Hello!"}]
)

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

Add Provider in Model Catalog

Before making requests, add Moonshot to your Model Catalog:
  1. Go to Model Catalog โ†’ Add Provider
  2. Select Moonshot
  3. Enter your Moonshot API key
  4. Name your provider (e.g., moonshot)

Complete Setup Guide

See all setup options and detailed configuration instructions

Supported Models

Moonshot provides Chinese-focused AI models:
ModelContext LengthDescription
moonshot-v1-8k8,192 tokens8K context window
moonshot-v1-32k32,768 tokens32K context window
moonshot-v1-128k131,072 tokens128K context window
Check Moonshotโ€™s documentation for more details.

Next Steps

Gateway Configs

Add fallbacks, load balancing, and more

Observability

Monitor and trace your Moonshot requests

Prompt Library

Manage and version your prompts

Metadata

Add custom metadata to requests
For complete SDK documentation:

SDK Reference

Complete Portkey SDK documentation
Last modified on February 9, 2026