快速创建一个生成漫画插图接口

本教程将指导您从零开始，快速创建一个生成漫画插图的API接口。

方案概览

用户自己手动在智作工坊控制台创建对应的应用，调试需要的工作流，并且发布为一个可以调用的接口，之后使用对应的语言的 SDK 接入，并且调用获取到 ComfyUI 任务的结果。基于智作工坊的控制台和提供的各语言版本 SDK，可以快速调试自己需要的工作流，并且部署为API接口供调用。

概述

通过智作工坊平台，您可以：

• 创建和调试ComfyUI工作流

• 将工作流发布为可调用的API接口

• 使用Python SDK快速集成到您的应用中

预计完成时间： 15分钟

前提条件

在开始之前，请确保您已：

• 拥有阿里云账号

• 开通智作工坊服务

• 安装Python 3.8+

步骤1：新建工作流

1. 进入智作工坊控制台 ComfyUI 工作流管理界面。

2. 点击新建工作流

3. 填写工作流信息，以及选择需要的工作流模板，这里选择文生图模板，点击确认

4. 点击之后将会跳转到工作流编辑界面，等待页面加载完毕之后，显示如下：

步骤2：测试工作流

1. 修改节点中的正向提示词和反向提示词，点击右上角运行工作流查看效果

2. 等待工作流执行

3. 执行结束，查看结果如下图

步骤3: 发布API接口

发布工作流

1. 确认工作流可以执行得到结果后，点击发布，进入发布菜单

2. 填入版本描述：填入简单文生图测试

3. 设置工作流入参：在这里可以设置接口服务对外暴露的参数，其他未暴露的参数值默认使用工作流中的值。若调用时为传递设置的参数，也默认是工作流中的参数。

   1. 点击下方添加按钮，可以添加新的参数

   2. 添加之后确认设置好的参数，含义如下，注意 #3会显示在工作流右上角，方便对应关系

   3. 如果需要修改参数

      1. 点击字段对应的编辑，可以编辑参数别名

      2. 编辑态：

      3. 编辑好之后，回车保存

4. 设置工作流出参：在这里可以设置接口服务返回的内容。

   1. 点击下方添加按钮，可以添加新的出参

   2. 添加之后确认设置好的参数，可以看到生成对应的输出预览

5. 发布工作流：确认无误之后，点击提交发布。

6. 发布之后可以看到生成对应的接口版本管理信息

为工作流指定别名

1. 点击别名管理tab，点击新建别名按钮，填写接口调用别名名称，选择别名当前对应的主版本，后续更新接口版本只需要在此替换版本即可，无需修改代码中的版本ID。

2. 点击确认，得到如下效果：

3. 复制对应的别名备用，这里是 t2i_0821

步骤4：获取 API 凭证

1. 接口发布之后，想要调用接口，需要先新建应用，使用应用的AKSK通过SDK调用。打开智作工坊控制台应用管理tab页

2. 点击右上角创建应用

3. 填写应用名称以及应用类型，点击确认

4. 确认后会自动跳转应用详情页，复制对应的AK、SK备用

步骤5：Python SDK集成

安装SDK

# 推荐使用uv安装
uv add speedpix

# 或使用pip安装
pip install speedpix

设置环境变量

export SPEEDPIX_APP_KEY="your-app-key"
export SPEEDPIX_APP_SECRET="your-app-secret"
# 可选
export SPEEDPIX_ENDPOINT="https://openai.edu-aliyun.com"

基础调用示例

创建文件cartoon_generator.py：

from speedpix import Client
import os

def generate_cartoon(prompt, negative_prompt=""):
    """
    生成漫画插图
    
    Args:
        prompt (str): 正向提示词，描述想要生成的内容
        negative_prompt (str): 反向提示词，描述不想要的元素
    
    Returns:
        str: 生成图片的保存路径
    """
    try:
        # 初始化客户端
        client = Client()
        
        # 调用工作流
        result = client.run(
            workflow_id="your_workflow_id",  # 替换为您的工作流ID
            input={
                "prompt": prompt,
                "negative_prompt": negative_prompt
            },
            alias_id="cartoon_v1"  # 替换为您的别名
        )
        
        # 保存生成的图片
        output_path = f"cartoon_{hash(prompt) % 10000}.png"
        result['images']['url'].save(output_path)
        
        print(f"图片生成成功: {output_path}")
        return output_path
        
    except Exception as e:
        print(f"生成失败: {e}")
        return None

# 测试函数
if __name__ == "__main__":
    # 生成漫画插图
    image_path = generate_cartoon(
        prompt="孙悟空漫画登上天堂并开始在天堂肆虐，漫画风格，彩色",
        negative_prompt="模糊，低质量，黑白"
    )
    
    if image_path and os.path.exists(image_path):
        print(f"文件大小: {os.path.getsize(image_path)} bytes")

步骤6：验证和测试

运行测试

# 测试基础功能
python cartoon_generator.py

# 检查生成的文件
ls -la cartoon_*.png

查看生成效果

生成的漫画插图示例：

高级特性

错误处理最佳实践

from speedpix import Client, PredictionError, SpeedPixException
import logging

# 配置日志
logging.basicConfig(level=logging.INFO)
logger = logging.getLogger(__name__)

def robust_generate(prompt, max_retries=3):
    """带重试机制的生成函数"""
    client = Client()
    
    for attempt in range(max_retries):
        try:
            result = client.run(
                workflow_id="your_workflow_id",
                input={"prompt": prompt},
                alias_id="cartoon_v1"
            )
            
            output_path = f"cartoon_{attempt}_{hash(prompt) % 10000}.png"
            result['images']['url'].save(output_path)
            
            logger.info(f"生成成功: {output_path}")
            return output_path
            
        except PredictionError as e:
            logger.error(f"预测错误 (尝试 {attempt + 1}): {e}")
            if attempt == max_retries - 1:
                raise
                
        except SpeedPixException as e:
            logger.error(f"API错误 (尝试 {attempt + 1}): {e}")
            if e.status_code == 429:  # 限流
                time.sleep(2 ** attempt)  # 指数退避
            elif attempt == max_retries - 1:
                raise
                
        except Exception as e:
            logger.error(f"未知错误 (尝试 {attempt + 1}): {e}")
            if attempt == max_retries - 1:
                raise
    
    return None

性能优化配置

from speedpix import Client

# 高性能配置
client = Client(
    timeout=60.0,                    # 增加超时时间
    endpoint="https://your-region.com",  # 使用就近地域
)

# 使用独享资源（推荐生产环境）
result = client.run(
    workflow_id="your_workflow_id",
    input={"prompt": "高质量漫画生成"},
    resource_config_id="your-dedicated-resource-id"  # 独享资源ID
)

故障排除

常见问题

调试技巧

import logging
from speedpix import Client

# 开启详细日志
logging.basicConfig(level=logging.DEBUG)

client = Client()

# 检查连接
try:
    # 简单测试
    result = client.run(
        workflow_id="your_workflow_id",
        input={"prompt": "测试"},
        alias_id="cartoon_v1"
    )
    print("连接正常")
except Exception as e:
    print(f"连接失败: {e}")

相关资源

• Python SDK 接入指南

• 开发参考

• 智作工坊控制台