Image to Cartoon Generator — 图像到卡通生成器

Media.io 图像转卡通生成器技能概述 本技能调用 Media.io OpenAPI 使用模型代码 effects-cartoon 进行卡通转换。 API 是异步的：提交生成请求并获取 task_id。轮询任务结果端点，直到任务完成。 何时使用 用户想要将图像转换为卡通风格。 用户可以提供 Media.io 服务器可访问的图像 URL。 用户想要基于任务的生成和轮询。 何时不使用 用户仅要求本地文件上传（此 API 期望图像 URL 输入）。 用户要求非 Media.io 提供商。 用户要求实时同步图像输出一次调用。 要求 环境变量 变量 是否必需 描述 MEDIAIO_API_KEY 是 Media.io OpenAPI 密钥，在头部 X-API-KEY 中使用。 基本头部 Content-Type：application/json X-API-KEY：$MEDIAIO_API_KEY 支持端点 1) 查询信用 方法：POST 端点：https://openapi.media.io/user/credits 正文：{} 目的：在生成之前检查可用信用。 2) 创建卡通任务 方法：POST 端点：https://openapi.media.io/generation/effects/effects-cartoon 正文：{ "data"：{ "images"： "https://example.com/input.jpg"， "ratio"： "9：16"， "batch"： "1" } } 必需字段：data.images（字符串 URL） 可选字段：data.ratio（字符串）：9：16，16：9，1：1，4：3，3：4，3：2，2：3 data.batch（字符串）：1，2，3，4 3) 查询任务结果 方法：POST 端点：https://openapi.media.io/generation/result/{task_id} 正文：{} 路径参数：task_id（字符串，必需） 请求和响应合同 公共成功封装 { "code"：0， "msg"：""， "data"：{}， "trace_id"： "..." } 创建任务响应 成功时，data.task_id 返回。 任务结果响应 data.status 可以是以下值之一： waiting：排队 processing：运行中 completed：成功完成 failed：失败 timeout：超时 data.reason：提供额外的上下文（例如，成功或错误消息） 当 status 为 completed 时：data.result 是一个包含生成 URL 的输出对象数组 每个结果对象包含 val（内部路径）、preview（公共 HTTPS URL）和 status（完成状态） 标准调用流程 调用 user/credits 以验证余额。 调用 effects-cartoon 与 data.images 和可选 data.ratio、data.batch。 提取 task_id。 每 3 到 5 秒轮询 generation/result/{task_id}。 停止时 status 为 completed 或 failed。 当完成时从 data.result 返回输出 URL。 cURL 示例 查询信用 curl --request POST \ --url https://openapi.media.io/user/credits \ --header 'Content-Type：application/json' \ --header "X-API-KEY：$MEDIAIO_API_KEY" \ --data '{}' 创建卡通任务 curl --request POST \ --url https://openapi.media.io/generation/effects/effects-cartoon \ --header 'Content-Type：application/json' \ --header "X-API-KEY：$MEDIAIO_API_KEY" \ --data '{ "data"：{ "images"： "https://example.com/input.jpg"， "ratio"： "9：16"， "batch"： "1" } }' 查询任务结果 curl --request POST \ --url https://openapi.media.io/generation/result/ \ --header 'Content-Type：application/json' \ --header "X-API-KEY：$MEDIAIO_API_KEY" \ --data '{}' 成功响应示例 { "code"：0， "msg"：""， "data"：{ "task_id"： "effect-86f0f82a-36dc-4a7c-928a-721a18ef482f"， "status"： "completed"， "reason"： "success"， "result"： [ { "val"： "aicloudtmp/550160908/3/202603/1/combo_tm_alg-20260317165022-802800-60eb3-dwt.png"， "preview"： "https://url_to_generated_image.png"， "status"： "completed" } ] }， "trace_id"： "a18315ba568b5c34407808d12cbc8457" } 当 status 为 completed 时的响应字段： data.task_id：唯一任务标识符 data.status：completed 表示成功完成 data.reason：success 表示没有错误发生 data.result：输出对象数组，每个包含： val：生成资产的内部文件路径 preview：生成资产的公共 HTTPS URL status：每个结果项的 completed 错误处理指导 将 code != 0 视为失败。 典型的身份验证错误：374004：未身份验证。 在 https://developer.media.io/ 上申请 APP KEY。 典型的请求验证错误：490000：参数错误。 典型的计费/信用错误：490505：信用不足。 在调用生成 API 之前重新充值。 始终在日志中包含 trace_id 以进行故障排除。 代理行为要求 验证输入包含非空图像 URL 之前调用创建端点。 不要在任务创建后立即声明输出；始终使用 task_id 轮询。 如果信用不足，返回明确的消息并停止，而不是重试循环。 避免在日志或响应中暴露原始 API 密钥。 安全和合规注意事项 仅处理用户提供或用户授权的图像。 不要从生成的图像中推断身份验证或生物识别确定性。 生成的输出是合成媒体，应作为编辑内容呈现。 参考 Media.io 平台：https://developer.media.io/ API 文档：https://platform.media.io/