39AI Developer Docs

39AI 接入文档

面向开发者的快速接入说明。39AI 提供 OpenAI 兼容 API，大多数支持自定义 OpenAI Base URL 的客户端和 SDK 都可以直接接入。

Base URL https://39ai.me/v1
鉴权方式 Authorization: Bearer YOUR_API_KEY
协议风格 OpenAI Compatible API

目录

5 分钟快速接入 接口地址与鉴权 请求示例 模型与兼容性说明 常见客户端接入思路 常见错误与排查 最佳实践 / 注意事项 适合谁接入 信息来源

一句话介绍

39AI 是一个面向中文开发者的多模型 API 网关，主打 稳定性、透明计费和 OpenAI 兼容接入。

5 分钟快速接入

你只需要准备 3 样东西：

  1. 39AI 后台创建的 API Key
  2. 一个可访问外网的服务端环境
  3. 支持 HTTP 请求或 OpenAI SDK 的开发环境
关键配置
  • Base URL：https://39ai.me/v1
  • 鉴权方式：Authorization: Bearer YOUR_API_KEY
  • 协议风格：OpenAI Compatible API

1 分钟连通性测试

curl -sS https://39ai.me/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

如果返回模型列表（data[]），说明接入成功。

接口地址与鉴权

基础地址

对大多数客户端来说，配置 Base URL = https://39ai.me/v1 即可，不需要手动填写完整的 /chat/completions 地址。

鉴权头

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

接入前准备建议

请求示例

curl 示例：基础调用

curl -sS https://39ai.me/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4",
    "messages": [
      {"role": "system", "content": "You are a helpful assistant."},
      {"role": "user", "content": "请给我3条API接入建议"}
    ],
    "temperature": 0.7,
    "max_tokens": 512
  }'

curl 示例：流式返回

curl -N https://39ai.me/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4",
    "stream": true,
    "messages": [
      {"role": "user", "content": "分步骤讲解如何上线AI助手"}
    ]
  }'

Python 示例（OpenAI SDK 兼容）

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://39ai.me/v1"
)

resp = client.chat.completions.create(
    model="gpt-5.4",
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "给我一句部署建议"}
    ],
    temperature=0.7,
)

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

JavaScript / Node.js 示例（OpenAI SDK 兼容）

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.OPENAI_API_KEY,
  baseURL: "https://39ai.me/v1",
});

const resp = await client.chat.completions.create({
  model: "gpt-5.4",
  messages: [
    { role: "system", content: "You are a helpful assistant." },
    { role: "user", content: "输出一句欢迎词" },
  ],
});

console.log(resp.choices?.[0]?.message?.content || "");

模型与兼容性说明

当前模型范围

切换模型的方法

大多数情况下，只需要修改请求里的 model 字段。

{
  "model": "gpt-5.4"
}

改成：

{
  "model": "claude-sonnet-4-6"
}

或：

{
  "model": "gemini-3-flash"
}

兼容性原则

推荐统一填写：

常见客户端接入思路

以下类型客户端通常都可以按 OpenAI 兼容方式接入：

通用规则
  • API Base URL 填：https://39ai.me/v1
  • API Key 填：你的 39AI Key
  • 模型名填：39AI 实际支持的模型名
注意

部分产品（如 Cursor / Windsurf / 某些闭源客户端）是否支持自定义 OpenAI 兼容地址，取决于当前版本与账号能力，建议以设置界面实际支持项为准。

常见错误与排查

1) 401 Unauthorized

常见原因

正确写法

Authorization: Bearer YOUR_API_KEY

排查步骤

  1. 到 39AI 后台重新复制 API Key
  2. 检查是否带了 Bearer 前缀
  3. 检查是否有空格、换行或截断
  4. 若是服务端环境变量，确认应用已重启

2) 429 Too Many Requests

含义

处理建议

推荐重试策略：仅对 429、5xx、网络超时重试；指数退避 1s -> 2s -> 4s；最大重试 2~3 次。

3) model not found

例如：

4) insufficient balance / quota exceeded

处理方法

  1. 购买兑换码
  2. 登录 39AI 后台
  3. 进入兑换/充值页面
  4. 输入兑换码兑换额度
  5. 重新发起请求

最佳实践 / 注意事项

参数建议（生产默认）

稳定性建议

安全建议

上线检查清单

适合谁接入

文档版本：v3
最后更新：2026-03-23