YM2API开发者文档
跳到正文
文档 / GPT 官方直连 · 按量

GPT 官方直连 · 按量(#184 / #185)

OpenAI 官方 Image 模型直连:请求原样交给官方接口出图,原生 1K–4K,不经过网页端逆向和超分。按 Token 计费,按官方返回的 usage 结算。接口为标准 OpenAI Images(生成和编辑),Base URL 与其他分组相同。

按 Token 计费原生 1K–4K生成 + 编辑倍率 2.5失败不扣费#185 支持流式与异步
Base URLhttps://yyds.seqnode.com/v1
鉴权Authorization: Bearer <API Key>
文生图POST/v1/images/generations · JSON
图片编辑POST/v1/images/edits · multipart
模型列表GET/v1/models · 免费,可用来验证 Key
关键注意事项
  • 价格随尺寸、quality 和参考图变化,没有固定的每张价格;下面的价格表是实测平均值,实际以响应里的 usage 和使用记录为准。
  • 建议显式传 quality。不传时由上游自动选择,同一尺寸的价格可能相差几倍。
  • 不写 response_format 时返回 Base64(data[].b64_json);写 "url" 返回本站图片链接,链接 1 小时后失效,请及时下载。
  • 4K 的 Base64 响应可达 15–26 MB,国内网络下载可能要几分钟甚至更久,建议用 "response_format": "url",再单独下载图片。
  • 流式和异步只在 #185 开放,#184 都不支持。流式("stream": true)的预览图是上游的加载动画,成品图与非流式相同;异步用 /v1/images/generations/async 或 /v1/images/edits/async 提交,按返回的 poll_url 轮询,结果是 24 小时内有效的图片链接。

1分组与模型

#185OpenAI 官方

gpt-image-2gpt-image-2.5-flaregpt-image-2.5-sunburst

三个模型都可用;quality 支持 low / medium / high / xhigh / max(xhigh、max 在 2.5 两个模型上实测)。sunburst 出图带 OpenAI 官方 C2PA 内容凭证。

#184Azure OpenAI 官方

gpt-image-2

只有 gpt-image-2;生成和编辑都可用,4K 实测可出。

两组请求写法完全相同,换 Key 即可切换。分组名称:#185「【GPT 官方直连 按量】OAI · Image 2 / Flare / Sunburst」,#184「【GPT 官方直连 按量】Azure · Image 2」。

2计费

两组都按 Token 计费,单价 = OpenAI 官方价 × 分组倍率(当前 2.5,以模型广场为准):

项目官方价 / 1M Token本站(× 2.5)/ 1M Token
文字输入(提示词)$5$12.50
图片输入(参考图)$8$20
图片输出$30$75
缓存读取$1.25$3.125

每张图实测平均扣费(2026-10-27/28,#185 的 gpt-image-2.5-flare / sunburst,16:9 文生图,倍率 2.5):

尺寸像素quality每张约
1K1280×720low$0.012
1K1280×720high$0.072
2K2048×1152low$0.014
2K2048×1152medium$0.030
2K2048×1152high$0.108
2K2048×1152xhigh$0.19
2K2048×1152max$0.43
4K3840×2160medium$0.065
4K3840×2160high$0.25
4K3840×2160xhigh$0.45
4K3840×2160max$1.00
  • gpt-image-2 1024×1024 low 约 $0.015 / 张;#184 的 3840×2160 low 实测 $0.028 / 张。
  • 编辑(带参考图)另加图片输入 Token:一张 512×512 参考图约 1024 Token(约 $0.02)。实测 2K high 编辑约 $0.137、4K high 编辑约 $0.28。
  • 请求失败(HTTP 4xx / 5xx)不扣费。

3快速开始

先在控制台创建分组 #185 或 #184 的 API Key。文字生图:

curl https://yyds.seqnode.com/v1/images/generations \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.5-sunburst",
    "prompt": "A quiet lakeside town at dawn, soft mist",
    "size": "2048x1152",
    "quality": "high",
    "n": 1,
    "response_format": "url"
  }'

参考图编辑(multipart,参考图字段 image):

curl https://yyds.seqnode.com/v1/images/edits \
  -H "Authorization: Bearer $API_KEY" \
  -F model=gpt-image-2.5-flare \
  -F "prompt=Turn this photo into a watercolor painting" \
  -F size=2048x1152 \
  -F quality=high \
  -F response_format=url \
  -F "image=@input.png"

Python(同时兼容链接和 Base64 两种返回):

import base64, requests

API_KEY = "sk-..."  # 分组 #185 或 #184 的 Key / a key of group #185 or #184
r = requests.post(
    "https://yyds.seqnode.com/v1/images/generations",
    headers={"Authorization": f"Bearer {API_KEY}"},
    json={"model": "gpt-image-2", "prompt": "a red fox in snow",
          "size": "1024x1024", "quality": "low", "response_format": "url"},
    timeout=600,
)
r.raise_for_status()
d = r.json()
item = d["data"][0]
if item.get("url"):
    open("out.png", "wb").write(requests.get(item["url"], timeout=300).content)
else:
    open("out.png", "wb").write(base64.b64decode(item["b64_json"]))
print(d.get("usage"))

4在线测试会真实扣费

在浏览器里直接调用本站接口。Key 只发给本站,不经过第三方;勾选「记住」才会保存在本浏览器。

「发送请求」会真实出图并扣费。默认参数(gpt-image-2 · 1024×1024 · low)约 $0.015 一张;「验证 Key」只调用 /v1/models,不扣费。
API Key
接口
尺寸

对应的 curl(随表单更新,可复制):

5请求参数

参数类型必填说明
modelstring必填#185:gpt-image-2、gpt-image-2.5-flare、gpt-image-2.5-sunburst;#184:gpt-image-2。
promptstring必填中英文都可以。
sizestring可选宽x高,例如 1024x1024、1280x720、2048x1152、3840x2160(以上均实测)。按 OpenAI 官方规则:边长为 16 的倍数,最长边不超过 3840,长宽比不超过 3:1。
qualitystring可选low medium high;#185 的 2.5 模型另有 xhigh max。越高越慢、越贵。建议显式填写。
ninteger可选建议 1。
response_formatstring可选b64_json(默认)或 url。
imagefile可选编辑接口必填,multipart 文件字段,PNG / JPEG / WebP。参考图按图片输入 Token 计费。

6返回格式

生成和编辑返回结构相同:

{
  "created": 1793151600,
  "data": [{ "url": "https://img.yydsbest.com/adb085ce-….png" }],
  "usage": {
    "input_tokens": 16,
    "input_tokens_details": { "text_tokens": 16, "image_tokens": 0 },
    "output_tokens": 371,
    "output_tokens_details": { "image_tokens": 371, "text_tokens": 0 },
    "total_tokens": 387
  }
}
字段类型说明
createdintegerUnix 时间戳(秒)。
data[].urlstringresponse_format=url 时返回,本站图片链接,无需 Key 即可下载,1 小时后 404。
data[].b64_jsonstring默认返回,Base64 编码的 PNG。
usage.input_tokensinteger输入 Token;input_tokens_details.image_tokens 是参考图部分。
usage.output_tokensinteger输出 Token(基本都是图片 Token),按 $75 / 1M 计费。
usage.total_tokensinteger合计。

7错误码

失败的请求不扣费。错误体为 {"error": {"type", "message", "request_id"}}(Key 校验失败时是 {"code", "message"}),反馈问题时请附上 request_id。

HTTP错误码 / 示例信息原因处理
400Invalid size '1000x1000'. Width and height must both be divisible by 16.参数不合法:尺寸、quality,或编辑接口缺少 image按参数表修改,不要原样重试
401INVALID_API_KEY / API_KEY_REQUIRED没带 Key 或 Key 错误检查 Authorization 请求头
403INSUFFICIENT_BALANCE账户余额不足充值后重试
404Model "…" is not available for this group模型不在这个 Key 的分组(例如 #184 的 Key 调 2.5 模型)换模型或换 Key
429API_KEY_QUOTA_EXHAUSTED 等Key 额度用完,或请求过快在控制台调高 Key 额度,或降低并发
502 / 503Upstream service temporarily unavailable上游临时故障稍后重试

8耗时与网络

  • 实测出图耗时:1K 约 20–35 秒,2K 约 20–50 秒,4K 约 40–70 秒;max 最长约 100 秒。客户端超时建议不少于 300 秒。
  • 4K 的 Base64 响应很大(15–26 MB),出图完成后还要下载。国内网络高峰期从本站下载可能只有每秒几十 KB,一张 4K Base64 曾用时 20 分钟以上。用 url 格式时接口几乎立即返回,图片再单独下载,PNG 也比 Base64 小约四分之一。
  • 大批量并发时,建议控制同时进行的请求数,避免下载互相抢带宽。