图片模型 API

本文说明如何通过开放 API 调用捷智算 图片生成 模型。调用地址统一为 https://mass.gogpu.cn。

先看这几条

  • 生成结果下载链接约 24 小时内有效，请及时保存
  • 参考图 URL 须 公网可访问
  • 具体参数以各模型分册为准；请求体 model 须与控制台接口模型名称一致

调用地址

用途方法完整地址
图片生成POSThttps://mass.gogpu.cn/v1/images/completions
查看可用模型GEThttps://mass.gogpu.cn/v1/models

鉴权：X-API-Key: sk-你的密钥 或 Authorization: Bearer sk-你的密钥。

调用方式

图片接口为 同步：一次 HTTP 请求完成后即返回结果（可能耗时十余秒，请将客户端超时调到 ≥ 60s）。

发起 POST /v1/images/completions
        ↓
平台校验密钥 / 模型 / 计费
        ↓
生成完成，返回 data.output 中的图片 URL（约 24 小时有效）

通用参数一览

顶层

字段必传类型说明
model是string控制台 接口模型名称，与 /v1/models 的 id 一致
content是array文生图至少一项 {"text":"..."}；带参考图时可含公网图片 URL
parameters否object见下表；具体模型以分册为准
conversation_id否number一般可不传

parameters（常见）

字段必传类型常见取值说明
n否int1～6生成张数
size否string以控制台该模型列出的尺寸为准（如 2048*2048）输出分辨率
negative_prompt否string≤500 字反向提示词（不希望出现的内容）
prompt_extend否booltrue / false是否自动扩写提示词
watermark否booltrue / false是否加水印
seed否int0～2147483647随机种子

成功响应形态

{
  "code": 0,
  "data": {
    "conversation_id": 199,
    "output": [
      "https://example.com/generated-xxxx.png"
    ],
    "image_count": 1,
    "request_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
  },
  "msg": "操作成功"
}
字段说明
data.output图片 URL 列表（约 24 小时内有效，请及时下载）
data.image_count生成张数
data.request_id请求追踪 ID

计费提示

图片按 张数 / 分辨率档位 等指标计费（以控制台该模型标价为准）。成功返回后产生用量；失败一般不计费（以控制台与账单为准）。详见 计费方式说明。

分模型文档

模型 ID能力文档
qwen-image-2.0文生图qwen-image-2.0

相关链接

复制 MD