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"}'错误码说明
| Code | HTTP | 说明 |
|---|---|---|
INVALID_REQUEST | 400 | 请求参数缺失或格式错误 |
UNAUTHORIZED | 401 | Service Key 未提供或无效 |
INSUFFICIENT_BALANCE | 402 | 余额不足,需要充值 |
NOT_FOUND | 404 | 资源不存在 |
USER_NOT_FOUND | 404 | 用户(Service Key)不存在 |
CONFIG_ERROR | 503 | 服务端配置错误 |
GENERATION_FAILED | 502 | 图片生成失败(已自动退款) |
INTERNAL_ERROR | 500 | 服务端内部错误 |
AI Agent 目录 / Catalog
图片生成 / Image Generation
V2 API(推荐)
角色场景生成 / Character Scene
提示词增强 / Prompt Enhancement
角色管理 / Characters
模板画廊 / Templates
风格画廊 / Styles
历史记录 / History
计费 / Billing
模型说明
| 模型名 | 后端 | 特点 |
|---|---|---|
seedream45 | BytePlus SeeDream 4.5 | 高质量写实风格,支持精确尺寸控制(宽高需为 64 的倍数,最低 2560×1440) |
nanobanana_pro | Gemini Image Pro | 多风格支持,使用 aspectRatio 控制比例,无精确像素约束 |