图片上传

Upload Image Skill

上传本地图片到云存储，获取公开访问的 URL 链接。

使用场景

当用户需要：

• 将本地图片转换为 URL 链接
• 上传图片供 AI 模型使用（如图生视频、图像编辑等）
• 转存网络图片到自有存储

使用方法

方式 1：Base64 图片上传

适用于本地图片文件，需要先将图片转换为 Base64 编码。

import base64

# 读取本地图片
with open("path/to/image.jpg", "rb") as f:
    image_data = base64.b64encode(f.read()).decode()

# 调用 MCP 工具
result = upload_image(
    image_data=image_data,
    content_type="image/jpeg"  # 可选，会自动检测
)

方式 2：URL 转存

适用于将网络图片转存到自有云存储。

result = upload_image(
    image_url="https://example.com/image.jpg"
)

MCP 工具参数

返回数据

{
    "success": true,
    "url": "https://cdn-video.51sux.com/mcp-uploads/20260129/xxx.jpg",
    "object_key": "mcp-uploads/20260129/xxx.jpg",
    "bucket_name": "fal-task",
    "content_type": "image/jpeg",
    "size_bytes": 123456,
    "upload_method": "base64",
    "upload_time": "2026-01-29 10:30:00"
}

支持的图片格式

• JPEG / JPG
• PNG
• GIF
• WebP
• BMP
• SVG

存储信息

• 存储桶: fal-task
• 区域: 广州 (cn-guangzhou)
• CDN 域名: https://cdn-video.51sux.com
• 文件路径格式: {folder}/{YYYYMMDD}/{uuid}.{ext}

与其他 Skill 配合使用

示例：上传本地图片后生成视频

# 1. 上传本地图片
upload_result = upload_image(image_data=base64_data)
image_url = upload_result["url"]

# 2. 使用 Sora 2 生成视频
submit_task(
    model_id="sora-2",
    parameters={
        "image_url": image_url,
        "prompt": "让画面动起来..."
    }
)

示例：转存网络图片后进行编辑

# 1. 转存图片（避免原链接失效）
upload_result = upload_image(image_url="https://example.com/photo.jpg")
stable_url = upload_result["url"]

# 2. 使用 Flux 2 Flash 编辑图片
submit_task(
    model_id="flux-2-flash",
    parameters={
        "prompt": "add a sunset background",
        "image_urls": [stable_url]
    }
)

注意事项

1. 免费使用: 此工具不收取费用
2. 文件大小: 建议单个图片不超过 10MB
3. 自动检测: 不提供 content_type 时，会根据文件头自动检测格式
4. CDN 加速: 返回的 URL 使用 CDN 加速访问

常见问题

Q: Base64 数据是否需要去掉前缀？

A: 不需要，工具会自动处理 data:image/xxx;base64, 前缀。

Q: 上传的文件会保留多久？

A: 文件长期保存，不会自动删除。

Q: 可以上传视频吗？

A: 目前只支持图片格式，视频请使用其他工具。