青云TOP API使用教程&开发文档小白用户&专业开发者快速使用指南
控制台
返回模型调用 API 参考
POST/ideogram/upscale

Upscale（放大高清）

官方文档：https://developer.ideogram.ai/api-reference/api-reference/upscale

API Key multipart/form-data
Ideogram 兼容协议

调用与返回说明

这是本站提供的 Ideogram 兼容入口，路径沿用厂商动作命名。它不是让客户端直接访问 Ideogram，也不要求提交厂商 API Key；当前可用模型和权限以本站配置为准。

请求时注意

  • 请求头使用 Authorization: Bearer YOUR_API_KEY 和页面声明的 Content-Type。路径中的厂商名称不改变青云TOP API 的鉴权方式，也不要求客户端携带厂商密钥。
  • 模型 ID、模型版本和后缀必须使用当前账号 GET /v1/models 返回且与本页协议匹配的值；旧示例中的固定型号不能视为永久可用。

返回时注意

  • 同步图片响应通常在 data、output 或等价字段中返回 URL、Base64 或图片对象；先检查 HTTP 状态和错误字段，再按返回格式保存结果。
  • URL 可能有有效期，Base64 需要按响应中的格式解码。不要把示例 URL 当作永久存储地址，也不要把 Markdown 预览当作二进制文件。
Request

请求

/ideogram/upscale

Body

必填
Bodymultipart/form-data
Bodyobject
modelstring必填

使用的模型，可选，默认为 kling-image

promptstring必填

正向提示词，必需，描述你想要生成的图像内容，不能超过500个字符

negative_promptstring必填

负向提示词，可选，描述你不想在图像中出现的元素，不能超过200个字符

imagestring必填

参考图片，可选，支持 Base64 编码或图片 URL，支持 .jpg/.jpeg/.png 格式，大小不能超过 10MB

image_fidelitynumber必填

参考图片的影响强度，可选，取值范围：0-1，值越大，生成的图像越接近参考图片

ninteger必填

生成图片的数量，可选，取值范围：1-9

aspect_ratiostring必填

生成图片的纵横比，可选，可选值：16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3

callback_urlstring必填

回调通知地址，可选，当任务状态发生变化时，系统会向这个地址发送通知

image_requeststring

"prompt": "a beautiful sunset over mountains", // 提示词用于指导放大 (可选) "resemblance": 50, // 相似度 (可选) 范围:1-100,默认50 "detail": 50, // 细节程度 (可选) 范围:1-100,默认50 "magic_prompt_option": "AUTO", // 是否使用MagicPrompt (可选) 可选值:AUTO/ON/OFF "num_images": 1, // 生成图片数量 (可选) 范围:1-8,默认1 "seed": 123456 // 随机种子 (可选) 范围:0-2147483647

示例{"resemblance":50,"magic_prompt_option":"AUTO","prompt":"A%20serene%20tropical%20beach%20","seed":12345,"detail":50}
image_filefile

图片文件 (必填) 需要放大的源图片文件

示例file://C:\Users\Administrator\Desktop\例子.png

路径、查询与 Header 参数

参数位置类型必填说明示例
AcceptHeaderstring是-application/json
AuthorizationHeaderstring是必填。使用青云TOP API 的 API Key，保留 Bearer 后的空格。Bearer YOUR_API_KEY
Content-TypeHeaderstring否-multipart/form-data
Response

返回响应 200

HTTP 响应
响应 200json
响应 200object
codeinteger必填
messagestring必填
request_idstring必填
dataobject必填
task_idstring必填
task_statusstring必填
created_atinteger必填
updated_atinteger必填
Ideogram 兼容协议

调用与返回说明

这是本站提供的 Ideogram 兼容入口，路径沿用厂商动作命名。它不是让客户端直接访问 Ideogram，也不要求提交厂商 API Key；当前可用模型和权限以本站配置为准。

请求时注意

  • 请求头使用 Authorization: Bearer YOUR_API_KEY 和页面声明的 Content-Type。路径中的厂商名称不改变青云TOP API 的鉴权方式，也不要求客户端携带厂商密钥。
  • 模型 ID、模型版本和后缀必须使用当前账号 GET /v1/models 返回且与本页协议匹配的值；旧示例中的固定型号不能视为永久可用。

返回时注意

  • 同步图片响应通常在 data、output 或等价字段中返回 URL、Base64 或图片对象；先检查 HTTP 状态和错误字段，再按返回格式保存结果。
  • URL 可能有有效期，Base64 需要按响应中的格式解码。不要把示例 URL 当作永久存储地址，也不要把 Markdown 预览当作二进制文件。