小马AI 使用文档

主题

GPT-Image-2 ​

GPT-Image-2 是小马AI当前已上架的图片模型。本页给出 OpenAI 兼容 Images API 的正向调用方式，实际模型 ID、可用分组和价格请以小马AI模型广场为准。

GPT-Image-2 模型详情

图形化工作台

不想写 curl 的用户，可以直接使用小马AI私有化的 GPT Image Playground 网页工作台。它适合调试提示词、上传参考图、保留历史结果和继续迭代图片。

前置准备 ​

  1. 已创建小马AI API 令牌
  2. 已确认令牌分组支持 gpt-image-2
  3. 已准备好 OpenAI 兼容客户端，或可直接使用 curl 调用

截至 2026-06-08 实测，gpt-image-2 支持 OpenAI-plan 和 default 分组；模型详情页显示 OpenAI-plan 价格为 ¥10 / 请求，default 价格为 ¥100 / 请求。

调用方式 ​

文生图：/v1/images/generations ​

bash
curl https://code-plan.pony.codes/v1/images/generations \
  -H "Authorization: Bearer sk-your-token-here" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "一张简洁的中文 SaaS 官网插图，主题是 AI API 网关，明亮科技风",
    "size": "1024x1024"
  }'

返回结果中通常会包含图片地址或 base64 图片内容，具体字段以模型返回为准。

图片编辑 / 图生图：/v1/images/edits ​

bash
curl https://code-plan.pony.codes/v1/images/edits \
  -H "Authorization: Bearer sk-your-token-here" \
  -F "model=gpt-image-2" \
  -F "prompt=把图片改成更适合科技官网的蓝白色视觉风格" \
  -F "image=@input.png"

流式返回 ​

文生图和图片编辑都可以传入 stream=true。流式模式使用 SSE 持续返回生成事件，适合需要实时展示进度或尽早处理结果的客户端。

文生图示例：

bash
curl -N https://code-plan.pony.codes/v1/images/generations \
  -H "Authorization: Bearer sk-your-token-here" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "一匹奔跑在云层上的白马，电影感光影",
    "size": "1024x1024",
    "stream": true
  }'

图片编辑示例：

bash
curl -N https://code-plan.pony.codes/v1/images/edits \
  -H "Authorization: Bearer sk-your-token-here" \
  -F "model=gpt-image-2" \
  -F "prompt=把背景改成日落天空" \
  -F "image=@input.png" \
  -F "stream=true"

响应的 Content-Type 为 text/event-stream。客户端应逐条读取 event: / data: 内容，并在收到 [DONE] 后结束处理。普通客户端不支持 SSE 时，请继续使用前面的非流式示例。

参数建议 ​

  • 先用默认尺寸验证链路。
  • 提示词先短后长，确认能出图后再增加风格、构图、文字约束。
  • 如果客户端支持质量、背景、输出格式等参数，再按模型广场或接口返回能力逐步调整。

常见问题 ​

  • 404 或模型不存在：模型 ID 或令牌分组不匹配。
  • 401：API Key 填错，或误填了登录密码。
  • 客户端没有绘图入口：换用 Cherry Studio 或直接使用 curl 验证 Images API。

小马AI

Copyright © 2026 小马AI