API 文档 - 086云 API 中转站

📡 接口概览

086云 API 完全遵循 OpenAI API 规范，所有请求和响应格式与官方一致。您只需将 API Base URL 和 API Key 替换为我们的，即可在任何 OpenAI 兼容客户端中使用，无需修改任何代码逻辑。

✅

完全兼容：支持 ChatGPT、Claude Code、Cherry Studio、OpenClaw、WorkBuddy、Cursor、Windsurf 等所有使用 OpenAI 格式的 AI 客户端。

🤖 对话模型 (Chat)

GPT-4o、GPT-4o-mini、Claude-3.5-Sonnet、Claude-3-Haiku、Gemini-1.5-Pro、DeepSeek-V3 等

⚡ 技能包模型 (Skills)

45+ 专业领域智能体：科学研究、医疗健康、能源环境、教育科研等

🎨 图像生成 (Image)

DALL-E 3、Stable Diffusion 等图像生成能力（通过统一接口调用）

📝 嵌入向量 (Embedding)

文本向量化支持，用于 RAG 检索增强生成场景

🔑 身份认证

所有 API 请求需要在 HTTP Header 中携带您的 API Key 进行身份验证：

# Bearer Token 认证方式
Authorization: Bearer sk-xxxxxxxxxxxxxxxx

参数	类型	必填	说明
`Authorization`	string	必填	Bearer Token 格式，值为您的 API Key（以 `sk-` 开头）

⚠️

安全提示：请妥善保管您的 API Key，不要将其暴露在前端代码或公开仓库中。如怀疑泄露，请在控制台立即重新生成。

获取 API Key：注册账户后登录控制台 → 令牌管理即可创建和管理您的 API Key。

🌐 基础地址

Base URL https://ai.086yun.com/v1

所有 API 请求的基础地址均为 https://ai.086yun.com/v1，在其后追加具体接口路径即可。

💬 对话补全 (Chat Completions)

最核心的接口，用于发送消息给 AI 模型获取响应。

请求

POST /v1/chat/completions

请求参数

参数	类型	必填	说明
`model`	string	必填	模型名称，如 `gpt-4o` 或技能包 ID
`messages`	array	必填	对话消息数组，每条包含 `role`(system/user/assistant) 和 `content`
`temperature`	number	可选	采样温度 0~2，默认 1
`max_tokens`	integer	可选	最大输出 token 数
`stream`	boolean	可选	是否流式输出，默认 false
`top_p`	number	可选	核采样参数 0~1

示例请求

# cURL 示例
curl https://ai.086yun.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-api-key" \
  -d '{
    "model": "gpt-4o",
    "messages": [
      {"role": "user", "content": "你好！"}
    ],
    "temperature": 0.7,
    "max_tokens": 1024
  }'

示例响应

{
  "id": "chatcmpl-xxxx",
  "object": "chat.completion",
  "choices": [{
    "message": {
      "role": "assistant",
      "content": "您好！我是 AI 助手，有什么可以帮您？"
    },
    "finish_reason": "stop"
  }],
  "usage": {
    "prompt_tokens": 12,
    "completion_tokens": 18,
    "total_tokens": 30
  }
}

📋 模型列表

获取当前可用模型列表：

GET /v1/models

# 获取可用模型列表
curl https://ai.086yun.com/v1/models \
  -H "Authorization: Bearer sk-your-api-key"

模型名称	类型	说明
`gpt-4o`	对话模型	OpenAI 最新旗舰多模态模型
`gpt-4o-mini`	对话模型	轻量高效，适合高频场景
`claude-3-5-sonnet-20241022`	对话模型	Anthropic Claude 3.5 Sonnet
`deepseek-chat`	对话模型	DeepSeek V3 国产高性能模型
`skill-*`	技能包	45+ 专业领域智能体（详见技能市场）

📊 用量查询

通过 New-API 控制台可实时查看 Token 使用情况：

用量仪表盘：登录控制台查看详细的调用次数和 Token 消耗统计
日志查询：查看每次 API 调用的完整记录，包括输入输出内容
余额管理：实时显示剩余 Token 额度和使用进度

📦 SDK 与工具

由于我们的 API 兼容 OpenAI 标准，你可以直接使用任何 OpenAI SDK，只需修改 base_url 和 api_key：

🐍

Python (openai)

pip install openai

查看示例

📦

Node.js (openai)

npm install openai

查看示例

☕

Java (openai-java)

Maven / Gradle

查看示例

🌐

HTTP / cURL

任意语言直接发 HTTP 请求

查看示例

💻 示例代码

Python

from openai import OpenAI

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

response = client.chat.completions.create(
    model="gpt-4o",
    messages=[
        {"role": "user", "content": "介绍一下海南自贸港"}
    ]
)

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

Node.js / TypeScript

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: 'sk-your-api-key',
  baseURL: 'https://ai.086yun.com/v1'
});

const response = await client.chat.completions.create({
  model: 'gpt-4o',
  messages: [
    { role: 'user', content: 'Hello!' }
  ]
});

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

cURL (任意语言)

curl -X POST https://ai.086yun.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-api-key" \
  -d '{"model":"gpt-4o","messages":[{"role":"user","content":"你好"}]}'

💡

在线测试：想快速体验？访问 API 在线调试沙箱无需编写代码即可直接测试接口。

API 文档 📚

📡 接口概览

🤖 对话模型 (Chat)

⚡ 技能包模型 (Skills)

🎨 图像生成 (Image)

📝 嵌入向量 (Embedding)

🔑 身份认证

🌐 基础地址

💬 对话补全 (Chat Completions)

请求

请求参数

示例请求

示例响应

📋 模型列表

热门模型

📊 用量查询

📦 SDK 与工具

Python (openai)

Node.js (openai)

Java (openai-java)

HTTP / cURL

💻 示例代码

Python

Node.js / TypeScript

cURL (任意语言)