DreamWeaver

AI Portrait Studio

Get your Service Key
Create作品集模板画廊风格画廊角色仓库

Docs

API Manual

Community

Discord

Appearance

DreamWeaver

AI Portrait Studio

API Manual

DreamWeaver API 接口文档与使用说明

目录

快速开始

Base URL: https://your-domain.com

认证方式: 大部分接口通过 TUQU Service Key 认证,传递方式为请求头 x-api-key 或 Authorization: Bearer <key>,或在请求体中传递 userKey

响应格式: 所有接口返回 JSON,标准成功响应包含 { "success": true, "data": ... }

错误格式: { "success": false, "error": { "code": "...", "message": "..." } }

示例请求

bash
curl -X POST https://your-domain.com/api/billing/balance \
  -H "Content-Type: application/json" \
  -d '{"userKey": "your-tuqu-service-key"}'

错误码说明

CodeHTTP说明
INVALID_REQUEST400请求参数缺失或格式错误
UNAUTHORIZED401Service Key 未提供或无效
INSUFFICIENT_BALANCE402余额不足,需要充值
NOT_FOUND404资源不存在
USER_NOT_FOUND404用户(Service Key)不存在
CONFIG_ERROR503服务端配置错误
GENERATION_FAILED502图片生成失败(已自动退款)
INTERNAL_ERROR500服务端内部错误

AI Agent 目录 / Catalog

图片生成 / Image Generation

V2 API(推荐)

角色场景生成 / Character Scene

提示词增强 / Prompt Enhancement

角色管理 / Characters

模板画廊 / Templates

风格画廊 / Styles

历史记录 / History

计费 / Billing

模型说明

模型名后端特点
seedream45BytePlus SeeDream 4.5高质量写实风格,支持精确尺寸控制(宽高需为 64 的倍数,最低 2560×1440)
nanobanana_proGemini Image Pro多风格支持,使用 aspectRatio 控制比例,无精确像素约束