Flux(Chat(生成图片))

OpenAPI Specification

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

鉴权：请求头 Authorization 传令牌，取值形如 Bearer {{YOUR_API_KEY}}（该字段非必填）。

请求头

Content-Type：必填，固定 application/json。
Accept：必填，固定 application/json。

请求体参数（application/json）

必传字段为 model 与 messages。

model：string，必传；要使用的模型 ID，到「模型广场」里挑选并复制对应标识。
messages：array，必传；元素为对象，含 role（string）与 content（string）两项，按对话形式给出输入内容。
temperature：integer，可选；采样温度，介于 0 与 2 之间。取值偏高（例如 0.8）会让输出更发散，偏低（例如 0.2）会更聚焦、更稳定；建议只调它或 top_p 中的一项。
top_p：integer，可选；核采样。模型只从累积概率质量达到 top_p 的标记里取样，取 0.1 即只考虑前 10% 概率质量的标记；建议只调它或 temperature 中的一项。
n：integer，可选；每条输入消息生成多少个候选结果。
stream：boolean，可选；开启后按增量方式分批返回，令牌就绪即推送，最终以 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，实际传一个 JSON 对象，把标记 ID 映射到 -100 至 100 的偏置；偏置在采样前叠加到 logits 上，-1 至 1 会小幅增减被选中的可能，-100 或 100 近似禁止或强制选择该标记。
user：string，可选；终端用户的唯一标识，便于按用户维度做使用情况追踪。

响应

200：成功，返回对象，下列字段均为必返。
id：string；本次完成的唯一编号。
object：string；对象类型标识。
created：integer；生成时间戳。
choices：array；元素含 index（integer）、message（对象，含 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}} 请替换为控制台创建的令牌。补充：本接口对所有对话模型通用，切换模型只需替换 model 字段的取值，且所选模型本身要具备生图能力。