前言随着 AI 生成式媒体的普及越来越多的开发者希望将图像生成、视频生成能力集成到自己的应用或工作流中。Duct Tape AI 提供了简洁的 REST API支持文本/图像到图像、文本/图像到视频等多种生成模型对接成本极低本文将从技术角度带你完整走一遍接入流程。一、获取 API Key前往 Duct Tape AI 官网注册并登录账户在账户设置页面即可创建和管理 API Key。Key 格式如下sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx二、认证方式所有请求均需在 HTTP Header 中携带 API KeyAuthorization: Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx三、支持的模型model_id功能描述输出字段gpt-image-2GPT Image 2文本/图像 → 图像image_urlnanobanana-2Nano Banana 2文本/图像 → 图像image_urlseedance-2Seedance 2.0文本/图像 → 视频video_url四、创建生成任务接口POST https://ducttapeai.art/api/v1/tasks/create请求体示例{ model_id: gpt-image-2, prompt: a serene zen garden at sunrise, ultra detailed, input_data: { aspect_ratio: 16:9, resolution: 2k } }cURL 示例curl -X POST https://ducttapeai.art/api/v1/tasks/create -H Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx -H Content-Type: application/json -d { model_id: gpt-image-2, prompt: a serene zen garden at sunrise, input_data: { aspect_ratio: 16:9, resolution: 2k } }响应示例{ code: 200, msg: success, data: { task_id: task_abc123def456ghij, model_id: gpt-image-2, task_type: gpt_image_2, credits: 25, base_credits: 25, multiplier: 1 } }注意credits 仅在上游服务商接受任务后才会扣除生成失败不计费。五、查询任务状态与结果生成任务是异步的需要通过 task_id 轮询状态。接口GET https://ducttapeai.art/api/v1/tasks/{task_id}cURL 示例curl https://ducttapeai.art/api/v1/tasks/task_abc123def456ghij -H Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx响应示例{ code: 200, msg: success, data: { task_id: task_abc123def456ghij, task_status: 3, task_type: gpt_image_2, model_id: gpt-image-2, image_url: https://your-cdn.com/..., video_url: null, audio_url: null, credits: 25, created_at: 1730000000 } }task_status 状态码值含义1等待中2执行中3成功4失败建议每3~6 秒轮询一次直到状态变为 3成功或 4失败。六、Python 完整示例import requests import time API_KEY sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx BASE_URL https://ducttapeai.art/api/v1 HEADERS { Authorization: fBearer {API_KEY}, Content-Type: application/json } def create_task(model_id, prompt, input_dataNone): payload {model_id: model_id, prompt: prompt} if input_data: payload[input_data] input_data resp requests.post(f{BASE_URL}/tasks/create, jsonpayload, headersHEADERS) data resp.json() if data[code] 200: return data[data][task_id] raise Exception(f创建失败: {data[msg]}) def poll_task(task_id, interval4, timeout120): start time.time() while time.time() - start timeout: resp requests.get(f{BASE_URL}/tasks/{task_id}, headersHEADERS) result resp.json()[data] status result[task_status] if status 3: return result if status 4: raise Exception(生成失败) time.sleep(interval) raise TimeoutError(轮询超时) task_id create_task( model_idgpt-image-2, prompta serene zen garden at sunrise, ultra detailed, input_data{aspect_ratio: 16:9, resolution: 2k} ) print(f任务已提交: {task_id}) result poll_task(task_id) print(f图像地址: {result[image_url]})七、错误处理错误说明code: 200成功数据在 data 字段code: 0业务级失败查看 msg 字段HTTP 401API Key 缺失或无效insufficient credits余额不足需充值总结Duct Tape AI 的 API 设计简洁异步任务模型清晰接入成本低。支持图像和视频两类生成能力计费按任务按需扣除非常适合在自动化流程、内容生成工具或 SaaS 产品中集成。前往 Duct Tape AI 官网登录账户即可获取 API Key开始接入。