API 文档

ZImageTurbo生态图生图片的默认工作流。

可用参数

查看这个工作流 →

ZImageTurbo生态文生图片的默认工作流。

可用参数

查看这个工作流 →

ZImageTurbo生态文生图片的默认工作流有ControlNet的加入。

可用参数

查看这个工作流 →

本工作流能够任意修改图片中人物的状态，动作，行为等等。也可以添加删除物品。

可用参数

查看这个工作流 →

传一张图片和一个工作流 id，返回这个工作流在这次输入图片尺寸下大概要跑多久、以及这次生成要花多少幻晶（不会真正提交生成任务，纯预估，不扣任何幻晶）。预估基于该工作流历史上真实完成的生成记录校准出来，第一次使用某个工作流、还没有历史数据时无法给出精确预估。

预估假设走的是常驻服务器这条路径；实际提交生成任务时如果常驻服务器繁忙会自动溢出到 Serverless，届时可能因为冷启动而更慢——这个接口给出的是正常情况下的参考值，不是精确保证。

price 里的币数与「提交生成任务」真正扣的是同一套计价，可以先查价再决定要不要提交。price.priceable 是 false 时，这个工作流暂时无法定价，提交生成任务会返回 422。

API 调用只能用付费币（紫幻晶），免费币在这条路径上不可用——所以 price.currency 恒为 paid。

需要的权限

密钥必须具备 generate（提交生成任务）权限，否则返回 403。

请求体

示例请求

curl -X POST "https://aihuanjie.com/api/v1/estimates" \
  -H "Authorization: Bearer {你的密钥}" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "workflow_id": 12,
    "image": "iVBORw0KGgoAAAANSUhEUgAA...（省略，实际请求里放完整 base64）"
}'

示例响应（200）

{
    "data": {
        "workflow_id": 12,
        "image": {
            "width": 1024,
            "height": 1024,
            "megapixels": 1.048599999999999976552089719916693866252899169921875
        },
        "estimate": {
            "precision": "parametric",
            "estimated_seconds": 42.2999999999999971578290569595992565155029296875,
            "sample_size": 18,
            "expected_megapixels": 1.048599999999999976552089719916693866252899169921875,
            "megapixels_source": "submitted_image"
        },
        "price": {
            "priceable": true,
            "currency": "paid",
            "coins": 43,
            "by_batch_size": {
                "1": 43,
                "2": 82,
                "4": 155
            }
        }
    }
}

字段说明

错误响应

提交一次真正的生成任务。传工作流 id，以及这个工作流开放的具名参数值——每个工作流开放哪些参数、参数类型是什么、是否必填，见下方「可用工作流」列表；没传的选填参数会使用默认值，必填参数缺失会返回 422。

这个接口只负责提交任务，不会等待生成完成——用返回的 job_id 调用下面的「查询生成任务」接口自行轮询。

这个接口会**真正扣费**：按下方「可用工作流」列表里那个工作流的价格扣**付费币（紫幻晶）**，免费币在 API 上不可用。余额不够时返回 402，不会欠费。想先知道要花多少，用上面的「预估生成耗时」接口查 price。

生成失败或超时会**全额退回**，成功才真正结算——扣费在提交那一刻先冻结，任务到终态时才落账。

同一个账号在站内和 API 上共用同一份并发额度（普通用户 1 个、会员 4 个）；额度占满时返回 429，等在跑的任务结束再提交。

提示词与图片参数都会先过内容审核，未通过时返回 422 且**不扣任何幻晶**。

出几张由 parameters 里那个张数参数决定（没传就是 1 张），账单严格按这个数字算；传一个不在允许档位里的数字会返回 422。

如果你在设置页给这把密钥设了「消费限额」，超出限额时返回 429（不是 402）——限额是按「最近 N 个整点小时」滑动计算的，统计的是提交时冻结的币数，生成失败退回的部分不回冲。

价钱只看工作流与张数，**不按参数动态计价**；作为对价，参数里的数值会被夹在这个工作流每个参数各自的取值范围内（下方「可用工作流」列表里标着的最小值/最大值），超出范围不报错，按边界值执行，字符串超长会被截断。

这个接口没有单独的 image 字段——图片和文字/数字/开关这些参数走同一个入口：都放在 parameters 对象里，key 用这个工作流给这个参数起的名字（在下方「可用工作流」列表里能查到，类型标"图片"的那一行）。同一个工作流可能有 0 个、1 个、甚至多个图片参数，具体看它开放了哪些。

需要的权限

密钥必须具备 generate（提交生成任务）权限，否则返回 403。

请求体

示例请求

curl -X POST "https://aihuanjie.com/api/v1/generations" \
  -H "Authorization: Bearer {你的密钥}" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "workflow_id": 12,
    "parameters": {
        "prompt_text": "a cat, masterpiece",
        "seed": 12345,
        "source_image": "iVBORw0KGgoAAAANSUhEUgAA...（省略，实际请求里放完整 base64，仅当工作流定义了图片类型参数时才需要传）"
    }
}'

示例响应（200）

{
    "data": {
        "job_id": 88,
        "status": "pending",
        "execution_path": "persistent",
        "charged_coins": 43
    }
}

字段说明

错误响应

查询一次生成任务的当前状态和结果图。只能查通过你自己这个账号（不区分具体是哪一把密钥）提交过的任务，查别人的任务 id 会返回 404。

目前只能轮询，没有 webhook 回调机制——建议每隔几秒查一次，直到 status 变成 completed 或 failed。

需要的权限

密钥必须具备 generate（提交生成任务）权限，否则返回 403。

示例请求

curl -X GET "https://aihuanjie.com/api/v1/generations/{job_id}" \
  -H "Authorization: Bearer {你的密钥}" \
  -H "Accept: application/json"

示例响应（200）

{
    "data": {
        "job_id": 88,
        "status": "completed",
        "execution_path": "persistent",
        "progress_percent": 100,
        "progress_message": null,
        "error_message": null,
        "charged_coins": 43,
        "outputs": [
            {
                "id": 201,
                "url": "https://cdn.example.com/civitai/generations/88/0.png",
                "title": null,
                "width": 1024,
                "height": 1024
            }
        ]
    }
}

字段说明

错误响应