API参考 - Oriental AI

认证

所有 API 请求需要在 HTTP Header 中提供 Bearer Token：

HEADERAuthorization: Bearer sk-...

登录控制台后，可在「令牌」页面复制你的 API Key。若 Token 不正确，将返回 401 Unauthorized。

模型列表

GET/v1/models

获取当前账号可用的所有模型及其元数据。

Request

curl https://orientalminds.com/v1/models \
  -H "Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

Response

{
  "object": "list",
  "data": [
    {
      "id": "deepseek-chat",
      "object": "model",
      "created": 1700000000,
      "owned_by": "deepseek"
    },
    {
      "id": "qwen-max",
      "object": "model",
      "created": 1700000000,
      "owned_by": "alibaba"
    }
  ]
}

对话补全

POST/v1/chat/completions

最常用的对话接口，兼容 OpenAI Chat Completions API。

请求参数

参数	类型	必填	说明
`model`	string	是	模型 ID，如 deepseek-chat、qwen-max
`messages`	array	是	消息数组，包含 role 和 content
`temperature`	float	否	采样温度，默认 1.0，范围 0~2
`max_tokens`	integer	否	最大生成 token 数
`stream`	boolean	否	是否流式返回，默认 false
`top_p`	float	否	核采样参数
`frequency_penalty`	float	否	频率惩罚
`presence_penalty`	float	否	存在惩罚

请求示例

cURL

curl https://orientalminds.com/v1/chat/completions \
  -H "Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-chat",
    "messages": [
      {"role": "system", "content": "You are a helpful assistant."},
      {"role": "user", "content": "Hello!"}
    ],
    "temperature": 0.7,
    "max_tokens": 512
  }'

响应示例

JSON

{
  "id": "chatcmpl-xxx",
  "object": "chat.completion",
  "created": 1710000000,
  "model": "deepseek-chat",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Hello! How can I assist you today?"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 23,
    "completion_tokens": 9,
    "total_tokens": 32
  }
}

向量嵌入

POST/v1/embeddings

获取文本的向量表示。具体支持的 embedding 模型请调用 /v1/models 查看。

cURL

curl https://orientalminds.com/v1/embeddings \
  -H "Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "text-embedding-3-small",
    "input": "Hello world"
  }'

错误码

HTTP状态码	错误类型	说明
`400`	Bad Request	请求参数错误，如 messages 格式不正确
`401`	Unauthorized	API Key 无效或已过期
`403`	Forbidden	该账号没有权限访问此模型
`429`	Rate Limited	请求频率过高或账户余额不足
`500`	Internal Server Error	上游模型服务异常，请稍后重试
`502/503`	Bad Gateway	模型渠道暂时不可用

注意： 当余额不足时，通常会返回 429 或 402 状态码。请及时充值或检查控制台余额。

限流说明

默认限流

普通账号默认限流为：每分钟 60 次请求，每天 100,000 次 Token。具体以控制台显示为准。

提升额度

如需更高并发或更多 Token，请联系客服申请企业账号，可获得独立通道和 SLA 保障。