Moonshot

Use Moonshot’s AI models through Portkey for Chinese language processing.

Quick Start

Get started with Moonshot in under 2 minutes:

Python

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)

import Portkey from 'portkey-ai'

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

const portkey = new Portkey({
    apiKey: "PORTKEY_API_KEY"
})

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

console.log(response.choices[0].message.content)

from openai import OpenAI
from portkey_ai import PORTKEY_GATEWAY_URL

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

client = OpenAI(
    api_key="PORTKEY_API_KEY",  # Portkey API key
    base_url=PORTKEY_GATEWAY_URL
)

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

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

import OpenAI from "openai"
import { PORTKEY_GATEWAY_URL } from "portkey-ai"

// 1. Install: npm install openai portkey-ai
// 2. Add @moonshot provider in model catalog
// 3. Use it:

const client = new OpenAI({
    apiKey: "PORTKEY_API_KEY",  // Portkey API key
    baseURL: PORTKEY_GATEWAY_URL
})

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

console.log(response.choices[0].message.content)

# 1. Add @moonshot provider in model catalog
# 2. Use it:

curl https://api.portkey.ai/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "x-portkey-api-key: $PORTKEY_API_KEY" \
  -d '{
    "model": "@moonshot/moonshot-v1-8k",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

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)

ATTENTION

Moonshot AI offers two distinct API endpoints:

• Global API Base URL: https://api.moonshot.ai/v1
• China API Base URL: https://api.moonshot.cn/v1 (currently implemented by default)

You can override the endpoint by setting Advanced Options → Custom Host while adding the provider (as shown in the setup screen above).

Complete Setup Guide

See all setup options and detailed configuration instructions

---

Supported Models

Moonshot provides Chinese-focused AI models:

Model	Context Length	Description
moonshot-v1-8k	8,192 tokens	8K context window
moonshot-v1-32k	32,768 tokens	32K context window
moonshot-v1-128k	131,072 tokens	128K 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