jimeng-free-api-all/docs/JIMENG-4.1-4.5.md

3.9 KiB
Raw Blame History

即梦 AI 4.1 和 4.5 模型支持

本文档介绍了 jimeng-free-api-all 项目对即梦 AI 新增的 4.1 和 4.5 模型的支持。

新增模型

jimeng-4.5

  • 内部模型名: high_aes_general_v45
  • 版本: 3.2.9
  • 特性:
    • 支持文生图Text-to-Image
    • 支持图生图Image-to-Image
    • 支持多图连续生成
    • 最高支持 2048x2048 分辨率

jimeng-4.1

  • 内部模型名: high_aes_general_v41
  • 版本: 3.2.9
  • 特性:
    • 支持文生图Text-to-Image
    • 支持图生图Image-to-Image
    • 支持多图连续生成
    • 最高支持 2048x2048 分辨率

与旧版本的差异

特性 jimeng-4.5/4.1 jimeng-4.0 jimeng-3.1
Draft版本 3.2.9 3.0.2 3.0.2
多图生成
最大分辨率 2048x2048 2048x2048 1024x1024
采样强度范围 0.1-1.0 0.1-1.0 0.1-0.8

API 使用

1. 文生图

curl -X POST http://localhost:8000/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_SESSION_ID" \
  -d '{
    "model": "jimeng-4.5",
    "prompt": "一只可爱的小猫在花园里玩耍",
    "width": 1024,
    "height": 1024,
    "sample_strength": 0.7
  }'

2. 多图连续生成

curl -X POST http://localhost:8000/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_SESSION_ID" \
  -d '{
    "model": "jimeng-4.5",
    "prompt": "生成4张连续场景的图片春夏秋冬四季风景",
    "width": 1024,
    "height": 1024,
    "sample_strength": 0.6
  }'

3. 图生图

curl -X POST http://localhost:8000/v1/images/compositions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_SESSION_ID" \
  -d '{
    "model": "jimeng-4.1",
    "prompt": "将这些图片合成为一幅美丽的风景画",
    "images": [
      "https://example.com/image1.jpg",
      "https://example.com/image2.jpg"
    ],
    "width": 2560,
    "height": 1440,
    "sample_strength": 0.6
  }'

参数说明

支持的分辨率

  • 512x512
  • 768x768
  • 1024x1024默认
  • 1280x720
  • 720x1280
  • 1536x864
  • 864x1536
  • 2048x2048仅 4.1 和 4.5

采样强度sample_strength

  • 范围0.1 - 1.0
  • 默认0.5
  • 说明:控制生成图片与提示词的契合度,值越高越贴近提示词

最佳实践

  1. 使用提示词

    • 4.5 和 4.1 版本对中文提示词支持更好
    • 建议使用详细的描述性提示词
  2. 多图生成

    • 使用 "连续"、"绘本"、"故事" 等关键词触发多图生成
    • 使用 "X张" 指定生成图片数量
  3. 分辨率选择

    • 普通场景使用 1024x1024
    • 需要高清细节时使用 2048x2048
    • 宽屏场景使用 1280x720

测试

项目提供了测试脚本 test/test-new-models.js

# 安装依赖
npm install

# 修改脚本中的 SESSION_ID
vim test/test-new-models.js

# 运行测试
npm run test:models
# 或直接运行
node test/test-new-models.js

注意事项

  1. 新模型需要更多的积分消耗
  2. 生成时间可能比旧模型稍长
  3. 建议在生产环境使用前充分测试
  4. 遵守即梦 AI 的使用条款和限制

故障排除

常见错误

  1. 参数验证失败

    • 检查分辨率是否在支持列表中
    • 检查采样强度是否在 0.1-1.0 范围内
  2. 模型不支持

    • 确保使用的是正确的模型名称jimeng-4.5 或 jimeng-4.1
    • 查看模型列表确认可用性
  3. 生成失败

    • 检查积分是否充足
    • 检查提示词是否符合内容规范
    • 查看日志获取详细错误信息

更新日志

v4.5 支持 (2024-12-07)

  • 新增 jimeng-4.5 模型支持
  • 支持最高 2048x2048 分辨率
  • 优化了提示词理解能力

v4.1 支持 (2024-12-07)

  • 新增 jimeng-4.1 模型支持
  • 改进了图像生成质量
  • 增强了多图生成功能