生图per_task

图片放大 · 可调倍数

image-upscale-by

RunningHub 图片放大工作流，支持 2×、3×、4× 放大，按次计费。。通过小乖 API 以统一的 Bearer Key 异步调用，支持参数化尺寸与可选参考图（视模型而定）。按人民币余额扣费，失败自动退款。模型 ID：image-upscale-by。

API 文档 →获取 API Key 全部定价

售价 // PRICE

¥0.10/次

按画幅、分辨率和质量的组合实时计价；在线工作台会在提交前给出准确金额。

▸ 异步任务

▸ 失败自动退款

▸ 参考图可选

▸ 人民币按次计价

▸ 统一 API Key

▸ 多模型一套接口

ONLINE PLAYGROUND

登录后可直接生成，费用从账户余额扣除。

登录并试用

参数说明 // PARAMETERS

必填：model。标记为必填的素材字段也必须提供；提交时未知字段会被拒绝。

参数	说明	取值
image	image 见 API 文档。	image URL
scale_by	scale_by 见 API 文档。	可选：2 / 3 / 4

快速接入 // QUICKSTART

cURL

curl -X POST https://xiaoguai123.xyz/api/v1/images/generations \
  -H "Authorization: Bearer sk-你的Key" \
  -H "Content-Type: application/json" \
  -d '{ "model": "image-upscale-by", "image": "https://example.com/input.png"}'

# → { "code":200, "data":[{ "status":"submitted", "task_id":"xg_..." }] }
# 再轮询 GET https://xiaoguai123.xyz/api/v1/tasks/{task_id}

Python

import requests, time

BASE = "https://xiaoguai123.xyz"
KEY = "sk-你的Key"
H = {"Authorization": f"Bearer {KEY}"}
payload = {
  "model": "image-upscale-by",
  "image": "https://example.com/input.png"
}

r = requests.post(f"{BASE}/api/v1/images/generations", headers={**H, "Content-Type": "application/json"}, json=payload)
r.raise_for_status()
task_id = r.json()["data"][0]["task_id"]
print("task:", task_id)

while True:
    t = requests.get(f"{BASE}/api/v1/tasks/{task_id}", headers=H).json()["data"]
    print(t["status"], t.get("progress"))
    if t["status"] in ("completed", "failed"):
        print(t)
        break
    time.sleep(3)

适用场景 // USE CASES

电商与主图

批量出产品图、场景图，统一风格与尺寸。

UI / 原型

快速生成界面示意、海报与运营物料。

广告创意

多提示词并行试创意，按次计费不浪费。

内容本地化

多语言文字渲染场景（视模型能力）快速适配市场。

常见问题 // FAQ

Q. 如何调用图片放大 · 可调倍数？

在控制台创建 API Key，向 POST /api/v1/images/generations 提交，model 填 `image-upscale-by`，再轮询 GET /api/v1/tasks/{task_id} 获取结果。

Q. 怎么计费？失败会扣钱吗？

本模型按任务计费。提交时先冻结金额，成功结算；失败或超时会自动解冻退回，不会吞余额。

Q. 和官方 API 有什么区别？

你使用小乖签发的 Key，人民币余额按任务扣费；上游 Key 由平台持有。接口形态对齐常见异步生图/生视频流程，方便接入。

Q. 支持参考图吗？

若参数表含 image_urls，即可传入参考图 URL 或 Data URI（上限见参数说明）。