# ai_python_sjb

**Repository Path**: yanxibao/ai_python_sjb

## Basic Information

- **Project Name**: ai_python_sjb
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-02
- **Last Updated**: 2026-06-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 抖音云开发 Python 后端

本目录是“我的世界杯瞬间”的 Python 后端，只部署在抖音云开发自定义服务中。生成图片固定使用豆包 Seedream，不再包含通义万相、爬虫、ScoreBat 或 FFmpeg 自动更新逻辑。

## 接口

- `GET /get_templates`：获取本地模板表 `data/templates.json`。
- `GET /health`、`GET /test`：健康检查。
- `GET/POST /version`：返回当前部署版本。
- `GET/POST /network_check`：检查 Ark/Seedream 与 TOS 关键链路。
- `GET/POST /storage_check`：检查对象存储 SDK、环境变量和签名 URL 配置。
- `GET/POST /storage_test`：真实上传一个极小测试文件到对象存储。
- `POST /upload_photo_json`：接收用户照片 base64，服务端上传到 TOS，返回 `photoUrl/photoFileId`。
- `POST /prepare_upload_json`：生成前端直传 TOS 的预签名 URL，保留备用。
- `POST /generate_json`：同步生成接口，兼容保留，不建议小程序直接使用。
- `POST /generate_start_json`：创建异步生成任务，立即返回 `jobId`。
- `POST /generate_run_json`：触发异步任务执行，快速返回。
- `POST /generate_status_json`：轮询任务状态，成功后返回生成图片。

## 启动

首次部署或本地测试前安装依赖：

```bash
pip install -r requirements.txt
```

抖音云开发 Python 模板默认读取根目录 `uwsgi.ini` 和 `wsgi.py`。如果平台必须填写启动命令，使用：

```bash
uwsgi --ini /opt/application/uwsgi.ini
```

本地调试：

```bash
python app.py
```

## 环境变量

```text
SEEDREAM_API_KEY=你的豆包/火山方舟 API Key
SEEDREAM_MODEL=doubao-seedream-5-0-260128
SEEDREAM_SIZE=
SEEDREAM_MAX_IMAGES=1
SEEDREAM_STREAM=true
SEEDREAM_WATERMARK=false
SEEDREAM_TIMEOUT=300

TOS_BUCKET_NAME=ttde3fa882405b7c2901-env-jpqp2zkzsy
TOS_PUBLIC_BASE_URL=https://ttde3fa882405b7c2901-env-jpqp2zkzsy.tos-cn-beijing.volces.com
TOS_REGION=cn-beijing
TOS_ENDPOINT=tos-cn-beijing.volces.com
TOS_ACCESS_KEY_ID=你的抖音云对象存储AccessKeyId
TOS_SECRET_ACCESS_KEY=你的抖音云对象存储SecretAccessKey
TOS_USE_SIGNED_URL=true
```

## 模板表结构

当前使用 `data/templates.json` 作为轻量模板表，字段保持简单：

```json
{
  "id": "goal_xxx",
  "title": "补时绝杀凌空抽射",
  "image": "https://example.com/template.jpg",
  "prompt": "世界杯最新进球瞬间：补时阶段凌空抽射破门"
}
```

## 对象存储

当前 TOS 配置：

```text
桶名称：ttde3fa882405b7c2901-env-jpqp2zkzsy
访问域名：https://ttde3fa882405b7c2901-env-jpqp2zkzsy.tos-cn-beijing.volces.com
```

后端会把用户上传照片保存到 `static/uploads/`，把生成结果保存到 `static/results/`。桶可以保持私有，后端默认返回带 `X-Tos-*` 参数的签名下载 URL，避免裸链 `AccessDenied`。

部署后建议先通过小程序 `callContainer` 调用 `/version`、`/storage_test`、`/network_check`。线上不要直接依赖 `service.douyincloud.run` 域名访问业务接口，小程序侧应走 `tt.createCloud(...).callContainer({ path })`。