4SToken
API Reference

接口参考

按接口拆分查看请求地址、输入参数、输出参数与错误代码。

编程工具接入模型与价格
Gateway Protocols多标准协议兼容
OpenAIAnthropicGeminiOpenRouter
Chat / Responses / Messages / Claude Messages
POST /v1/images/generations

文生图

OpenAI 标准文生图；本页仅展示 OpenAI Images 标准/兼容请求字段。

上一页下一页

接口信息

请求地址https://api.4stoken.cn
请求路径/v1/images/generations
请求方式POST
协议标准OpenAI Images
能力分类图像生成
Content-Typeapplication/json
鉴权Authorization: Bearer sk-...

输入参数

参数类型必填说明
modelstring是图片模型编码。
promptstring是图片生成提示词。
ninteger否生成数量。
sizestring否宽高比或尺寸，例如 1:1。
qualitystring否OpenAI Images 质量参数，例如 standard / hd；是否生效取决于模型。官转渠道请不要自定义 quality，否则会走企业分组，按 token 计价。
backgroundstring否输出背景模式，例如 opaque / transparent；是否生效取决于模型。
output_formatstring否输出图片文件格式，例如 png / jpeg / webp；是否生效取决于模型。
stylestring否OpenAI Images 风格参数，例如 vivid / natural；是否生效取决于模型。
asyncboolean否网关扩展：异步提交任务；不属于 OpenAI Images 标准。
callbackUrlstring否网关扩展：任务完成回调地址；不属于 OpenAI Images 标准。

输出参数

参数类型返回说明
createdinteger同步时同步出图创建时间。
data[].urlstring成功时生成图片 URL；同步结果默认先上传 COS 后返回该字段。
data[].b64_jsonstring兼容保留base64 图片内容；仅兼容旧链路，不建议依赖。
backgroundstring否输出背景模式，例如 opaque / transparent。
output_formatstring否生成图片文件格式，例如 png / jpeg。
qualitystring否生成质量档位，例如 low / standard / hd；具体取值取决于模型线路。
sizestring否生成图片尺寸，例如 1024x1024。
usageobject否图片生成 token 用量统计。
usage.input_tokensinteger否输入 token 数。
usage.input_tokens_details.image_tokensinteger否输入图片 token 数。
usage.input_tokens_details.text_tokensinteger否输入文本 token 数。
usage.output_tokensinteger否输出 token 数。
usage.output_tokens_details.image_tokensinteger否输出图片 token 数。
usage.output_tokens_details.text_tokensinteger否输出文本 token 数。
usage.total_tokensinteger否总 token 数。
task_idstring是网关本地任务 ID；同步/异步均返回，可用于查询任务结果；不属于 OpenAI Images 标准。
taskIdstring是同 task_id，返回给下游使用的网关本地任务 ID；不属于 OpenAI Images 标准。
statusstring异步时任务状态，提交后通常为 pending。

补充说明

  • 返回格式由 Gateway 入口决定：调用 /v1/images/generations 时始终返回 Gateway 图片任务格式。
  • Gateway 扩展字段 image_size、aspect_ratio、media_resolution、async、callbackUrl 不属于 OpenAI Images 标准。
  • 灰度兼容：Portal 预览同时兼容旧版 { result: { data: [...] } } 包装和新版顶层 data[].url。

错误代码

HTTP 状态码错误说明
400Bad Request参数格式错误，例如文生图传入参考图字段。
401UnauthorizedClient Key 无效或未提供。
402Payment RequiredClient Key 配额或消费限额超限。

在线调试

model
your-model-code

仅展示该接口支持的已发布模型

暂无可用模型 →
更多配置网关扩展callbackUrl=异步任务
async
false（同步等待结果）
callbackUrl
关
prompt

生图或图片编辑提示词；图生图请用 edits 并上传 image 文件（见示例代码）

size

宽高比或像素尺寸，如 1:1；网关按 size 推断计费档位

1:1
n

生成张数

curl -X POST 'https://api.4stoken.cn/v1/images/generations' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  --data-raw '{"model":"your-model-code","prompt":"Hello","n":1,"size":"1:1"}'
在线调试会向 Gateway 发起真实请求并可能产生费用。请确认参数无误后再点击。