OpenAI 兼容 API

开发者接入文档

使用 OpenAI 兼容方式接入 Coriander AI。将 Base URL 配置为正式服务地址，并使用控制台创建的 API Key 完成鉴权。

正式接入地址

Base URL

https://api.corianderaigc.cn/v1

Chat Completions

https://api.corianderaigc.cn/v1/chat/completions

鉴权方式

请求头使用 Bearer Token，API Key 请在控制台创建和管理。

Authorization: Bearer YOUR_API_KEY

快速开始

兼容 OpenAI 调用格式。
现有 OpenAI SDK 项目只需替换 Base URL 和 API Key，即可按已开通模型调用。

cURL

curl https://api.corianderaigc.cn/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "your-model-id",
    "messages": [
      {"role": "system", "content": "You are a helpful assistant."},
      {"role": "user", "content": "请用一句话介绍 Coriander AI。"}
    ],
    "stream": false
  }'

SDK 示例

Python

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.corianderaigc.cn/v1"
)

response = client.chat.completions.create(
    model="your-model-id",
    messages=[
        {"role": "user", "content": "你好，请介绍一下你的能力。"}
    ]
)

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

JavaScript / TypeScript

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.CORIANDER_API_KEY,
  baseURL: "https://api.corianderaigc.cn/v1",
});

const completion = await client.chat.completions.create({
  model: "your-model-id",
  messages: [{ role: "user", content: "你好，请介绍一下你的能力。" }],
});

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

接口目录

能力	路径	说明
Chat Completions	`/v1/chat/completions`	多轮对话、流式输出和工具调用。
Models	`/v1/models`	查询当前账号可使用的模型。
Embeddings	`/v1/embeddings`	文本向量化和语义检索。
Images	`/v1/images/*`	图像生成及相关能力，具体以已开通模型为准。

调用建议

先调用 /v1/models 确认可用模型 ID，再写入业务配置。
API Key 只保存在服务端环境变量中，不要暴露到网页或客户端应用。
生产请求请设置合理的超时和重试策略，避免因网络波动造成重复提交。

错误排查

401 Unauthorized：检查 API Key 是否有效，以及请求头是否为 Authorization: Bearer YOUR_API_KEY。
404 Not Found：检查 Base URL 是否完整配置为 https://api.corianderaigc.cn/v1。
429 Too Many Requests：当前请求超过模型或账户并发限制，请降低并发或稍后重试。
5xx Server Error：服务端暂时不可用时请进行指数退避重试；持续出现可联系技术支持。