快速开始

接入文档

OpenAI 兼容接口，几分钟内即可接入国产大模型

01API 端点

OpenAI 兼容接口
https://api.piomode.com/v1
KEY
API Key 请在控制台「密钥管理」创建，创建时仅展示一次明文，请妥善保存

02环境变量配置

Windows

在终端中设置环境变量，供 OpenAI 兼容 SDK 自动读取

# PowerShell（仅当前会话有效）
$env:OPENAI_BASE_URL = "https://api.piomode.com/v1"
$env:OPENAI_API_KEY = "sk-your-api-key"

macOS / Linux

在终端中设置环境变量，供 OpenAI 兼容 SDK 自动读取

# bash / zsh（仅当前会话有效）
export OPENAI_BASE_URL="https://api.piomode.com/v1"
export OPENAI_API_KEY="sk-your-api-key"

03代码示例

import openai

client = openai.OpenAI(
    base_url="https://api.piomode.com/v1",
    api_key="sk-your-api-key",
)

response = client.chat.completions.create(
    model="deepseek-chat",
    messages=[{"role": "user", "content": "你好"}],
)
print(response.choices[0].message.content)

安装依赖：pip install openai · npm install openai

04流式响应

设置 stream: true 即可按 SSE 格式实时接收生成内容

import openai

client = openai.OpenAI(
    base_url="https://api.piomode.com/v1",
    api_key="sk-your-api-key",
)

stream = client.chat.completions.create(
    model="deepseek-chat",
    messages=[{"role": "user", "content": "用一句话介绍长江"}],
    stream=True,
)
for chunk in stream:
    delta = chunk.choices[0].delta.content or ""
    print(delta, end="", flush=True)

05函数调用

支持标准 OpenAI 格式的 tools / function calling

tools = [{
  "type": "function",
  "function": {
    "name": "get_weather",
    "description": "查询某城市天气",
    "parameters": {
      "type": "object",
      "properties": {"city": {"type": "string"}},
      "required": ["city"],
    },
  },
}]

resp = client.chat.completions.create(
    model="deepseek-chat",
    messages=[{"role": "user", "content": "上海今天天气怎么样？"}],
    tools=tools,
)
print(resp.choices[0].message.tool_calls)

06错误处理

错误响应统一遵循 OpenAI 标准错误格式

{
  "error": {
    "type": "invalid_request_error",
    "code": "insufficient_quota",
    "message": "余额不足"
  }
}

常见错误码

HTTP说明
401API Key 无效或缺失
402账户余额不足
429请求频率超出限制
503上游服务暂时不可用，请稍后重试
查看已接入模型