Chat Completions API 完整指南

阿里云百炼支持 OpenAI 兼容 Chat Completions。Xikapi 示例统一使用：

https://xikapi.com/v1/chat/completions

基础调用

curl https://xikapi.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $XIKAPI_API_KEY" \
  -d '{
    "model": "qwen-plus-latest",
    "messages": [
      { "role": "system", "content": "You are a helpful assistant." },
      { "role": "user", "content": "Explain in three sentences what Qwen is best suited for" }
    ]
  }'

JavaScript

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.XIKAPI_API_KEY,
  baseURL: "https://xikapi.com/v1",
});

const completion = await client.chat.completions.create({
  model: "qwen-plus-latest",
  messages: [
    { role: "system", content: "You are a helpful assistant." },
    { role: "user", content: "Introduce the Alibaba Cloud Model Studio compatible calling method" },
  ],
});

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

Python

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_XIKAPI_API_KEY",
    base_url="https://xikapi.com/v1",
)

completion = client.chat.completions.create(
    model="qwen-plus-latest",
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "Introduce the Alibaba Cloud Model Studio compatible calling method"},
    ],
)

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

多轮对话

{
  "model": "qwen-plus-latest",
  "messages": [
    { "role": "user", "content": "My system needs knowledge-base Q&A" },
    { "role": "assistant", "content": "Start with document chunking and retrieval." },
    { "role": "user", "content": "What are good document chunking practices?" }
  ]
}

流式输出

{
  "model": "qwen-plus-latest",
  "stream": true,
  "messages": [
    { "role": "user", "content": "Write a short article about API integration" }
  ]
}

扩展参数

思考模式、联网搜索等供应商扩展能力通常通过 extra_body 传入。是否支持取决于模型和 Xikapi 后台兼容情况。

const completion = await client.chat.completions.create({
  model: "qwen-plus-latest",
  messages: [
    { role: "user", content: "Use recent AI news to predict major AI development trends" }
  ],
  extra_body: {
    enable_thinking: true,
    enable_search: true
  }
});

接入建议

• API Key 只放在服务端
• 显式设置输出长度和超时
• 供应商扩展参数要逐模型验证
• 流式输出要处理异常中断和重试