图像生成

文生图与图像编辑,兼容 OpenAI Images API。可用模型包括 gpt-image-2、grok-imagine-image 等 —— 按张计费。

文生图

POST https://cn.chatapi.app/v1/images/generations
from openai import OpenAI

client = OpenAI(base_url="https://cn.chatapi.app/v1", api_key="sk-xxxxxxxx")

resp = client.images.generate(
    model="gpt-image-2",
    prompt="An orange cat running through a neon city, cyberpunk style",
    n=1,
    size="1024x1024",
)
print(resp.data[0].url)
curl https://cn.chatapi.app/v1/images/generations \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "An orange cat running through a neon city, cyberpunk style",
    "n": 1,
    "size": "1024x1024"
  }'

请求参数

参数类型说明
modelstring必填。图像模型名称
promptstring必填。图像描述
nint生成图片数量
sizestring尺寸,如 1024x1024

图像编辑

POST https://cn.chatapi.app/v1/images/edits

以 multipart/form-data 形式上传原图和提示词即可进行编辑:

curl https://cn.chatapi.app/v1/images/edits \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -F model="gpt-image-2" \
  -F image="@input.png" \
  -F prompt="Replace the background with a seaside sunset"

多媒体图像模型(未审查)

第三方未审查号池(支持 NSFW、严禁未成年内容),仍通过 POST /v1/images/generations(编辑类也可用 /v1/images/edits)调用,同步返回,一般 10–40 秒。「按厂家」路由选「多媒体」或「全部模型与厂家」的 Key 均可调用(这些模型只存在于多媒体分组,不会被替代成其他模型)。按张计费;默认返回 b64_json,传 response_format=url 时返回 CDN 地址(保留 7 天)。

模型 / 模式价格(美元/张)尺寸 / 参数
face-swap
生成
$0.033image 依次传目标图、人脸图
head-swap
生成
$0.026image 依次传目标图、头像图
qwen-image-2.1
生成
$0.026;2K $0.051resolution: 1K / 2K;aspect_ratio: 1:1 / 16:9 / 9:16 / 4:3 / 3:4 / 3:2 / 2:3
qwen-image-edit
生成
$0.102需源图 image
seedream-5.0-lite-image-edit
图片编辑
$0.077resolution: 2K / 3K / 4K;aspect_ratio: 1:1 / 4:3 / 3:4 / 16:9 / 9:16 / 3:2 / 2:3 / 21:9;需源图 image
seedream-5.0-lite-text-to-image
文生图
$0.077resolution: 2K / 3K / 4K;aspect_ratio: 1:1 / 4:3 / 3:4 / 16:9 / 9:16 / 3:2 / 2:3 / 21:9
seedream-5.0-pro-image-edit
图片编辑
$0.154aspect_ratio: 1:1 / 4:3 / 3:4 / 16:9 / 9:16 / 3:2 / 2:3 / 21:9;需源图 image
seedream-5.0-pro-text-to-image
文生图
$0.154aspect_ratio: 1:1 / 4:3 / 3:4 / 16:9 / 9:16 / 3:2 / 2:3 / 21:9
z-image
生成
$0.033size 宽x高(如 1024x1536)
z-image-pro
生成
$0.038size 宽x高(如 1024x1536)
curl https://cn.chatapi.app/v1/images/generations \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"model":"seedream-5.0-lite-text-to-image","prompt":"a lighthouse at dusk, oil painting","resolution":"2K","aspect_ratio":"16:9","response_format":"url"}'
参考图 / 源图

在 image(字符串或数组)传公网图片 URL 或 base64 data: URI,data URI 会自动上传。编辑类(*-image-edit、qwen-image-edit)第一张为源图;换脸 / 换头第一张为目标图、第二张为人脸 / 头像。控制台的多媒体工作台可直接在网页里生成。

超时设置(长耗时请求)

生图上游耗时常见 1–5 分钟,高分辨率或排队时可达 10 分钟以上。服务端不限制单次请求的总时长,请把客户端超时设为至少 900 秒,推荐 1800 秒,否则会在客户端侧提前断开(已提交的任务仍会正常完成并计费)。

# Python(openai SDK 默认 600 秒,长图会被截断)
client = OpenAI(base_url="https://cn.chatapi.app/v1", api_key="sk-...", timeout=1800)

# Node.js(单位毫秒)
const client = new OpenAI({ baseURL: "https://cn.chatapi.app/v1", apiKey: "sk-...", timeout: 1800000 })

# curl
curl --max-time 1800 ...
等待期间的保活空格

非流式请求等待超过约 45 秒时,服务器会先返回 HTTP 200,并每隔几秒在响应体开头发送一个空格保持连接,最终 JSON 紧跟在这些空格之后。标准 JSON 解析器(Python json、JS JSON.parse、各家 SDK)会自动忽略开头空白,无需处理;如果你按字节自行解析,请先去掉开头空白。

这种情况下如果最终失败,HTTP 状态码仍是 200,错误信息在响应体的 error 字段中。请以 error 字段判断成败,不要只看状态码。对话类长任务建议直接使用 stream: true。

响应结构

{
  "created": 1748600000,
  "data": [
    {"url": "https://.../generated.png"}
  ]
}
视频生成

grok-imagine-video 为视频模型,按秒计费。提交方式详见控制台。

全部文档