Skip to content

API_CONFIG.md

Latest commit

 

History

History
136 lines (98 loc) · 3.12 KB

API_CONFIG.md

File metadata and controls

136 lines (98 loc) · 3.12 KB
Raw

API 配置说明

当前配置状态

你的项目已经成功配置了自定义API。配置信息存储在 .env 文件中。

配置详情

配置项 值 说明
API提供商 自定义 (N) 使用自定义API提供商
基础URL https://muyuan.do/v1 API服务器地址
模型 gpt-5.5 使用的AI模型
API类型 responses 接口格式（非标准OpenAI格式）
API Key sk-jhfzgM53... 已配置（已隐藏完整密钥）

.env 文件内容

OPENAI_BASE_URL=https://muyuan.do/v1
OPENAI_API_KEY=sk-jhfzgM53NAif71Q1DjGhwmgR8QgFQhEHBVfYf8X5GohaBmEd
OPENAI_MODEL=gpt-5.5
OPENAI_WIRE_API=responses

API类型说明

chat_completions (标准模式)

  • 标准OpenAI兼容接口
  • 请求端点: /v1/chat/completions
  • 适用于大多数OpenAI兼容服务

responses (当前使用)

  • 自定义响应格式
  • 请求端点: /v1/responses
  • 使用不同的请求/响应结构

如何使用

启动服务器

python server.py

服务器默认运行在: http://127.0.0.1:8765

测试API配置

# 测试环境变量加载
python -c "from server import load_env_file; import os; load_env_file(); print('配置已加载:', os.getenv('OPENAI_MODEL'))"

在代码中使用

from copy_agent import api_config_from_payload, generate_copy, options_from_payload

# 从环境变量自动加载配置
api_config = api_config_from_payload({})

# 生成文案
result = generate_copy(
    source_text="你的原始文本",
    options=options_from_payload({}),
    api_config=api_config,
    use_ai=True
)

安全提示

⚠️ 重要: .env 文件包含敏感的API密钥，已被添加到 .gitignore 中。

  • ✅ 不要将 .env 提交到版本控制
  • ✅ 不要在公共场合分享API密钥
  • ✅ 使用 .env.example 作为配置模板
  • ✅ 定期轮换API密钥

切换到其他API提供商

切换到标准OpenAI

OPENAI_BASE_URL=https://api.openai.com/v1
OPENAI_API_KEY=sk-your-openai-key
OPENAI_MODEL=gpt-4.1-mini
OPENAI_WIRE_API=chat_completions

切换到其他兼容服务

OPENAI_BASE_URL=https://your-service.com/v1
OPENAI_API_KEY=your-api-key
OPENAI_MODEL=your-model-name
OPENAI_WIRE_API=chat_completions

故障排查

API调用失败

  1. 检查网络连接: 确保能访问 https://muyuan.do
  2. 验证API密钥: 确认密钥仍然有效
  3. 查看错误信息: 服务器会返回详细错误提示

环境变量未加载

# 确认.env文件存在
ls -la .env

# 手动测试加载
python -c "from server import load_env_file; load_env_file(); import os; print(os.getenv('OPENAI_MODEL'))"

模型支持的功能

当前配置的 gpt-5.5 模型支持：

  • ✅ 多段文案生成
  • ✅ 时间码自动计算
  • ✅ 豆包提示词生成
  • ✅ 画面和镜头建议
  • ✅ 环境和衔接描述
  • ✅ JSON结构化输出

相关文件

  • .env - 实际配置（不提交到Git）
  • .env.example - 配置模板
  • copy_agent.py - 核心文案生成逻辑
  • server.py - HTTP服务器
  • README.md - 项目使用说明