请求
V1 的公开模型流量只进入下面的 POST 接口。请求体必须是 JSON object，messages 必须是非空数组。
请求http
POST https://cloudnode.skin/v1/chat/completions
Authorization: Bearer $MOFANG_API_KEY
Content-Type: application/json
Idempotency-Key: <1-200 characters>请求体json
{
"max_completion_tokens": 256,
"messages": [
{
"content": "请用一句话解释幂等性。",
"role": "user"
}
],
"model": "YOUR_MODEL_ALIAS"
}参数
不认识的字段会返回 invalid_request。n 在 V1 只能为 1，max_tokens 与 max_completion_tokens 不能同时出现。
| 字段 | 类型 | 要求 |
|---|---|---|
| model | string | 必填，活动 alias 或公开 canonical name |
| messages | array | 必填，至少一条消息 |
| stream | boolean | 可选，true 返回 SSE |
| max_completion_tokens | positive integer | 可选，不得超过模型上限 |
| temperature, top_p, tools | OpenAI compatible | 可选，按模型能力转发 |
响应与幂等
成功响应包含公开模型名与 usage。响应头 x-request-id 是持久请求标识。
响应体json
{
"choices": [
{
"finish_reason": "stop",
"index": 0,
"message": {
"content": "...",
"role": "assistant"
}
}
],
"id": "chatcmpl-<request-id>",
"model": "YOUR_MODEL_ALIAS",
"object": "chat.completion",
"usage": {
"completion_tokens": 18,
"prompt_tokens": 12,
"total_tokens": 30
}
}