Chat(生成图片)

OpenAPI Specification

接口：POST /v1/chat/completions（完整地址 https://api.allyang.cn/v1/chat/completions）

鉴权：请求头 Authorization: Bearer {{YOUR_API_KEY}}。

请求头

• Content-Type：必填，string，示例 application/json。
• Accept：必填，string，示例 application/json。

请求体参数（application/json）

• model：必填，string，所选模型的 ID；须选用具备生图能力的模型。
• messages：必填，array，以聊天格式组织、用于生成补全的消息；每项为对象，含 role（string）与 content（string）。
• temperature：可选，integer，采样温度，取值 0 至 2；偏高输出更随机，偏低更集中确定；通常与 top_p 二者只调其一。
• top_p：可选，integer，核采样阈值，只保留累计概率达到该值的候选；例如 0.1 表示仅考虑概率质量前 10% 的标记；通常与 temperature 二者只调其一。
• n：可选，integer，为每条输入消息生成的候选条数。
• stream：可选，boolean，置 true 时按纯数据服务器发送事件分片回传增量标记，流以 data: [DONE] 结束。
• stop：可选，string，最多 4 个序列，命中即停止继续生成标记。
• max_tokens：可选，integer，生成的最大标记数；输入标记与生成标记合计受模型上下文长度限制。
• presence_penalty：可选，number，取值 -2.0 至 2.0；正值按标记此前是否出现施加惩罚，使模型更可能谈及新主题。
• frequency_penalty：可选，number，取值 -2.0 至 2.0；正值按标记现有频率施加惩罚，降低逐字重复同一行的可能。
• logit_bias：可选，null，接受把标记 ID 映射到 -100 至 100 偏置值的 JSON 对象；偏置在采样前叠加到 logit 上，具体效果随模型而异，-1 至 1 之间属增减选择概率，-100 或 100 相当于禁用或独占。
• user：可选，string，终端用户的唯一标识，便于平台侧识别与治理滥用行为。

响应

• 200：成功，返回 JSON 对象。
• id：string，本次请求的唯一标识。
• object：string，对象类型。
• created：integer，创建时间。
• choices：array，候选列表；每项含 index（integer）、message（object，含 role 与 content，均为 string）、finish_reason（string）。
• usage：object，用量统计，含 prompt_tokens、completion_tokens、total_tokens，均为 integer。

使用提示：本平台 Base URL 为 https://api.allyang.cn，OpenAI 兼容接口路径以 /v1 开头；示例里的 {{YOUR_API_KEY}} 请替换为控制台创建的令牌。