Skip to content

Python

平台兼容 OpenAI 接口,直接用官方 openai SDK,只改 base_url 即可。Claude / Gemini 也可以用各自官方 SDK 指向本平台。

OpenAI SDK

bash
pip install openai
python
from openai import OpenAI

client = OpenAI(
    api_key="sk-你的key",
    base_url="https://gateway.mindproxy.ai/v1",
)

resp = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)

流式

python
stream = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "写一首短诗"}],
    stream=True,
)
for chunk in stream:
    delta = chunk.choices[0].delta.content
    if delta:
        print(delta, end="", flush=True)

Embeddings

python
emb = client.embeddings.create(
    model="text-embedding-3-small",
    input="一段文本",
)
print(len(emb.data[0].embedding))

图像生成

python
img = client.images.generate(
    model="gpt-image-1",
    prompt="夜晚的城市",
    n=1,
    size="1024x1024",
)
print(img.data[0].url)

Claude(Anthropic SDK)

bash
pip install anthropic
python
from anthropic import Anthropic

client = Anthropic(
    api_key="sk-你的key",
    base_url="https://gateway.mindproxy.ai",  # SDK 会自动拼上 /v1/messages
)

msg = client.messages.create(
    model="claude-3-5-sonnet",
    max_tokens=1024,
    messages=[{"role": "user", "content": "你好"}],
)
print(msg.content[0].text)

附加请求头

需要试运行或幂等时,可加自定义头:

python
resp = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "你好"}],
    extra_headers={
        "Idempotency-Key": "my-unique-key-001",
        # "X-TT-Dry-Run": "true",  # 只预估、不发起生成、不扣费
    },
)

排障

  • 认证失败:确认 api_keybase_url(OpenAI SDK 的 base_url 必须带 /v1)。
  • 找不到路径 / 404:检查 base_url 结尾是否多 / 少了 /v1
  • 错误结构与状态码见 错误码与限流

线上网关:gateway.mindproxy.ai · 基于 VitePress 构建