Meta-Chunking（文件LLM切片）

[
    {
        "file_name": "新建 文本文档.txt",
        "chunks_len": 4,
        "chunks": [
            [
                "我先把您给出的 3 份文档抓下来，再对照“格式参考”与“内容参考”的结构，帮您把自有文档补充成一份“功能介绍-快速开始-参数说明-可选参数-返回示例-错误码-注意事项-常见问题”俱全的优化版本。 下面给出一份「优化后的 302.AI 图像生成接口文档」完整 Markdown，可直接覆盖原文件或粘贴到 Apifox / YApi 中使用。 我已把格式参考（音乐生成）中的「功能介绍 → 快速开始 → 参数分模式表格 → 可选参数 → 返回示例 → 错误码 → 注意事项 → 定价」全链路结构，与内容参考（OpenAI Image Guide）中的「模型对比 / 尺寸 / 质量 / 背景透明 / 流式 / 内容审核」等细节全部融合进来，并针对你原文中缺失或模糊的部分做了补充和汉化。"
            ],
            [
                "---\r\n\r\n# 图像生成（Image Generation）\r\n\r\n## 1. 功能介绍\r\n根据文本提示生成一张或多张高质量图像，支持：\r\n- GPT-Image 系列模型（gpt-image-1.5 / gpt-image-1 / gpt-image-1-mini）\r\n- 多尺寸、多质量、背景透明、流式输出等精细控制\r\n- 自带内容审核，可自定义审核严格度\r\n- 异步 / 同步双模式，适配不同业务场景\r\n\r\n## 2. 快速开始\r\n### 2.1 请求地址\r\nPOST `https://api.302.ai/v1/images/generations`\r\n\r\n### 2.2 最简调用\r\n```bash\r\ncurl -X POST \"https://api.302.ai/v1/images/generations\" \\\r\n  -H \"Authorization: Bearer YOUR_API_KEY\" \\\r\n  -H \"Content-Type: application/json\" \\\r\n  -d '{\r\n        \"prompt\": \"A cute baby sea otter floating on its back\",\r\n        \"model\": \"gpt-image-1.5\",\r\n        \"n\": 1,\r\n        \"size\": \"1024x1024\"\r\n      }'\r\n```\r\n\r\n## 3. 请求参数\r\n| 字段 | 类型 | 必填 | 说明 | 默认值 | 备注 |\r\n|---|---|---|---|---|---|\r\n| prompt | string | ✅ | 描述文本 | - | 长度 ≤ 32 k（gpt-image-1.5） |\r\n| model | string | ✅ | 模型 | gpt-image-1.5 | 可选：gpt-image-1 / gpt-image-1-mini |\r\n| n | int |  | 生成张数 | 1 | 1-10； dall-e-3 仅支持 1 |\r\n| size | string |  | 尺寸 | auto | 见「4. 尺寸与质量」表格 |\r\n| quality | string |  | 质量 | auto | low / medium / high / auto |\r\n| background | string |  | 背景 | auto | transparent / opaque / auto |\r\n| output_format | string |  | 输出格式 | png | png / jpeg / webp |\r\n| output_compression | int |  | 压缩率 | 100 | 0-100； 仅 jpeg/webp 生效 |\r\n| moderation | string |  | 审核严格度 | auto | low（宽松） / auto |\r\n| stream | bool |  | 流式输出 | false | 仅 GPT-Image 系列支持 |\r\n| partial_images | int |  | 流式分片数 | 0 | 0-3； 0=仅返回最终图 |\r\n| async | query |  | 是否异步 | false | 传 `?async=true` 时返回 task_id |\r\n\r\n## 4. 尺寸与质量\r\n| 模型 | 支持尺寸 | 推荐场景 | 对应质量 token 数（square） |\r\n|---|---|---|---|\r\n| gpt-image-1.5 | 1024×1024 / 1536×1024 / 1024×1536 / auto | 最高画质、文本渲染 | low 272 / medium 1056 / high 4160 |\r\n| gpt-image-1 | 同上 | 均衡成本与质量 | 同上 |\r\n| gpt-image-1-mini | 同上 | 低成本、快速验证 | 同上，价格仅 20 % |\r\n\r\n> 尺寸选择 `auto` 时，模型会根据提示词自动给出最佳比例。"
            ],
            [
                "## 5. 返回结构\r\n同步模式 200 示例：\r\n```json\r\n{\r\n  \"created\": 1700000000,\r\n  \"data\": [\r\n    {\r\n      \"url\": \"https://file.302.ai/xxx.png\",       // 当 async=false 且 output_format=png 时返回\r\n      \"b64_json\": \"iVBORw0KGgoAAAANSUhEUgA...\"      // stream=false 时始终返回 base64\r\n    }\r\n  ],\r\n  \"usage\": {\r\n    \"input_tokens\": 25,\r\n    \"input_tokens_details\": { \"text_tokens\": 25, \"image_tokens\": 0 },\r\n    \"output_tokens\": 4160,\r\n    \"output_tokens_details\": { \"text_tokens\": 0, \"image_tokens\": 4160 },\r\n    \"total_tokens\": 4185\r\n  }\r\n}\r\n```\r\n流式模式：分片事件 `image_generation.partial_image`，字段同 OpenAI 官方。 ## 6. 错误码\r\n| HTTP | 业务 code | 说明 | 解决建议 |\r\n|---|---|---|---|\r\n| 400 | 400 | 参数非法 | 检查 prompt 长度、n 范围、尺寸枚举 |\r\n| 401 | 401 | 鉴权失败 | 确认 Bearer 拼接正确，KEY 未过期 |\r\n| 429 | 429 | 频率超限 | 降低 QPS 或升级套餐 |\r\n| 500 | 500 | 服务端异常 | 重试； 持续出现请工单 |\r\n\r\n## 7. 注意事项\r\n1. 文件保留 14 天，过期自动清理，请及时转存。 2. 透明背景必须搭配 `output_format=png/webp`，否则自动 fallback 为不透明。 3. 高画质（high）单张图像可能 ≥ 4 k tokens，价格 ≈ 0.13 PTC（gpt-image-1.5）； 如做批量调用，建议先用 gpt-image-1-mini 调试。 4. 内容审核：默认 auto 模式会拦截色情、暴力、政治敏感等； 如业务场景需要更宽松，可显式指定 `\"moderation\": \"low\"`，但仍须遵守《302.AI 使用协议》。 5. 流式输出：仅返回 base64，不含 url； 分片顺序与 `partial_images` 值一致，最后一帧为终图。 6. 异步模式：提交后先获得 `task_id`，再轮询 `/v1/images/tasks/{task_id}` 获取结果，适合 > 5 秒的长尾请求。 ## 8. 常见问题\r\n**Q：为何返回 400 \"size not supported\"？ **  \r\nA：dall-e-3 仅支持 1024×1024 / 1792×1024 / 1024×1792，gpt-image 系列不支持 1792 宽度，请核对模型与尺寸组合。 **Q：想要 PSD 或矢量图？ **  \r\nA：API 仅输出位图（png/jpeg/webp），矢量需求请自行转换。 **Q：如何关闭自动 prompt 优化？ **  \r\nA：当前版本默认开启安全改写，不可关闭； 如需完全自定义，请在 prompt 里显式声明「Do not revise this prompt」。"
            ],
            [
                "## 9. 定价（实时计费，单位：PTC）\r\n| 模型 | 文本输入 | 图片输出（每 1 M tokens） |\r\n|---|---|---|\r\n| gpt-image-1.5 | 5 PTC | 32 PTC |\r\n| gpt-image-1 | 5 PTC | 40 PTC |\r\n| gpt-image-1-mini | 2 PTC | 8 PTC |\r\n\r\n> 实际费用 = `usage.total_tokens * 单价`； 1 张 1024×1024 high 图约 0.13 PTC（gpt-image-1.5）。 ---\r\n\r\n如需继续扩展「编辑图片 / 生成变体 / 遮罩inpainting」等接口，可沿用同样章节结构再开新文档。 祝接入顺利！"
            ]
        ]
    }
]