接口文档

用一个 Key 调用 AI 生图。按次扣积分，1 元 = 100 积分，失败自动退还。

获取 Key

注册后，在个人中心就能看到你的 Key（以 kuwan_ 开头），可以随时重置。调用前先充值，5 元起。

鉴权

在请求头里带上 Authorization: Bearer 你的 Key。不方便设请求头的场景，也可以把 Key 放在请求体的 key 字段里。

AI 生图

POST https://api.dc1818.cn/api/v1/image/generate · 每张 30 积分

参数	是否必填	说明
prompt	必填	想要的画面，最长 4000 字。图上要写的字直接写进去，例如「顶部写着：新品上市」
ratio	可选	画面比例：1:1、16:9、9:16、4:3、3:4、3:2、2:3，默认 1:1
image_urls	可选	参考图链接数组，最多 4 张，每张不超过 10MB。传了就是改图
asyn	可选	传 true 立刻返回 task_id，之后用查结果接口拿图；不传就等出图后直接返回（一般 20~40 秒）

curl

curl https://api.dc1818.cn/api/v1/image/generate \
  -H "Authorization: Bearer 你的 Key" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "国潮风奶茶海报，顶部写着新品上市", "ratio": "3:4"}'

Python

import requests

r = requests.post(
    "https://api.dc1818.cn/api/v1/image/generate",
    headers={"Authorization": "Bearer 你的 Key"},
    json={"prompt": "国潮风奶茶海报，顶部写着新品上市", "ratio": "3:4"},
    timeout=200,  # 同步模式一般 20~40 秒出图,超时设长一点
)
print(r.json()["data"][0]["url"])

成功返回

{
  "status": "completed",
  "task_id": "kw_123",
  "data": [{ "url": "https://kuwanai-media.oss-cn-hangzhou.aliyuncs.com/gen/....png", "type": "image" }],
  "meta": { "cost": 30, "balance_after": 970 }
}

图片链接长期有效，可以直接在程序里下载或嵌进网页显示；在浏览器地址栏里打开会直接下载，不会预览。

异步查结果

POST https://api.dc1818.cn/api/v1/image/result · 不扣积分

参数	是否必填	说明
task_id	必填	提交时返回的 task_id，例如 kw_123

返回的 status 是 processing 时，隔几秒再查；变成 completed 后，data[0].url 就是图片链接。

错误码

出错时返回 { "error": { "code": "…", "message": "…" } }。

HTTP	code	说明
401	missing_key / invalid_key	没传 Key，或 Key 不对。到个人中心复制最新的 Key
402	insufficient_balance	余额不足，先充值
400	bad_request	参数不对，比如 prompt 为空或超过 4000 字
400	prompt_rejected	提示词没通过内容审核，未扣积分
400	bad_image_url	参考图下载失败、不是图片，或超过 10MB
429	too_many_jobs	同一个账号同时最多生成 3 张，等前面的完成
502	generate_failed	生成失败，积分已自动退还，可以重试
404	task_not_found	task_id 不存在，或不属于这个 Key