Chat Completions 接口

接口说明

• 方法：POST
• 路径：/v1/chat/completions
• 完整地址：https://anideaai.com/v1/chat/completions
• 用途：基于多轮消息生成回复，支持流式输出、工具调用、结构化输出、多模态输入。

请求头

请求头	必填	说明
Authorization	是	Bearer sk-xxxxx
Content-Type	是	application/json

主要请求参数

参数	类型	必填	说明
model	string	是	模型名称，例如 gpt-5.4
messages	array	是	对话消息数组，最少一条
temperature	number	否	随机性，范围 0~2
top_p	number	否	核采样，范围 0~1
max_tokens	integer	否	最大输出长度
stream	boolean	否	是否流式返回（SSE）
tools	array	否	工具定义（函数描述）
tool_choice	string/object	否	auto、none、required 或指定工具
response_format	object	否	text、json_object、json_schema
reasoning_effort	string	否	推理强度：low/medium/high
modalities	array	否	输出模态，如 text、audio
audio	object	否	音频输出参数（voice、format）

messages 支持文本和多模态内容。常见角色：system、user、assistant、tool、developer。

cURL 示例（非流式）

curl https://anideaai.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxx" \
  -d '{
    "model": "gpt-5.4",
    "messages": [
      {"role": "system", "content": "你是一个简洁的助手"},
      {"role": "user", "content": "用两句话介绍新加坡"}
    ],
    "temperature": 0.7
  }'

Python 示例

from openai import OpenAI

client = OpenAI(api_key="sk-xxxxx", base_url="https://anideaai.com/v1")

resp = client.chat.completions.create(
    model="gpt-5.4",
    messages=[
        {"role": "system", "content": "你是一个简洁的助手"},
        {"role": "user", "content": "给我 3 个低成本营销点子"}
    ],
)

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

Node.js 示例

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "sk-xxxxx",
  baseURL: "https://anideaai.com/v1"
});

const resp = await client.chat.completions.create({
  model: "gpt-5.4",
  messages: [{ role: "user", content: "写一个发布会标题" }],
});

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

响应示例

{
  "id": "chatcmpl_abc123",
  "object": "chat.completion",
  "created": 1741320000,
  "model": "gpt-5.4",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "新加坡是东南亚金融与航运中心，同时也是多语言和多文化融合的现代城市。"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 24,
    "completion_tokens": 35,
    "total_tokens": 59
  }
}

流式输出（SSE）

当 stream=true 时，服务会返回 text/event-stream，客户端应持续读取每个增量片段。

cURL 示例（流式）

curl -N https://anideaai.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxx" \
  -d '{
    "model": "gpt-5.4",
    "messages": [{"role":"user","content":"写一段欢迎词"}],
    "stream": true
  }'

典型 SSE 片段

data: {"id":"chatcmpl_x","object":"chat.completion.chunk","choices":[{"delta":{"content":"欢迎"},"index":0}]}

data: {"id":"chatcmpl_x","object":"chat.completion.chunk","choices":[{"delta":{"content":"来到 AnideaAI"},"index":0}]}

data: [DONE]

补充：文本补全接口（兼容）

AnideaAI 同时支持 POST /v1/completions（传统单轮补全）。

最小请求示例：

curl https://anideaai.com/v1/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxx" \
  -d '{
    "model": "qwen2.5-72b-instruct",
    "prompt": "给电商活动写一句广告语",
    "max_tokens": 60
  }'