TokenToSea开发者文档
控制台

图像生成与编辑POST

文生图与图像编辑。生成结果保存到私有存储,返回 5 分钟内有效的下载链接,文件保留 30 天。

本页内容

POST https://api.tokentosea.com/v1/images/generations

POST https://api.tokentosea.com/v1/images/edits

两个接口使用同一套请求字段,/v1/images/edits 额外需要参考图。TokenToSea 把通用字段转换成各厂商的原生格式,生成的图片转存到 TokenToSea 的私有对象存储,响应中只返回 TokenToSea 的签名下载链接,不暴露厂商的临时地址。

前提:全能密钥或模型密钥,账户可用余额足以覆盖本次预留。Python 示例需要 pip install requests,Node.js 示例需要 Node.js 18+(内置 fetch)。

支持的型号#

截至 2026-10-21,文生图 29 个型号、图像编辑 19 个型号。以 GET /v1/models 的 verified_endpoints 为准。

开放 /v1/images/generations 的型号(29)
服务商型号返回方式
千问qwen-image-2.0、qwen-image-2.0-2026-03-03、qwen-image-2.0-pro、qwen-image-2.0-pro-2026-03-03、qwen-image-2.0-pro-2026-04-22、qwen-image-2.0-pro-2026-06-22、qwen-image-2.1-pro、qwen-image-2.1-turbo、qwen-image-3.0、qwen-image-3.0-pro、wan2.6-t2i、wan2.7-image、wan2.7-image-pro、z-image-turbo同步
千问wan2.2-t2i-flash、wan2.2-t2i-plus、wan2.5-t2i-preview、wanx-v1、wanx2.0-t2i-turbo、wanx2.1-t2i-plus、wanx2.1-t2i-turbo异步(202)
智谱cogview-3-flash、cogview-4、cogview-4-250304、glm-image同步
MiniMaximage-01、image-01-live同步
豆包doubao-seedream-5-0-flash-260915、doubao-seedream-5-0-pro-260628同步
开放 /v1/images/edits 的型号(19)
服务商型号返回方式
千问qwen-image-2.0、qwen-image-2.0-2026-03-03、qwen-image-2.0-pro、qwen-image-2.0-pro-2026-03-03、qwen-image-2.0-pro-2026-04-22、qwen-image-2.0-pro-2026-06-22、qwen-image-2.1-pro、qwen-image-2.1-turbo、qwen-image-3.0、qwen-image-3.0-pro、wan2.6-image、wan2.7-image、wan2.7-image-pro同步
千问wan2.5-i2i-preview、wanx2.1-imageedit异步(202)
MiniMaximage-01、image-01-live同步
豆包doubao-seedream-5-0-flash-260915、doubao-seedream-5-0-pro-260628同步

两个接口都只支持 JSON 响应,"stream": true 返回 422 response_mode_not_verified。

请求体#

参数类型必填说明
modelstring必填型号 ID
promptstring必填图像描述
ninteger可选生成数量,默认 1。按张计费的型号按 n 预留费用;平台验收示例均为 1
sizestring可选尺寸。千问、智谱写作 宽x高(如 1024x1024;千问会自动转成厂商的 1024*1024);glm-image 示例使用 1280x1280;豆包 Seedream 使用 2K 等档位
seedinteger可选随机种子(千问)
negative_promptstring可选反向提示词(千问)
prompt_extendboolean可选是否让厂商自动扩写提示词(千问)。z-image-turbo 的价格与此开关有关
watermarkboolean可选是否添加厂商水印(千问、豆包)
aspect_ratiostring可选仅 MiniMax,默认 1:1
imagestring | string[]edits 必填参考图 URL。MiniMax 把它作为人物主体参考(subject_reference);千问 wanx2.1-imageedit 作为待编辑底图
maskstring可选仅 wanx2.1-imageedit:蒙版图 URL
parametersobject可选千问:其他厂商原生参数,合并进上游的 parameters
provider_optionsobject可选厂商原生扩展。千问可写 provider_options.parameters(合并进参数)、provider_options.function(wanx2.1-imageedit 的编辑功能,默认 description_edit);MiniMax 与豆包的其他原生字段直接写在请求体中

图片 URL 必须能被厂商公网访问。厂商的原生字段没有在上表列出的,可查阅厂商文档后直接加入请求体:智谱、豆包请求体原样转发(仅 model 固定、豆包强制 response_format: "url");MiniMax 强制 response_format: "url"。

响应#

同步型号返回 200:

响应示例
{
  "id": "…",
  "model": "qwen-image-2.1-pro",
  "data": [
    {
      "url": "https://tokentosea-media-cn-….cos.ap-nanjing.myqcloud.com/…?sign=…",
      "asset_id": "asset_8c1f…(64 位十六进制)",
      "mime_type": "image/png"
    }
  ],
  "usage": { "…": "厂商返回的用量" }
}
字段说明
data[].url私有存储的签名下载链接,最多 300 秒内有效。请立即下载或转存
data[].asset_id资产 ID。链接过期后用 GET /v1/assets/{asset_id}/download-url 重新获取;文件保留 30 天
data[].mime_type文件类型
usage / extra_info厂商返回的用量信息(如有)

厂商为每张图片返回的其他字段(例如豆包的 size)会保留在 data[] 中;b64_json 不会返回,图片一律以链接形式提供。

异步型号返回 202 和结果信封(status: "upstream_pending")。平台每 5 秒查询一次厂商任务,完成后把图片转存并结算;用 GET /v1/results/{key} 或 GET /v1/tasks/{id} 轮询,完成后 output 与上面的同步响应相同。转存尚未完成时同步型号也可能返回 202,处理方式相同。

示例#

文生图#

REQUEST_KEY="$(uuidgen)"
curl https://api.tokentosea.com/v1/images/generations \
  -H "Authorization: Bearer $TOKENTOSEA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $REQUEST_KEY" \
  -d '{
    "model": "qwen-image-2.1-pro",
    "prompt": "A red cube on a white table, soft studio light.",
    "n": 1,
    "size": "1024x1024"
  }'

图像编辑#

curl https://api.tokentosea.com/v1/images/edits \
  -H "Authorization: Bearer $TOKENTOSEA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "model": "qwen-image-2.1-pro",
    "prompt": "把桌面换成木纹,保持立方体不变。",
    "image": "https://example.com/source.png",
    "n": 1,
    "size": "1024x1024"
  }'

返回 202 时按文生图示例的方式轮询。

错误#

状态码code原因与处理
422response_mode_not_verified图像接口不支持流式,去掉 stream
422endpoint_not_verified该型号未开放所调用的接口(例如只支持文生图的型号调用了 edits)
422image_reference_required、duplicate_image_referenceMiniMax:image 为空或非字符串;同时传了 image 与 subject_reference
400main_wallet_authorization_failed请求条件(例如 prompt_extend、图层拆分)在该型号的价格表中没有对应规则
4xxprovider_http_<状态码>厂商拒绝(例如尺寸不受支持、内容审核未通过),message 为厂商描述,未扣费

下一步#

    输入关键词搜索全部文档与模型。