Chat(修改图片)

OpenAPI Specification

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

说明：全部对话模型都可走此接口，把 model 改成目标模型名即可；用于改图时，所选模型需具备生图能力。

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

请求头

• Content-Type：必填，固定 application/json。
• Accept：必填，固定 application/json。
• Authorization：可选，string，默认 Bearer {{YOUR_API_KEY}}。

请求体参数（application/json）

• model：必填，string，模型 ID，示例 gpt-4o-image，可从「模型广场」复制。
• messages：必填，数组，以对话格式提交的消息；消息 content 可写字符串，也可写内容块数组（type: text 配 text，type: image_url 配 image_url.url）。
• temperature：integer，采样温度，介于 0 与 2 之间；偏大（如 0.8）更随机，偏小（如 0.2）更集中。与 top_p 建议只调整其一。
• top_p：integer，核采样方式，只在累计概率达 top_p 的标记中取样；0.1 表示仅考虑占前 10% 概率质量的标记。与 temperature 建议只调整其一。
• n：integer，每条输入消息生成的补全条数。
• stream：boolean，开启后像聊天场景一样下发分段增量：标记可用时即以纯数据 SSE 发送，由 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，终端用户的唯一标识，用于辅助识别与检测滥用行为。

必填字段：model、messages。

请求示例

• model：gpt-4o-image
• stream：false
• messages：一条 user 消息，content 为内容块数组，先放文本块「修改这个图片」，再放 image_url 块（示例图片地址 https://example.com/logo.png）。

响应

• 200：成功，返回 JSON 对象：
  • id：string；object：string；created：integer。
  • choices：数组，元素含 index（integer）、message（对象，必含 role、content）、finish_reason（string）。
  • usage：对象，必含 prompt_tokens、completion_tokens、total_tokens（均 integer）。

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